polygram 0.11.0-rc.3 → 0.11.0-rc.4

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "polygram",
-  "version": "0.11.0-rc.3",
+  "version": "0.11.0-rc.4",
   "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/tmux/startup-gate.js

@@ -72,16 +72,42 @@ async function runStartupGate({
   const deadline = startedAt + deadlineMs;
   const seen = new Set();
   const matchedTriggers = [];
+  // rc.4: remember the most recent successful pane snapshot. If the gate
+  // fails (deadline OR session-gone), include the snapshot in the error
+  // so we can see what the TUI last printed before claude exited. Without
+  // this, "claude exits code 0 after dev-channels Enter" surfaces as a
+  // 30-second `can't find pane` spam with no diagnostic about WHY.
+  let lastPane = null;
 
   while (Date.now() < deadline) {
     let pane;
     try {
       pane = await runner.captureWide(tmuxName);
     } catch (err) {
-      logger.warn?.(`[${label}] captureWide failed: ${err.message}`);
+      // rc.4: detect "can't find pane" / "no server" — tmux session died
+      // (claude exited, killed the bash that hosted it, tmux tore down the
+      // pane). Fast-fail with a distinct code instead of spinning for the
+      // full deadline. Pattern matches the actual tmux capture-pane errors:
+      //   - "can't find pane: <name>"     (session/pane gone after spawn)
+      //   - "no server running"           (entire tmux server gone)
+      const msg = err?.message || '';
+      if (/can't find (pane|session)|no server running|session not found/i.test(msg)) {
+        const goneErr = new Error(
+          `[${label}] tmux session disappeared for ${tmuxName} after ${Date.now() - startedAt}ms ` +
+          `(matched: ${matchedTriggers.length ? matchedTriggers.join(', ') : 'none'}). ` +
+          `claude likely exited; last pane content:\n` +
+          _formatPaneTail(lastPane),
+        );
+        goneErr.code = 'TMUX_SESSION_GONE';
+        goneErr.lastPane = lastPane;
+        goneErr.matchedTriggers = matchedTriggers;
+        throw goneErr;
+      }
+      logger.warn?.(`[${label}] captureWide failed: ${msg}`);
       await new Promise(r => setTimeout(r, settleMs));
       continue;
     }
+    lastPane = pane;
 
     // Walk triggers in declaration order — first match (and not yet seen) wins
     let matched = false;
@@ -111,12 +137,33 @@ async function runStartupGate({
 
   const err = new Error(
     `[${label}] startup gate did not resolve within ${deadlineMs}ms for ${tmuxName} ` +
-    `(matched: ${matchedTriggers.length ? matchedTriggers.join(', ') : 'none'})`,
+    `(matched: ${matchedTriggers.length ? matchedTriggers.join(', ') : 'none'}). ` +
+    `Last pane content:\n` +
+    _formatPaneTail(lastPane),
   );
   err.code = timeoutCode;
+  err.lastPane = lastPane;
+  err.matchedTriggers = matchedTriggers;
   throw err;
 }
 
+/**
+ * Render the last ~800 chars of pane content for inclusion in error messages.
+ * Truncate at line boundaries when possible so the diagnostic isn't visually
+ * mangled. Returns "(no pane content ever captured)" for null/undefined.
+ */
+function _formatPaneTail(pane) {
+  if (!pane) return '  (no pane content ever captured — claude exited before first captureWide)';
+  const MAX = 800;
+  const text = String(pane);
+  if (text.length <= MAX) return text.split('\n').map(l => '  ' + l).join('\n');
+  // Take last MAX chars, then trim to a line boundary if one exists nearby
+  let tail = text.slice(-MAX);
+  const nl = tail.indexOf('\n');
+  if (nl > 0 && nl < 80) tail = tail.slice(nl + 1);
+  return '  …(truncated)…\n' + tail.split('\n').map(l => '  ' + l).join('\n');
+}
+
 module.exports = {
   runStartupGate,
   DEFAULT_DEADLINE_MS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polygram",
-  "version": "0.11.0-rc.3",
+  "version": "0.11.0-rc.4",
   "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": {