primocode 9.8.0-beta.0 → 9.8.0-beta.10

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v9.7.0
+# PrimoCode v9.8.0-beta.10
 
 Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
 Cria arquivos de verdade, roda comandos, **controla o navegador e o desktop** —
@@ -9,7 +9,7 @@ OpenRouter, e cada apelido (`top`/`main`/`fast`) é uma **corrente**: se um mode
 está no limite de pedidos, o próximo atende. Você não vê o erro, e não paga nada.
 
 ```
- ▐▛███▜▌   Primo Code v9.7.0
+ ▐▛███▜▌   Primo Code v9.8.0-beta.10
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -27,7 +27,7 @@ veja `/mascot` e `/name`.
 | **Memória** | Cada projeto lembra o que foi feito, entre sessões | Esquece ao fechar |
 | **Instalação** | Node puro, **zero dependências** — segundos | Pacotes e dependências |
 | **Cara própria** | Mascote, nome e temas que você escolhe | Fixo |
-| **Modelos** | Escolhidos pelo produto, não por você: `/effort` regula o esforço e o modelo sai daí | Preso ao provedor do fabricante |
+| **Modelos** | Escolhidos pelo produto (`/effort` regula o esforço), ou a sua própria chave com `/api` | Preso ao provedor do fabricante |
 
 Em uma frase: **é o poder de um agente de código no terminal, em português, controlando o seu computador de verdade — sem você precisar configurar chave de API nenhuma.**
 
@@ -275,6 +275,7 @@ caminho fora do projeto.
 primocode                              # interativo
 primocode "crie um jogo de carro"      # one-shot
 primocode -f app.js "onde está o bug?" # com arquivo anexado
+primocode -c                           # continua a última conversa salva (--continue)
 ```
 
 ## Comandos
@@ -283,21 +284,39 @@ primocode -f app.js "onde está o bug?" # com arquivo anexado
 |---|---|
 | `/dir <caminho>` | Trabalha numa pasta que já existe, onde você quiser |
 | `/project` | Lista projetos. `/project <nome>` cria em `~/primocode` |
+| `/projetos [n]` | Os projetos de `~/primocode` do mais recente para o mais antigo, com quando mexeu e o tamanho. `/projetos 2` entra no segundo (o `/project` sem nome mostra a mesma lista) |
+| `/novo <descrição>` | Começa um projeto NOVO do zero, em pasta própria com nome escolhido pelo modelo — sem cair num projeto parecido que já existe |
 | `/mode primocode\|chat\|auto` | Alterna o modo (fica guardado) |
 | `/voice` | Modo voz: uma orb, você fala, ele faz. O cérebro é o mesmo do terminal |
+| `/comandos` | Seus comandos: um `.md` em `~/.primocode/comandos/` (ou `<projeto>/.primocode/comandos/`) vira `/nome`, e `$ARGUMENTOS` recebe o que vem depois. Já vêm `/revisar`, `/explicar` e `/publicar`. `/comandos novo <nome>` cria um |
 | `/skills` · `/marketplace` | O que ele sabe fazer bem. Tela navegável pelas setas, e "New Skill" para escrever a sua |
 | `/connectors` | Quem está atendendo os seus pedidos (só mostra — não há o que configurar) |
-| `/effort` | O esforço do agente, num slider (←/→, Enter confirma): do `low` ao `ultracode`. O modelo sai daí — não há provedor nem chave para configurar |
+| `/effort` | O esforço do agente, num slider (←/→, Enter confirma): do `low` ao `ultracode`. O modelo sai daí |
+| `/permissoes auto\|perguntar\|livre` | Quando ele pede licença. `auto` (padrão) roda tudo, mas pergunta antes do que não tem volta; `perguntar` pede antes de todo comando e toda escrita; `livre` nunca pergunta (fica guardado) |
+| `/api` | Roda com a SUA assinatura (Claude Code, Codex, sem chave) ou a SUA chave (Gemini, ChatGPT, Claude, Groq, OpenRouter, DeepSeek), direto do seu computador, sem o limite do servidor. `/api modelo <nome>` troca o modelo · `/api off` volta ao servidor |
+| `/init` | Estuda o projeto e escreve um `PRIMO.md` na raiz: o que é, como rodar, stack, convenções. Ele é lido em todo pedido (vale também `AGENTS.md` ou `CLAUDE.md`, e `~/.primocode/PRIMO.md` para todos os projetos) |
+| `@arquivo` | No meio do pedido (`melhora o @index.html`, `@"nome com espaço.txt"`) anexa aquele arquivo do projeto só a esse pedido. Até 40 KB por arquivo, 120 KB no total |
 | `/attach <arquivo>` | Anexa arquivo ao próximo pedido |
 | `/detach` · `/files` | Remove / lista anexos |
 | `/all` | Lista as 46 ferramentas que ele sabe usar, por grupo |
