paris-immersion 0.1.3 → 0.1.5

package/dist/index.js

@@ -12,7 +12,7 @@ import { serveCommand } from './commands/serve.js';
 const program = new Command()
     .name('paris')
     .description('Paris Immersion — CLI do aluno (login, workspace, tarefas)')
-    .version('0.1.3');
+    .version('0.1.5');
 program
     .command('login')
     .description('Autenticar com sua conta Paris (device-code OR --token direto)')

package/dist/lib/relay-agent.js

@@ -68,12 +68,44 @@ export async function startRelayAgent(opts) {
     let closed = false;
     let reconnect;
     let killTimer;
+    // Tamanho atual do pty (spawnCoachPty começa 80x24). Usado pra detectar resize
+    // "no-op" (reconexão com mesma dimensão) e forçar o Claude a repintar.
+    let ptyCols = 80;
+    let ptyRows = 24;
+    // Coalescing da saída do pty: o Claude emite a tela em RAJADAS de muitos
+    // chunks pequenos. Cifrar/enviar cada um (1 AES-GCM + 1 frame WS por chunk)
+    // é caro e deixa a escrita lenta. Junta numa janela curta → 1 frame por
+    // rajada. ~12ms é imperceptível e corta o overhead drasticamente.
+    const COALESCE_MS = 12;
+    const MAX_OUT_BUF = 64 * 1024;
+    let outBuf = '';
+    let flushTimer;
+    const flushOut = () => {
+        flushTimer = undefined;
+        if (!outBuf)
+            return;
+        const data = outBuf;
+        outBuf = '';
+        if (ws && ws.readyState === WebSocket.OPEN) {
+            try {
+                ws.send(seal(key, TYPE_DATA, Buffer.from(data, 'utf8')), { binary: true });
+            }
+            catch {
+                /* ws caiu no meio */
+            }
+        }
+    };
     // Mantém o Claude vivo por uma janela após o viewer sair, pra que uma
     // reconexão (ex.: Safari derruba o ws periodicamente) REATACHE na MESMA sessão
     // em vez de reiniciar o curso. O resize que o viewer manda ao reconectar faz a
     // TUI do Claude repintar a tela atual.
-    const PTY_GRACE_MS = 60_000;
+    const PTY_GRACE_MS = 600_000; // 10min — aluno que sai no meio e volta reatacha na MESMA sessão
     const killPty = () => {
+        if (flushTimer) {
+            clearTimeout(flushTimer);
+            flushTimer = undefined;
+        }
+        outBuf = '';
         if (pty) {
             try {
                 pty.kill();
@@ -95,17 +127,43 @@ export async function startRelayAgent(opts) {
             return;
         }
         pty.onData((d) => {
-            if (ws && ws.readyState === WebSocket.OPEN) {
-                try {
-                    ws.send(seal(key, TYPE_DATA, Buffer.from(d, 'utf8')), { binary: true });
-                }
-                catch {
-                    /* ws caiu no meio */
+            outBuf += d;
+            // Flush imediato se acumulou muito (evita um frame gigante); senão coalesce.
+            if (outBuf.length >= MAX_OUT_BUF) {
+                if (flushTimer) {
+                    clearTimeout(flushTimer);
+                    flushTimer = undefined;
                 }
+                flushOut();
+            }
+            else if (!flushTimer) {
+                flushTimer = setTimeout(flushOut, COALESCE_MS);
             }
         });
         pty.onExit?.(() => killPty());
     };
+    // Força o Claude a repintar a tela INTEIRA (não só os diffs). Necessário quando
+    // um viewer reconecta com um xterm em branco e manda o MESMO tamanho — sem
+    // mudança de tamanho não há SIGWINCH, então o Claude não redesenha e a tela
+    // fica vazia/quebrada. Um "nudge" (uma linha a menos e volta) gera o SIGWINCH.
+    const forceRepaint = () => {
+        if (!pty || ptyCols < 1 || ptyRows < 2)
+            return;
+        try {
+            pty.resize(ptyCols, ptyRows - 1);
+        }
+        catch {
+            /* noop */
+        }
+        setTimeout(() => {
+            try {
+                pty?.resize(ptyCols, ptyRows);
+            }
+            catch {
+                /* noop */
+            }
+        }, 80);
+    };
     const connect = () => {
         if (closed)
             return;
@@ -148,13 +206,20 @@ export async function startRelayAgent(opts) {
             }
             else if (msg.type === TYPE_RESIZE) {
                 const [cols, rows] = msg.body.toString('utf8').split(',').map(Number);
-                if (Number.isFinite(cols) && Number.isFinite(rows)) {
+                if (Number.isFinite(cols) && Number.isFinite(rows) && cols > 0 && rows > 0) {
+                    const same = cols === ptyCols && rows === ptyRows;
+                    ptyCols = cols;
+                    ptyRows = rows;
                     try {
                         pty.resize(cols, rows);
                     }
                     catch {
                         /* race de resize */
                     }
+                    // Mesma dimensão (reconexão) não dispara SIGWINCH → o Claude não
+                    // repinta e a tela fica em branco/quebrada. Força o repaint.
+                    if (same)
+                        forceRepaint();
                 }
             }
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paris-immersion",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Paris Immersion CLI — login, install workspace, status, task control. Para alunos das imersões da Paris Group.",
   "homepage": "https://parisgroup.ai",
   "repository": {