primocode 7.4.0 → 7.5.0

package/README.md

@@ -1,16 +1,13 @@
-# PrimoCode v7.4.0
+# PrimoCode v7.5.0
 
 Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
 Cria arquivos de verdade, roda comandos, **controla o navegador e o desktop** —
 e lembra do que fez entre uma sessão e outra.
 
 ```
-    ╭◠╮
-  ╭─┴─┴─╮
- ◖┫ ● ● ┣◗     PrimoCode  v7.4.0
-  ┃  ‿  ┃      projeto: jogo-de-carro
-  ╰──┬──╯
-   ╰─┴─╯
+ ▐▛███▜▌   Primo Code v7.5.0
+▝▜█████▛▘  Bem-vindo de volta, Joel
+  ▘▘ ▝▝    ~/projetos/jogo-de-carro
 ```
 
 Personalize o mascote (`primo`, `fox`, `cat`) e o nome com que ele te chama —
@@ -32,14 +29,35 @@ Em uma frase: **é o poder de um agente de código no terminal, em português, c
 
 ## Instalação
 
+**macOS / Linux / WSL** — um comando, e ele resolve tudo (inclusive instalar o Node, se faltar):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ConectaPrimoAI/primocode/main/install.sh | bash
+```
+
+**Windows** — baixe o repositório e rode:
+
+```cmd
+install.cmd
+```
+
+Já tem Node 18.17+? Então basta:
+
 ```bash
