paris-immersion 0.1.14 → 0.1.15

package/dist/commands/install.js

@@ -90,11 +90,15 @@ async function writeWorkspaceFiles(targetDir, boot, apiUrl, email) {
     const skillDir = path.join(claudeDir, 'skills', 'paris-coach');
     await fs.mkdir(skillDir, { recursive: true });
     await fs.writeFile(path.join(skillDir, 'SKILL.md'), renderParisCoachSkill());
-    // .claude/commands/tostudy.md — NOSSO slash-command /tostudy (rota confiável do
-    // curso). Garante que /tostudy sempre exista, independente do @tostudy-ai/cli.
-    const commandsDir = path.join(claudeDir, 'commands');
-    await fs.mkdir(commandsDir, { recursive: true });
-    await fs.writeFile(path.join(commandsDir, 'tostudy.md'), renderTostudyCommand());
+    // /tostudy.md — NOSSO slash-command (rota confiável do curso). Escrito nos DOIS
+    // lugares que o Claude carrega: o do PROJETO e o GLOBAL (~/.claude/commands) —
+    // o global é o que faz funcionar em máquinas que já rodaram `tostudy init`, e
+    // agora vale pra todo aluno novo também. Independe do @tostudy-ai/cli.
+    const tostudyCmd = renderTostudyCommand();
+    for (const dir of [path.join(claudeDir, 'commands'), path.join(homedir(), '.claude', 'commands')]) {
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(path.join(dir, 'tostudy.md'), tostudyCmd);
+    }
     // CLAUDE.md — workspace-level rules.
     await fs.writeFile(path.join(targetDir, 'CLAUDE.md'), renderClaudeMd({
         immersionName: boot.immersion.name,

package/dist/commands/serve.js

@@ -160,13 +160,19 @@ export function resolveKickoff(cwd) {
  * workspaces antigos e manter o conteúdo fresco a cada serve. Best-effort.
  */
 function ensureTostudyCommand(cwd) {
-    try {
-        const dir = path.join(cwd, '.claude', 'commands');
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(path.join(dir, 'tostudy.md'), renderTostudyCommand());
-    }
-    catch {
-        /* best-effort — se falhar, o resolveKickoff cai no fallback de texto */
+    const body = renderTostudyCommand();
+    // Escreve nos DOIS lugares que o Claude Code carrega slash-commands: o do
+    // PROJETO (workspace) e o GLOBAL (~/.claude/commands). É justamente o comando
+    // global que faz o terminal funcionar em máquinas que já passaram por um
+    // `tostudy init` — replicamos isso pra TODA máquina, inclusive a do aluno novo.
+    for (const dir of [path.join(cwd, '.claude', 'commands'), path.join(homedir(), '.claude', 'commands')]) {
+        try {
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(path.join(dir, 'tostudy.md'), body);
+        }
+        catch {
+            /* best-effort — se um falhar, o outro cobre; senão cai no fallback de texto */
+        }
     }
 }
 export function spawnCoachPty(cwd) {
@@ -237,6 +243,11 @@ export async function startServeServer(opts) {
         wss.once('error', reject);
     });
     wss.on('connection', (ws) => {
+        // TCP_NODELAY: sem Nagle no socket local (caminho dev ws://localhost).
+        try {
+            ws._socket?.setNoDelay?.(true);
+        }
+        catch { /* noop */ }
         if (opts.dryRun) {
             // Tests use this branch — we just confirm the handshake passed.
             ws.send('READY\n');

package/dist/index.js

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

package/dist/lib/relay-agent.js

@@ -100,12 +100,20 @@ export async function startRelayAgent(opts) {
     const MAX_OUT_BUF = 256 * 1024;
     let outBuf = '';
     let flushTimer;
+    // Adaptativo: o PRIMEIRO chunk de uma rajada (depois de um período de silêncio)
+    // sai NA HORA — o eco de uma tecla e o início da resposta do Claude não pagam a
+    // janela inteira de coalescing. Só a CAUDA da rajada (tokens que chegam dentro
+    // da janela, streaming token-a-token) é coalescida, mantendo a escrita lisa.
+    // "Fast first byte, smooth tail." lastFlushAt marca o último envio: se passou
+    // mais de COALESCE_MS desde então E o buffer estava vazio, é um novo burst.
+    let lastFlushAt = 0;
     const flushOut = () => {
         flushTimer = undefined;
         if (!outBuf)
             return;
         const data = outBuf;
         outBuf = '';
+        lastFlushAt = Date.now();
         if (ws && ws.readyState === WebSocket.OPEN) {
             try {
                 ws.send(seal(key, TYPE_DATA, Buffer.from(data, 'utf8')), { binary: true });
@@ -147,9 +155,14 @@ export async function startRelayAgent(opts) {
             return;
         }
         pty.onData((d) => {
+            // Novo burst = buffer vazio E sem timer armado E passou >COALESCE_MS desde o
+            // último flush (= veio depois de um silêncio, p.ex. o aluno apertou Enter e o
+            // Claude começa a responder). Captura ANTES do append (depois nunca é vazio).
+            const newBurst = !outBuf && !flushTimer && Date.now() - lastFlushAt >= COALESCE_MS;
             outBuf += d;
-            // Flush imediato se acumulou muito (evita um frame gigante); senão coalesce.
-            if (outBuf.length >= MAX_OUT_BUF) {
+            // Flush imediato se acumulou muito (evita um frame gigante) OU se é o primeiro
+            // chunk de um novo burst (latência baixa pro início da resposta); senão coalesce.
+            if (outBuf.length >= MAX_OUT_BUF || newBurst) {
                 if (flushTimer) {
                     clearTimeout(flushTimer);
                     flushTimer = undefined;
@@ -201,7 +214,17 @@ export async function startRelayAgent(opts) {
             return;
         const url = `${relayUrl.replace(/\/$/, '')}/agent?token=${encodeURIComponent(token)}`;
         ws = new WebSocket(url);
-        ws.on('open', () => log(`relay: conectado (${relayUrl})`));
+        ws.on('open', () => {
+            // TCP_NODELAY: terminal interativo manda frames pequenos; sem isso o Nagle
+            // os enfileira (~40ms/hop, pior ainda com delayed-ACK) → digitação e o 1º
+            // paint de cada resposta ficam visivelmente lentos. _socket é interno do
+            // `ws` — optional-chaining + try/catch degrada pro comportamento atual se mudar.
+            try {
+                ws._socket?.setNoDelay?.(true);
+            }
+            catch { /* noop */ }
+            log(`relay: conectado (${relayUrl})`);
+        });
         ws.on('message', (data, isBinary) => {
             if (!isBinary) {
                 // Controle do relay (texto): viewer-joined / viewer-left.

package/package.json

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