polygram 0.10.0-rc.30 → 0.10.0-rc.31

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "polygram",
-  "version": "0.10.0-rc.30",
+  "version": "0.10.0-rc.31",
   "description": "Telegram integration for Claude Code that preserves the OpenClaw per-chat session model. Migration target for OpenClaw users. Multi-bot, multi-chat, per-topic isolation; SQLite transcripts; inline-keyboard approvals. Bundles /polygram:status|logs|pair-code|approvals admin commands plus history (transcript queries) and polygram-send (out-of-turn IPC sends with file-upload validation) skills.",
   "keywords": [
     "telegram",

package/lib/process/tmux-process.js

@@ -496,6 +496,54 @@ class TmuxProcess extends Process {
         throw Object.assign(new Error(binCheck.reason), { code: 'CLAUDE_BIN_MISSING' });
       }
 
+      // Spawn-time reconcile (shumorobot 2026-05-20 18:51 incident).
+      // A tmux session with our name may already exist on the host
+      // BEFORE we spawn — sources:
+      //   - pm_backend drift: chat config flipped tmux → sdk → tmux;
+      //     polygram dropped its in-memory handle but the previous
+      //     daemon's tmux session is still running headless.
+      //   - Boot-sweep raced a concurrent operator (already noted in
+      //     lib/tmux/orphan-sweep.js header).
+      //   - Crash mid-spawn: the spawn() call landed but the sessionCreated
+      //     teardown below was bypassed (SIGKILL).
+      // The orphan TUI inside is headless — its parent daemon (or any
+      // previous attach) is dead, its --debug-file isn't being tailed,
+      // and any JSONL it writes is unrouted. The live claude session
+      // ID inside is NOT recoverable from outside without probing the
+      // pane (flaky) — and we don't need to: claude's per-session JSONL
+      // lives in ~/.claude/projects/.../<sid>.jsonl independent of
+      // tmux, so a fresh --resume into a clean pane recovers the
+      // conversation cleanly.
+      //
+      // Strategy: detect → kill → re-check → spawn. Always-kill is
+      // safer than try-to-reuse — we have no living claim to the orphan.
+      // If kill fails (server gone, races a concurrent kill), the
+      // subsequent spawn will surface a clear TMUX_SPAWN_FAILED with
+      // the underlying tmux error for the operator.
+      if (typeof this.runner.sessionExists === 'function'
+        && await this.runner.sessionExists(this.tmuxName)) {
+        this.logger.warn?.(
+          `[${this.label}] orphan tmux session ${this.tmuxName} present at spawn — killing`,
+        );
+        this.emit('spawn-reconcile', {
+          tmux_name: this.tmuxName,
+          phase: 'kill-orphan',
+          backend: 'tmux',
+        });
+        try {
+          await this.runner.killSession(this.tmuxName);
+        } catch (killErr) {
+          this.logger.warn?.(
+            `[${this.label}] spawn-reconcile killSession failed (continuing): ${killErr.message}`,
+          );
+        }
+        // Brief settle window so the tmux server releases the name
+        // before we re-spawn. tmux's kill-session is synchronous in
+        // the client but the server's session-name release can race
+        // a tight kill→new-session pair (observed on busy hosts).
+        await new Promise((r) => setTimeout(r, 50));
+      }
+
       // R2-F8: spawn errors must fail loud, not silent-catch.
       await this.runner.spawn({
         name: this.tmuxName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polygram",
-  "version": "0.10.0-rc.30",
+  "version": "0.10.0-rc.31",
   "description": "Telegram daemon for Claude Code that preserves the OpenClaw per-chat session model. Migration path for OpenClaw users moving to Claude Code.",
   "main": "lib/ipc/client.js",
   "bin": {