-git clone https://github.com/ConectaPrimoAI/primocode.git
-cd primocode
-npm link          # registra 'primocode' globalmente
-primocode
+npm install -g primocode
 ```
 
-Requer **Node.js 18.17+**. O CLI não tem dependências — só a stdlib do Node.
+Requer **Node.js 18.17+**. O CLI não tem dependências — só a stdlib do Node, por isso instala em segundos.
+
+### Se der erro
+
+| Erro | O que fazer |
+|---|---|
+| `command not found: npm` | Você não tem Node. Rode o `install.sh` — ele detecta, pergunta e instala pra você. |
+| `EACCES ... mkdir '/usr/local/lib/node_modules'` | O npm está apontando para uma pasta do sistema. **Não use `sudo`** — rode o `install.sh`, que move o npm para `~/.npm-global`. |
+| `command not found: primocode` | A instalação não terminou, ou o PATH não foi recarregado. Abra um terminal novo; se persistir, rode o `install.sh` de novo. |
+
+O `install.sh` é seguro de rodar quantas vezes quiser — ele conserta o que estiver errado e não duplica nada.
 
 ## Como funciona
 

package/bin/primocode.js

@@ -392,6 +392,17 @@ async function main() {
 
     const args = process.argv.slice(2);
 
+    // Flags padrão de CLI — funcionam em qualquer máquina, úteis em scripts/CI.
+    if (args[0] === '--version' || args[0] === '-v' || args[0] === '-V') {
+        console.log(`PrimoCode v${VERSION}`);
+        process.exit(0);
+    }
+    if (args[0] === '--help' || args[0] === '-h') {
+        console.log(welcomeBox(VERSION, null, { mascot: state.config.mascot, userName: state.config.userName }));
+        console.log(HELP);
+        process.exit(0);
+    }
+
     // Modo one-shot: primocode "crie um jogo de carro"
     if (args.length && !args[0].startsWith('-')) {
         const fileFlag = args.indexOf('-f');

package/lib/browser.js

@@ -3,7 +3,7 @@
 // mínimo escrito à mão em cima de 'net'/'tls'.
 //
 // Como funciona:
-//   1) launch() abre o Chrome do usuário com --remote-debugging-port=9222
+//   1) launch() abre o Chrome do usuário com --remote-debugging-port=3199
 //      e um --user-data-dir dedicado (~/.primocode/chrome-profile) — assim
 //      o usuário logado nesse profile persiste (login GitHub, Vercel, etc).
 //   2) attach() descobre a aba ativa em /json/list e abre um WebSocket CDP.
@@ -23,7 +23,8 @@ const crypto = require('crypto');
 const { spawn, execSync } = require('child_process');
 
 const PROFILE_DIR = path.join(os.homedir(), '.primocode', 'chrome-profile');
-const DEBUG_PORT = 9222;
+// Dentro da faixa 3100-3199 do ambiente local, para o start.sh cuidar dela.
+const DEBUG_PORT = Number(process.env.PRIMOCODE_CDP_PORT || 3199);
 
 // ---- Helpers ---------------------------------------------------
 function findChrome() {

package/lib/ui.js

@@ -37,63 +37,178 @@ const c = {
 };
 
 // ── Mascotes ─────────────────────────────────────────────────────────────
-// Primo, o mascote — expressivo e personalizável. Fones de "coach", antena
-// que brilha, olhos acesos. Escolha o estilo com /mascot.
-// Sem emoji — só formas geométricas de largura 1, alinhadas em qualquer
-// terminal monospace (Windows, Linux e Mac). Cada linha tem 9 colunas.
+// O mascote é um bloco fixo de 3 linhas × 9 colunas. Tamanho fixo porque ele
+// não fica sozinho: as três linhas de identidade do cabeçalho (nome, saudação,
+// pasta) sentam ao lado dele, uma por linha do desenho. Mudar a altura
+// desalinha o cabeçalho inteiro.
+//
+// Só glifos de bloco (U+2580–U+259F): largura 1 garantida em qualquer terminal
+// monospace, sem emoji e sem depender de fonte instalada.
+//
+// A família compartilha corpo e pés — o que muda é a linha de cima. É de
+// propósito: são o mesmo bicho de orelhas diferentes, não três desenhos de
+// autores diferentes. Troque com /mascot.
+
+const ART_W = 9;    // colunas de cada linha do desenho
+const ART_H = 3;    // linhas — igual ao número de linhas de identidade
+
+const CORPO = '▝▜█████▛▘';
+const PES   = '  ▘▘ ▝▝  ';
+
 const MASCOTS = {
-    // Padrão: robô-coach — antena que brilha, headset lateral, olhar vivo,
-    // sorriso e pezinhos. Limpo e simétrico, 11 colunas por linha.
-    primo: () => [
-        `    ${c.magenta('╭')}${c.magenta('◠')}${c.magenta('╮')}    `,
-        `  ${c.brand('╭─┴─┴─╮')}  `,
-        ` ${c.cyan('◖')}${c.brand('┫')} ${c.cyan('●')} ${c.cyan('●')} ${c.brand('┣')}${c.cyan('◗')} `,
-        `  ${c.brand('┃')}  ${c.magenta('‿')}  ${c.brand('┃')}  `,
-        `  ${c.brand('╰──┬──╯')}  `,
-        `   ${c.brandDim('╰─┴─╯')}   `,
-    ],
-    // Raposa — carismática e simétrica.
-    fox: () => [
-        ` ${c.warn('╱╲')}   ${c.warn('╱╲')} `,
-        `${c.warn('╱')}  ${c.warn('╲_╱')}  ${c.warn('╲')}`,
-        `${c.warn('▏')} ${c.cyan('◕')}   ${c.cyan('◕')} ${c.warn('▕')}`,
-        `${c.warn('╲')}   ${c.magenta('▾')}   ${c.warn('╱')}`,
-        ` ${c.warn('╲__')}${c.magenta('ᵕ')}${c.warn('__╱')} `,
-    ],
-    // Gato — minimalista e fofo.
-    cat: () => [
-        ` ${c.brand('╱╲_╱╲')}   `,
-        `${c.brand('│')} ${c.cyan('◕')} ${c.magenta('◡')} ${c.cyan('◕')} ${c.brand('│')}`,
-        ` ${c.brand('╲')}  ${c.magenta('▿')}  ${c.brand('╱')} `,
-        `  ${c.brand('╲───╯')}  `,
-    ],
+    // Padrão: o Primo — cabeça cheia, ombros marcados, dois pezinhos.
+    primo: { topo: ' ▐▛███▜▌ ', full: 'brand',  edge: 'brandDim' },
+    // Raposa — orelhas largas, abertas para fora.
+    fox:   { topo: ' ▛▀   ▀▜ ', full: 'warn',   edge: 'dim' },
+    // Gato — orelhas curtas e juntas.
+    cat:   { topo: ' ▛▘   ▝▜ ', full: 'cyan',   edge: 'brandDim' },
 };
 
+// Bloco cheio na cor viva, contorno na apagada: dá volume ao desenho sem
+// precisar de gradiente nem de cor de fundo.
+function shade(line, full, edge) {
+    let out = '';
+    for (const ch of line) {
+        if (ch === ' ') out += ch;
+        else if (ch === '█' || ch === '▀') out += c[full](ch);
+        else out += c[edge](ch);
+    }
+    return out;
+}
+
 function mascot(style) {
-    const fn = MASCOTS[style] || MASCOTS.primo;
-    return fn();
+    const m = MASCOTS[style] || MASCOTS.primo;
+    return [m.topo, CORPO, PES].map((l) => shade(l, m.full, m.edge));
 }
 
+// ── Medição de largura ───────────────────────────────────────────────────
+// Alinhar caixa em terminal exige contar colunas VISÍVEIS: os códigos ANSI
+// não ocupam espaço, e emoji/CJK ocupam duas colunas. Usar .length desalinha.
+
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+
+const stripAnsi = (s) => String(s).replace(ANSI_RE, '');
+
+function charWidth(cp) {
+    if (cp === 0x200d) return 0;                       // zero-width joiner
+    if (cp >= 0xfe00 && cp <= 0xfe0f) return 0;        // seletores de variação
+    if (cp >= 0x0300 && cp <= 0x036f) return 0;        // acentos combinantes
+    if (
+        (cp >= 0x1100 && cp <= 0x115f) ||
+        (cp >= 0x2e80 && cp <= 0xa4cf) ||
+        (cp >= 0xac00 && cp <= 0xd7a3) ||
+        (cp >= 0xf900 && cp <= 0xfaff) ||
+        (cp >= 0xfe30 && cp <= 0xfe6f) ||
+        (cp >= 0xff00 && cp <= 0xff60) ||
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f300 && cp <= 0x1f64f) ||            // emoji
+        (cp >= 0x1f900 && cp <= 0x1f9ff) ||
+        (cp >= 0x1f680 && cp <= 0x1f6ff)
+    ) return 2;
+    return 1;
+}
+
+function visibleWidth(s) {
+    let w = 0;
+    for (const ch of stripAnsi(s)) w += charWidth(ch.codePointAt(0));
+    return w;
+}
+
+// Corta preservando os códigos ANSI (senão a cor "vaza" para o resto da linha).
+function truncate(s, max) {
+    if (visibleWidth(s) <= max) return s;
+    const str = String(s);
+    let out = '', w = 0, i = 0;
+    while (i < str.length) {
+        ANSI_RE.lastIndex = i;
+        const m = ANSI_RE.exec(str);
+        if (m && m.index === i) { out += m[0]; i += m[0].length; continue; }
+        const ch = String.fromCodePoint(str.codePointAt(i));
+        const cw = charWidth(ch.codePointAt(0));
+        if (w + cw > max - 1) break;
+        out += ch; w += cw; i += ch.length;
+    }
+    return out + PALETTE.reset + PALETTE.dim + '…' + PALETTE.reset;
+}
+
+const padRight = (s, w) => s + ' '.repeat(Math.max(0, w - visibleWidth(s)));
+
+// ── Conteúdo do cabeçalho ────────────────────────────────────────────────
+// Editar aqui é o suficiente para mudar o que aparece na abertura.
+
+const NOME = 'Primo Code';
+
+const TIPS = [
+    'Peça um app novo, ou aponte para um repositório e mande clonar',
+    'Ele controla navegador e desktop de verdade — peça e veja',
+    '/help lista tudo · /mascot troca o mascote · /status confere a API',
+];
+
+const NEWS = [
+    'Cabeçalho novo: mascote em blocos e identidade em três linhas',
+    'Mascotes redesenhados na mesma família — primo, fox e cat',
+    'Instalador detecta e instala o Node sozinho, sem sudo e sem EACCES',
+];
+
+// ── Cabeçalho ────────────────────────────────────────────────────────────
+// Duas faixas: identidade (mascote + 3 linhas) e orientação (dicas,
+// novidades, modos). Sem caixa — moldura em terminal estreito quebra, e o
+// alinhamento do desenho já dá a borda esquerda de graça.
+
 function welcomeBox(version, contexto, opts = {}) {
     const { mascot: style, userName } = opts;
     const art = mascot(style);
-    const saudacao = userName ? `${c.white('Olá, ')}${c.bold(c.brand(userName))}` : c.muted('agente de engenharia');
-    const side = [
-        '',
-        `${c.bold(c.brand('P R I M O C O D E'))}`,
-        `${saudacao}  ${c.dim('v' + version)}`,
-        contexto ? c.brandDim('▸ ' + contexto) : c.dim('nenhuma pasta ativa'),
-        c.dim('cria arquivos · roda comandos · controla navegador e desktop'),
-        '',
+    const cols = Math.max(32, Math.min(process.stdout.columns || 100, 120));
+
+    const saudacao = userName
+        ? `${c.muted('Bem-vindo de volta, ')}${c.bold(c.white(userName))}`
+        : c.muted('Bem-vindo de volta');
+
+    // As três linhas de identidade — uma por linha do mascote, na ordem em que
+    // se lê: quem é, quem chegou, onde estamos.
+    const ident = [
+        `${c.bold(c.brand(NOME))} ${c.dim('v' + version)}`,
+        saudacao,
+        contexto ? c.brandDim(contexto) : c.dim('nenhuma pasta ativa'),
     ];
-    const rows = art.map((linha, i) => `  ${linha}   ${side[i] || ''}`);
-    return [
-        '',
-        ...rows,
-        '',
-        `  ${c.magenta('●')} ${c.muted('Primo Code')}   ${c.brand('●')} ${c.muted('Chat')}   ${c.dim('/help')} ${c.dim('para tudo')}`,
-        '',
-    ].join('\n');
+
+    const out = [''];
+
+    // Terminal estreito: o texto ao lado não caberia, então empilha embaixo.
+    const largo = cols >= ART_W + 2 + 28;
+    if (largo) {
+        const textW = cols - ART_W - 2;
+        for (let i = 0; i < ART_H; i++) {
+            out.push(art[i] + '  ' + truncate(ident[i] || '', textW));
+        }
+    } else {
+        out.push(...art);
+        out.push('');
+        out.push(...ident.map((l) => truncate(l, cols)));
+    }
+
+    // Cada item ocupa 5 colunas de prefixo ("  1. "), então o texto tem cols-5.
+    // Estourar por uma coluna quebra a linha e o cabeçalho parece defeito.
+    const secao = (titulo, itens, marca) => {
+        out.push('');
+        out.push('  ' + c.bold(c.white(titulo)));
+        itens.forEach((t, i) => {
+            out.push(`  ${c.dim(marca(i))} ${truncate(c.muted(t), cols - 5)}`);
+        });
+    };
+
+    secao('Dicas para começar', TIPS, (i) => `${i + 1}.`);
+    secao('Novidades', NEWS, () => ' ·');
+
+    // Rodapé de modos. Em terminal apertado a dica do /help sai antes de
+    // empurrar a linha para baixo — cabeçalho que quebra parece defeito.
+    const modos =
+        `  ${c.magenta('●')} ${c.muted('Primo Code')}` +
+        `   ${c.brand('●')} ${c.muted('Chat')}`;
+    out.push('');
+    out.push(cols >= 44 ? `${modos}   ${c.dim('/help para tudo')}` : modos);
+    out.push('');
+    return out.join('\n');
 }
 
 class Spinner {
@@ -234,4 +349,4 @@ function askYesNo(question) {
     });
 }
 
-module.exports = { c, mascot, welcomeBox, Spinner, ProgressBar, actionHeader, toolLine, toolResult, fmtBytes, renderMarkdown, askYesNo, friendlyError };
+module.exports = { c, mascot, welcomeBox, Spinner, ProgressBar, actionHeader, toolLine, toolResult, fmtBytes, renderMarkdown, askYesNo, friendlyError, visibleWidth, stripAnsi, truncate, padRight };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primocode",
-  "version": "7.4.0",
+  "version": "7.5.0",
   "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Modo primocode cria arquivos, controla o desktop e navegador. Modo chat é conversa pura.",
   "main": "bin/primocode.js",
   "bin": {