claude-notification-plugin 1.1.38 → 1.1.39

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-notification-plugin",
-  "version": "1.1.38",
+  "version": "1.1.39",
   "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "author": {
     "name": "Viacheslav Makarov",

package/README.md

@@ -248,6 +248,7 @@ All commands start with `/` and execute instantly (not queued).
 | `/worktrees /project`         | List worktrees                       |
 | `/worktree /project/branch`   | Create a worktree                    |
 | `/rmworktree /project/branch` | Remove a worktree                    |
+| `/pty [/project[/branch]]`    | PTY session diagnostics (state, buffer, output) |
 | `/history`                    | Recent task history                  |
 | `/stop`                       | Stop the listener                    |
 | `/help`                       | Show help                            |
@@ -269,6 +270,7 @@ All commands start with `/` and execute instantly (not queued).
 | `liveConsole`        | `true`                | Stream PTY output to the "Running..." Telegram message in real-time                    |
 | `liveConsoleInterval`| `5`                   | Live console update interval in seconds                                                |
 
+
 ### Projects and worktrees
 
 **The queue is tied to the working directory, not the project name:**

package/commit-sha

@@ -1 +1 @@
-0fdb0002b24921b5b1c581fcd13720f2bd1247e0
+99358845aa9de2dfad99bbc5091580dcc91df4ed

package/listener/LISTENER-DETAILED.md