+| `/desfazer` · `/undo` | Volta o projeto para como estava antes do último pedido — inclusive o que um comando apagou, moveu ou gerou (com git instalado, cada pedido tira uma foto do projeto num git à parte, que não toca no seu `.git`; `node_modules`, `dist` e o que o `.gitignore` ignora ficam de fora). Sem git, volta o que o agente escreveu com as ferramentas de arquivo. `/desfazer lista` mostra os pedidos e quantos arquivos cada um mudou · `/desfazer N` volta os N últimos |
 | `/tree [n]` | Árvore do projeto atual |
 | `/read <arquivo>` | Mostra um arquivo do projeto |
 | `/run <comando>` | Executa no shell, dentro da pasta do projeto |
 | `/open <arquivo\|url>` | Abre no navegador |
+| `/rc` | Abre a janela do PrimoCode, um app de mesa: barra lateral com **Novo chat**, **Projetos** (de `~/primocode`) e **Recentes**; a conversa no meio, com cada ação do Primo numa linha ("Editou style.css +12 −3", "Rodou npm test ✓") que abre para mostrar o detalhe; e o compositor embaixo com **Escolher projeto**, **+** (anexa arquivo, como o `/attach`), a permissão (`/permissoes`: *Pergunta antes do perigoso* · *Pergunta sempre* · *Acesso completo*), o esforço (`/effort`), o microfone (`/voice`) e enviar/parar (Esc Esc para). O botão **Terminal** mostra a saída crua do CLI |
+| `/ide` | Abre a mesma janela do `/rc`, já com o painel da direita: **Prévia** (o `index.html` do projeto, que recarrega sozinho quando ele mexe num arquivo) e **Arquivos** (a pasta do projeto, só leitura). O editor de código antigo saiu |
+| `primo ide` | Do shell: abre o PrimoCode já com a janela e a prévia abertas (`primo "pedido"` continua sendo o modo de um pedido só) |
+| `/abrir` | Abre o projeto atual no navegador: o servidor dele, se estiver de pé, ou a `index.html` (o `/open` sem nada faz o mesmo) |
+| `/copiar` | Copia a última resposta para a área de transferência (pbcopy, clip, wl-copy/xclip/xsel) |
+| `/historico [termo]` | Procura nos seus pedidos guardados nesta máquina (`~/.primocode/history.jsonl`), do mais recente. As conversas inteiras da conta ficam no `/chats` |
 | `/status` | Health check do servidor |
+| `/offline` | Temporário: sobe o `primocode-server` no seu computador (a pasta ao lado do CLI, ou `/offline <caminho>`) com as chaves de `~/.primocode/servidor.env` e aponta a sessão pra ele. `/offline off` volta ao servidor de antes |
+| `/doctor` | Confere tudo com ✓/✗: Node, servidor, `/api`, Chrome, Python+PyObjC (cursor, macOS), disco e config. Cada ✗ diz como consertar |
+| `/custo` | Tokens enviados e recebidos e pedidos feitos nesta sessão, por provedor (estimado em caracteres ÷ 4 quando o provedor não manda o número) |
+| `/atalhos` | As teclas: Esc Esc para o agente, `!` roda no shell, Alt+Enter quebra linha… |
 | `/name <nome>` | Como o Primo te chama na saudação |
