polygram 0.11.0-rc.3 → 0.11.0-rc.5

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.5",
   "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/channels-process.js

@@ -431,10 +431,24 @@ class ChannelsProcess extends Process {
     const cwd = topicConfig?.cwd || opts.chatConfig?.cwd || opts.cwd;
     if (cwd) claudeArgs.unshift('--add-dir', cwd);
 
+    // rc.5 (2026-05-25 shumorobot diagnosis): the launch cwd MUST be the
+    // resolved topic/chat cwd, not just opts.cwd. claude's TUI indexes
+    // session storage by current working directory — its session files
+    // live under ~/.claude/projects/<cwd-with-dashes>/<session-id>.jsonl.
+    // When polygram launched claude with cwd=process.cwd() (the daemon's
+    // own working dir, e.g. ~/.polygram), `--resume <id>` looked in the
+    // wrong projects dir and printed "No conversation found with session
+    // ID: <id>" then exited clean — surfacing as "Process exited (code 0)"
+    // immediately after the bridge briefly connected.
+    //
+    // Mirrors lib/process/tmux-process.js:488 + :659 — same resolution,
+    // same fallback chain. The `--add-dir` flag is independent: it
+    // declares an additional trusted-roots entry, NOT the launch dir.
+    //
     // Real tmuxRunner.spawn signature: {name, cwd, command, args, envExtras, paneWidth}
     await this.runner.spawn({
       name: tmuxName,
-      cwd: opts.cwd || process.cwd(),
+      cwd: cwd || opts.cwd || process.cwd(),
       command: this.claudeBin,
       args: claudeArgs,
     });

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.5",
   "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": {