@@ -20,6 +20,7 @@ and executes them on your machine via an interactive Claude Code PTY session. Th
 - [Projects and worktrees](#projects-and-worktrees)
 - [Task queues](#task-queues)
 - [Bot commands](#bot-commands)
+- [Live console and PTY diagnostics](#live-console-and-pty-diagnostics)
 - [Task lifecycle](#task-lifecycle)
 - [State files](#state-files)
 - [Security](#security)
@@ -722,12 +723,75 @@ Bot: 👋 Listener is shutting down...
 
 All active tasks will be terminated. Queues are saved to disk and will be restored on the next startup.
 
+### /pty — PTY diagnostics
+
+Shows real-time information about PTY sessions: state, buffer size, live console status, and the last 15 lines of cleaned output.
+
+```
+You: /pty
+Bot: 🖥 PTY Sessions:
+
+     /api
+     State: busy
+     Buffer: 12480 bytes
+     Elapsed: 2m 35s
+     Live console: ✅
+     PTY log: writing
+
+     ◐ Reading src/auth.js
+     ● Editing src/middleware.js
+       Added JWT validation...
+```
+
+```
+You: /pty /api
+Bot: (same, but for a specific project)
+```
+
 ### /help — help
 
 Shows a brief reference for all commands.
 
 ---
 
+## Live console and PTY diagnostics
+
+### Live console
+
+When **`liveConsole`** is enabled (default: `true`), the "⏳ Running..." message in Telegram is periodically updated with the cleaned tail of Claude Code's PTY output, so you can see what Claude is doing in real-time.
+
+The output is cleaned from ANSI escape codes and Claude Code UI chrome (logo, status bar, prompts), leaving only meaningful content.
+
+Configuration:
+- `liveConsole` — enable/disable (default: `true`)
+- `liveConsoleInterval` — update interval in seconds (default: `5`)
+
+### PTY logs
+
+Each running task writes raw PTY output to a file: `{taskLogDir}/{project}_{branch}_pty.log`.
+The file is overwritten when a new task starts for the same project/branch.
+
+Monitor in real-time:
+```bash
+# Linux / macOS / Git Bash
+tail -f ~/.claude/myproject_main_pty.log
+
+# Windows PowerShell
+Get-Content ~/.claude/myproject_main_pty.log -Wait -Tail 50
+```
+
+### /pty command
+
+Send `/pty` or `/pty /project` in Telegram to get instant diagnostics:
+- Session state (`busy` / `idle` / `starting`)
+- Buffer size in bytes
+- Elapsed time since task start
+- Whether live console interval is active
+- Whether PTY log stream is writing
+- Last 15 lines of cleaned output
+
+---
+
 ## Task lifecycle
 
 ### Path of a task from message to result

package/listener/listener.js

@@ -6,7 +6,7 @@ import path from 'path';
 import process from 'process';
 import { createLogger } from './logger.js';
 import { createTaskLogger } from './task-logger.js';
-import { TelegramPoller, escapeHtml, stripAnsi } from './telegram-poller.js';
+import { TelegramPoller, escapeHtml, cleanPtyOutput } from './telegram-poller.js';
 import { WorkQueue } from './work-queue.js';
 import { PtyRunner } from './pty-runner.js';
 import { WorktreeManager } from './worktree-manager.js';
@@ -100,7 +100,7 @@ const taskLogDir = config.listener?.taskLogDir || listenerLogDir;
 fs.mkdirSync(taskLogDir, { recursive: true });
 const taskLogger = createTaskLogger(taskLogDir);
 
-const runner = new PtyRunner(logger, taskTimeout, taskLogger);
+const runner = new PtyRunner(logger, taskTimeout, taskLogger, taskLogDir);
 
 const worktreeManager = new WorktreeManager(config, logger);
 
@@ -300,11 +300,7 @@ function startLiveConsole (workDir, messageId, header) {
       if (!raw) {
         return;
       }
-      const cleaned = stripAnsi(raw)
-        .split('\n')
-        .map((l) => l.trimEnd())
-        .filter((l) => l.length > 0)
-        .join('\n');
+      const cleaned = cleanPtyOutput(raw);
       if (!cleaned) {
         return;
       }
@@ -320,10 +316,11 @@ function startLiveConsole (workDir, messageId, header) {
         return;
       }
       lastSentText = output;
-      const text = `${header}\n\n<pre>${escapeHtml(output)}</pre>`;
+      const elapsed = formatDuration(Date.now() - new Date(runner.getActive(workDir)?.startedAt || Date.now()).getTime());
+      const text = `${header}\n<i>${elapsed}</i>\n\n<pre>${escapeHtml(output)}</pre>`;
       await poller.editMessage(messageId, text);
-    } catch {
-      // ignore edit errors — message may have been deleted
+    } catch (err) {
+      logger.warn(`Live console edit error: ${err.message}`);
     }
   }, liveConsoleInterval);
   liveConsoleTimers.set(workDir, timer);
@@ -415,6 +412,8 @@ async function handleCommand (cmd, args) {
       return handleRemoveWorktree(args);
     case '/history':
       return handleHistory();
+    case '/pty':
+      return handlePty(args);
     case '/stop':
       return handleStop();
     case '/help':
@@ -691,6 +690,63 @@ function handleRemoveWorktree (args) {
   }
 }
 
+function handlePty (args) {
+  const target = parseTarget(args);
+
+  if (target) {
+    let workDir;
+    try {
+      workDir = worktreeManager.resolveWorkDir(target.project, target.branch);
+    } catch (err) {
+      return `❌ ${escapeHtml(err.message)}`;
+    }
+    const info = runner.getSessionInfo(workDir);
+    if (!info) {
+      return `🖥 No PTY session for /${escapeHtml(target.project)}${target.branch ? '/' + escapeHtml(target.branch) : ''}`;
+    }
+    return formatPtyInfo(target.project, target.branch, workDir, info);
+  }
+
+  // All sessions
+  const allInfo = runner.getAllSessionInfo();
+  if (Object.keys(allInfo).length === 0) {
+    return '🖥 No active PTY sessions';
+  }
+
+  let text = '🖥 <b>PTY Sessions:</b>\n';
+  for (const [workDir, info] of Object.entries(allInfo)) {
+    const entry = queue.queues[workDir];
+    const project = entry?.project || '?';
+    const branch = entry?.branch || null;
+    text += '\n' + formatPtyInfo(project, branch, workDir, info);
+  }
+  return text;
+}
+
+function formatPtyInfo (project, branch, workDir, info) {
+  const label = branch && branch !== 'main' && branch !== 'master'
+    ? `/${project}/${branch}`
+    : `/${project}`;
+  const elapsed = info.startedAt
+    ? formatDuration(Date.now() - new Date(info.startedAt).getTime())
+    : '-';
+  const liveTimer = liveConsoleTimers.has(workDir) ? '✅' : '❌';
+  const raw = runner.getBuffer(workDir);
+  const cleaned = raw ? cleanPtyOutput(raw) : '';
+  const lastLines = cleaned
+    ? cleaned.split('\n').slice(-15).join('\n')
+    : '(empty)';
+
+  return `<b>${escapeHtml(label)}</b>
+State: <code>${info.state}</code>
+Buffer: <code>${info.bufferSize}</code> bytes
+Elapsed: ${elapsed}
+Live console: ${liveTimer}
+PTY log: <code>${info.hasLogStream ? 'writing' : 'off'}</code>
+
+<pre>${escapeHtml(lastLines)}</pre>`;
+}
+
 function handleHistory () {
   const history = queue.getHistory(10);
   if (history.length === 0) {
@@ -729,6 +785,7 @@ function handleHelp () {
 /worktrees /project — project worktrees
 /worktree /project/branch — create worktree
 /rmworktree /project/branch — remove worktree
+/pty [/project[/branch]] — PTY session diagnostics
 /history — task history
 /stop — stop listener
 /help — this help

package/listener/pty-runner.js

@@ -13,12 +13,13 @@ const DEFAULT_TIMEOUT = 600_000; // 10 minutes
  * receives completion signals via marker files written by the notifier hook.
  */
 export class PtyRunner extends EventEmitter {
-  constructor (logger, timeout, taskLogger) {
+  constructor (logger, timeout, taskLogger, ptyLogDir) {
     super();
     this.logger = logger;
     this.timeout = timeout || DEFAULT_TIMEOUT;
     this.taskLogger = taskLogger || null;
-    // workDir -> { pty, state, currentTask, sessionId, workDir, _pendingId, _buffer }
+    this.ptyLogDir = ptyLogDir || null;
+    // workDir -> { pty, state, currentTask, sessionId, workDir, _pendingId, _buffer, _logStream }
     this.sessions = new Map();
     this.pendingMarkers = new Map(); // pendingId -> resolve callback
     this._pty = null; // lazy-loaded node-pty module
@@ -196,6 +197,27 @@ export class PtyRunner extends EventEmitter {
     });
   }
 
+  _openPtyLog (session, task) {
+    if (session._logStream) {
+      session._logStream.end();
+      session._logStream = null;
+    }
+    if (!this.ptyLogDir) {
+      return;
+    }
+    try {
+      const project = task.project || 'unknown';
+      const branch = (task.branch || 'main').replace(/[/\\:*?"<>|]/g, '_');
+      const logFile = path.join(this.ptyLogDir, `${project}_${branch}_pty.log`);
+      session._logStream = fs.createWriteStream(logFile, { flags: 'w' });
+      session._logStream.on('error', () => {
+        session._logStream = null;
+      });
+    } catch {
+      // ignore — logging is best-effort
+    }
+  }
+
   /**
    * Send a task to an existing PTY session and wait for completion.
    */
@@ -205,6 +227,8 @@ export class PtyRunner extends EventEmitter {
     session.state = 'busy';
     session.currentTask = task;
     session._pendingId = pendingId;
+    session._buffer = '';
+    this._openPtyLog(session, task);
 
     // Set up marker wait + timeout
     const markerPromise = this._waitForMarker(pendingId, this.timeout);
@@ -304,6 +328,9 @@ export class PtyRunner extends EventEmitter {
       if (session._buffer.length > 50000) {
         session._buffer = session._buffer.slice(-25000);
       }
+      if (session._logStream) {
+        session._logStream.write(data);
+      }
     });
 
     ptyProcess.onExit(({ exitCode }) => {
@@ -382,6 +409,11 @@ export class PtyRunner extends EventEmitter {
       this.pendingMarkers.delete(session._pendingId);
     }
 
+    if (session._logStream) {
+      session._logStream.end();
+      session._logStream = null;
+    }
+
     try {
       if (session.pty) {
         session.pty.kill();
@@ -440,6 +472,42 @@ export class PtyRunner extends EventEmitter {
     return session?._buffer || '';
   }
 
+  /**
+   * Get diagnostic info about a PTY session.
+   */
+  getSessionInfo (workDir) {
+    const session = this.sessions.get(workDir);
+    if (!session) {
+      return null;
+    }
+    return {
+      state: session.state,
+      bufferSize: session._buffer?.length || 0,
+      hasLogStream: !!session._logStream,
+      taskText: session.currentTask?.text || null,
+      startedAt: session.currentTask?.startedAt || null,
+      sessionId: session.sessionId || null,
+      pendingId: session._pendingId || null,
+    };
+  }
+
+  /**
+   * Get diagnostic info for all sessions.
+   */
+  getAllSessionInfo () {
+    const result = {};
+    for (const [workDir, session] of this.sessions) {
+      result[workDir] = {
+        state: session.state,
+        bufferSize: session._buffer?.length || 0,
+        hasLogStream: !!session._logStream,
+        taskText: session.currentTask?.text || null,
+        startedAt: session.currentTask?.startedAt || null,
+      };
+    }
+    return result;
+  }
+
   /**
    * Cancel all active tasks (for graceful shutdown).
    */

package/listener/telegram-poller.js

@@ -237,14 +237,14 @@ function splitMessage (text) {
   return chunks;
 }
 
-// Strip ANSI escape codes and common terminal control sequences from PTY output
+// Strip ANSI escape codes and terminal control sequences from PTY output
 function stripAnsi (text) {
   return text
-    // ANSI escape sequences (colors, cursor, etc.)
-    .replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '')
-    // OSC sequences (title setting, hyperlinks, etc.)
-    .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
-    // Other escape sequences
+    // CSI sequences: \x1b[ followed by optional ?/>/! prefix, params, and terminator
+    .replace(/\x1b\[[?>=!]?[0-9;]*[a-zA-Z~]/g, '')
+    // OSC sequences: \x1b] ... (terminated by BEL or ST)
+    .replace(/\x1b][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
+    // Other two-char escape sequences (\x1b followed by any single char)
     .replace(/\x1b[^[\]]/g, '')
     // Carriage returns (overwrite lines)
     .replace(/\r/g, '')
@@ -252,4 +252,59 @@ function stripAnsi (text) {
     .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, '');
 }
 
-export { escapeHtml, stripAnsi };
+// Clean PTY output for display: strip ANSI + remove Claude Code UI chrome
+function cleanPtyOutput (raw) {
+  const stripped = stripAnsi(raw);
+  const lines = stripped.split('\n');
+  const cleaned = [];
+  for (const line of lines) {
+    const trimmed = line.trimEnd();
+    // Skip empty lines
+    if (!trimmed) {
+      continue;
+    }
+    // Skip Claude Code UI: logo, banner, horizontal rules, prompts, status
+    if (/^[▐▝▘▛▜█▌▀▄░▒▓\s]+$/.test(trimmed)) {
+      continue;
+    }
+    if (/^[─━═╌┄]+$/.test(trimmed)) {
+      continue;
+    }
+    if (/^❯\s/.test(trimmed)) {
+      continue;
+    }
+    if (/^[⏵⏴]\s*[⏵⏴]?\s*(bypass|auto|plan|permissions?)/i.test(trimmed)) {
+      continue;
+    }
+    if (/^◐\s/.test(trimmed) || /^\s*◐\s/.test(trimmed)) {
+      continue;
+    }
+    if (/Pasting\s*text/i.test(trimmed)) {
+      continue;
+    }
+    if (/^Claude\s*Code\s*v/i.test(trimmed)) {
+      continue;
+    }
+    if (/Opus|Sonnet|Haiku|Claude\s*Max/i.test(trimmed) && trimmed.length < 80) {
+      continue;
+    }
+    if (/shift\+tab\s*to\s*cycle/i.test(trimmed)) {
+      continue;
+    }
+    if (/ctrl\+[a-z]\s+to\s/i.test(trimmed)) {
+      continue;
+    }
+    if (/^Try\s*"/.test(trimmed)) {
+      continue;
+    }
+    // Skip lines that are mostly box-drawing or block chars (>50%)
+    const specialChars = (trimmed.match(/[▐▝▘▛▜█▌▀▄░▒▓─━═╌┄│┃┌┐└┘├┤┬┴┼╔╗╚╝╠╣╦╩╬]/g) || []).length;
+    if (specialChars > trimmed.length * 0.5) {
+      continue;
+    }
+    cleaned.push(trimmed);
+  }
+  return cleaned.join('\n');
+}
+
+export { escapeHtml, stripAnsi, cleanPtyOutput };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-notification-plugin",
   "productName": "claude-notification-plugin",
-  "version": "1.1.38",
+  "version": "1.1.39",
   "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "type": "module",
   "engines": {