@khanglvm/relay 0.13.0 → 0.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khanglvm/relay",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Question boards with rich blocks (markdown, charts, mermaid, tables, code, diffs, video, sandboxed HTML), clickable local file-links, and element-level annotations for AI coding agents (Claude Code, Codex, …): ask users structured questions, present interactive visuals, collect inline comments, read answers as JSON — in a local browser board OR rendered INLINE inside the Claude & Codex apps as an MCP App (SEP-1865).",
   "keywords": [
     "ai-agents",

package/skills/relay/SKILL.md

@@ -472,9 +472,31 @@ one yesno "Does this match your mental model?" + a textarea for notes.
 `rly history` (saved boards) · `rly spec <id>` (print spec to modify) ·
 `rly reuse <id>` (re-run blank) · `rly reopen <id>` (re-open with saved
 answers prefilled) · `rly reopen <id> --replies file.json` (add agent replies) ·
+`rly rescue <id>` (re-serve a dropped board on its ORIGINAL port) ·
 `rly list` / `rly open` / `rly stop <id>` · `rly rm <id>`.
 Multiple boards can run concurrently.
 
+### Continue a board — reconnect, NEVER recreate it
+
+When the user refers to a board that already exists — a URL/port ("the board on
+`127.0.0.1:59926`"), "the board from yesterday", "reopen it", "it disconnected"
+— do **NOT** run `rly ask`/`rly show`. A fresh board lands on a **new port**,
+**strands the user's open tab** on the dead one, and **loses their comments**.
+Find the real board and reconnect it:
+
+1. **Identify it** — `rly list` (running) and `rly history` (saved) print each
+   board's id, title, and url/port. Match by what the user said (port, title).
+2. **Tab still open but "connection lost"** (server died / machine slept) →
+   `rly rescue <id>`. Re-serves on the SAME port so that tab reconnects on its
+   own and re-flushes any comments it buffered — no new tab, no lost input.
+3. **Want a fresh tab** with prior answers prefilled → `rly reopen <id>` (also
+   reuses the board's last port, so an old tab still reconnects).
+4. `rly reuse <id>` is the ONLY "make a new board from this one" path — use it
+   solely for a deliberately blank re-run, never to "continue" or "reconnect".
+
+Rule of thumb: **an existing board is reconnected (`rescue`/`reopen`), never
+re-asked.** Only call `rly ask`/`rly show` for a genuinely new question.
+
 ### Live mutation — `rly update`
 
 Push a new spec to a running board. The page reloads and prefills answers from the

package/src/cli.js

@@ -349,7 +349,10 @@ async function cmdReopen(args) {
     printJson({ status: 'open', boardId: record.id, url: running.url, note: 'already running — browser re-opened' });
     return 0;
   }
-  return runOrDetach(record, args);
+  // Reuse the board's last port (unless the user forced one) so a tab still open
+  // from a previous run reconnects on its own instead of being stranded on a
+  // dead port. runBoard falls back to a random port if it's been taken.
+  return runOrDetach(record, { ...args, port: args.port ?? record.lastPort });
 }
 
 // Rescue a board whose browser tab is still open but disconnected (its server

package/src/server.js

@@ -693,9 +693,25 @@ export async function runBoard({ id, port = 0, open = true, timeoutSec = 1800, q
     }
   });
 
+  // Bind the requested port (reopen/rescue reuse the board's last port so a
+  // still-open tab reconnects). If that port was grabbed by another process in
+  // the meantime, fall back to a random free one rather than failing to boot.
   await new Promise((resolve, reject) => {
-    server.once('error', reject);
-    server.listen(port, '127.0.0.1', resolve);
+    const bind = (p, allowFallback) => {
+      const onErr = (e) => {
+        if (allowFallback && e && e.code === 'EADDRINUSE' && p !== 0) {
+          bind(0, false); // desired port busy → random free one
+        } else {
+          reject(e);
+        }
+      };
+      server.once('error', onErr);
+      server.listen(p, '127.0.0.1', () => {
+        server.removeListener('error', onErr);
+        resolve();
+      });
+    };
+    bind(port, true);
   });
   const actualPort = server.address().port;
   const url = `http://127.0.0.1:${actualPort}/`;