-| `/mascot primo\|fox\|cat` | Escolhe o mascote (mostra os três) |
+| `/mascot [nome\|n]` | Galeria dos 10 mascotes lado a lado (primo, fox, cat, robo, coruja, dragao, fantasma, capivara, polvo, pinguim), cada um com nome e bordão na abertura. Escolha por nome ou número. Depois de cada tarefa ele reage numa linha (`(^‿^)` pronto, `(°_°)` não terminou); `/mascot reacoes off` desliga |
 | `/config` | Mostra suas preferências e onde ficam salvas |
 | `/clear` · `/cls` | Limpa conversa / tela |
 | `/uninstall` | Remove o PrimoCode (seus projetos ficam) |
@@ -325,9 +344,18 @@ export PRIMOCODE_TOKEN="..."   # só se o servidor exigir
 
 ## Segurança
 
-Todo caminho que o modelo pede é resolvido **dentro** da pasta do projeto.
-Caminho absoluto ou com `../` é recusado — o agente não escreve fora da sua
-área de trabalho.
+Todo arquivo que o agente escreve (`write_file`, `edit_file`, `multi_edit`) é
+resolvido **dentro** da pasta do projeto. Caminho absoluto ou com `../` é
+recusado.
+
+Os **comandos** de terminal não têm essa cerca: eles rodam com as suas
+permissões. Por isso, no modo padrão (`/permissoes auto`), ele **pergunta antes
+do que não tem volta** — `rm -rf` fora do projeto ou em `~` e `/`, `sudo`,
+`git push --force`, `git reset --hard`, `git clean -fd`, `curl … | sh`, `dd`,
+`mkfs`, `npm publish`, desligar o computador. Apagar `node_modules` ou `dist`
+dentro do projeto não pergunta. A régua está em `lib/perigo.js`.
+
+Mexer no mouse e no teclado (controle do computador) sempre pede licença.
 
 ## Arquitetura
 

package/app/ansi.js

@@ -0,0 +1,55 @@
+/* ansi.js — a saída do terminal virando HTML com as cores do PrimoCode.
+ *
+ * A mesma tradução do app.js (a janela do /rc), agora num arquivo que a IDE
+ * também carrega. Só o que o PrimoCode realmente emite: cor 256 (38;5;N),
+ * negrito e reset. O resto dos códigos (mover cursor, apagar linha) é desenho
+ * de terminal e é descartado — na página quem rola é o navegador.
+ *
+ * O `estado` atravessa os pedaços: o Node corta a saída onde der, e um
+ * "\x1b[38;5;45m" pode chegar num pedaço e o texto colorido no seguinte.
+ */
+(function (raiz) {
+  "use strict";
+  var ANSI = /\x1b\[([0-9;?]*)([a-zA-Z])/g;
+
+  function fugir(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  }
+
+  function paraHtml(texto, estado) {
+    var fora = "";
+    var ultimo = 0;
+    var m;
+    ANSI.lastIndex = 0;
+    function abrir() {
+      var classes = [];
+      if (estado.cor) classes.push("c" + estado.cor);
+      if (estado.forte) classes.push("forte");
+      return classes.length ? '<span class="' + classes.join(" ") + '">' : "";
+    }
+    function fechar() { return (estado.cor || estado.forte) ? "</span>" : ""; }
+
+    while ((m = ANSI.exec(texto)) !== null) {
+      var pedaco = texto.slice(ultimo, m.index);
+      if (pedaco) fora += abrir() + fugir(pedaco) + fechar();
+      ultimo = m.index + m[0].length;
+      if (m[2] !== "m") continue;
+      var partes = m[1].split(";");
+      for (var i = 0; i < partes.length; i++) {
+        var n = partes[i];
+        if (n === "" || n === "0") { estado.cor = null; estado.forte = false; }
+        else if (n === "1") estado.forte = true;
+        else if (n === "38" && partes[i + 1] === "5") { estado.cor = partes[i + 2]; i += 2; }
+        else if (n === "39") estado.cor = null;
+        else if (n === "22") estado.forte = false;
+      }
+    }
+    var resto = texto.slice(ultimo);
+    if (resto) fora += abrir() + fugir(resto) + fechar();
+    // \r sozinho é o terminal voltando ao começo da linha para redesenhar;
+    // na página ele só deixaria um caractere invisível no meio do texto.
+    return fora.replace(/\r(?!\n)/g, "");
+  }
+
+  raiz.PrimoAnsi = { paraHtml: paraHtml, fugir: fugir };
+})(window);