primocode 7.0.3 → 7.2.0

package/README.md

@@ -1,129 +1,131 @@
-# PrimoCode v6.0
+# PrimoCode v7.1.0
 
-**AI coding companion** brasileiro no estilo **Claude Code**. CLI interativa minimalista e poderosa, com streaming, comandos slash, suporte a arquivos anexados, execução de shell e conselho multi-agente (Arquiteto → Engenheiro → Revisor).
+Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
+Cria arquivos de verdade, roda comandos, abre o navegador — e lembra do que fez
+entre uma sessão e outra.
 
-**Novidades v6.0:**
-- 🎨 Interface estilo Claude Code — minimalista e elegante
-- ⚡ Auto-instalação de Node.js quando não detectado (Y/n)
-- 🚀 Pipeline de qualidade máxima com 3 IAs
-- 🛠️ Modo Act com tool-calling nativo (write_file, run_shell, browser_*)
-
-## Instalação rápida
-
-### Linux / macOS / WSL
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/ConectaPrimoAI/primocode/main/install.sh | bash
 ```
-
-### Windows (CMD ou PowerShell)
-
-```cmd
-curl -fsSL https://raw.githubusercontent.com/ConectaPrimoAI/primocode/main/install.cmd -o install.cmd && install.cmd
+    ╷
+  ╭─┴─╮   PrimoCode
+  │◕ ◕│   v7.1.0
+  ╰───╯   projeto: jogo-de-carro
 ```
 
-**Se não tiver Node.js:** O instalador pergunta se deseja instalar automaticamente. Digite `Y` para sim.
-
-### Manual (qualquer SO)
+## Instalação
 
 ```bash
 git clone https://github.com/ConectaPrimoAI/primocode.git
 cd primocode
-npm install
 npm link          # registra 'primocode' globalmente
 primocode
 ```
 
-Requer **Node.js 18.17+**.
+Requer **Node.js 18.17+**. O CLI não tem dependências — só a stdlib do Node.
 
-## Uso
+## Como funciona
 
-### Modo interativo
+Todo trabalho acontece dentro de uma **pasta de projeto**, em `~/primocode/`:
 
-```bash
-primocode
+```
+~/primocode/
+├── memory-geral.md          <- sobre você: nome, preferências, convenções
+├── jogo-de-carro/
+│   ├── memory.md            <- o que este projeto é e o que já foi decidido
+│   ├── index.html
+│   └── src/game.js
+└── site-de-vendas/
+    ├── memory.md
+    └── ...
 ```
 
-### Modo one-shot
+Ao receber o primeiro pedido da sessão, o PrimoCode deriva um nome de projeto
+do que você pediu. Se já existir um projeto parecido, ele **pergunta** antes de
+criar pasta nova:
+
+```
+Primo Code ❯ faça um jogo de carro 2D
+
+  Já existe um projeto parecido: jogo-de-carro
+? Continuar nele? (S/n)
+```
+
+Os dois arquivos de memória são lidos no começo de cada tarefa e atualizados no
+fim. É por isso que a IA não esquece o projeto entre sessões.
+
+## Modos
+
+| Modo | O que faz |
+|---|---|
+| **Primo Code** (padrão) | Agente completo — cria arquivos, roda comandos, abre o navegador |
+| **Chat** | Conversa pura, sem tools |
+
+Alterne com `/mode primocode` ou `/mode chat`.
+
+## Uso
 
 ```bash
-primocode "escreva um endpoint express /users em node"
-primocode --agent "refatore este código pra funcional"
-primocode -f app.js "por que este código está com bug?"
+primocode                              # interativo
+primocode "crie um jogo de carro"      # one-shot
+primocode -f app.js "onde está o bug?" # com arquivo anexado
 ```
 
-### Comandos slash (dentro do modo interativo)
+## Comandos
 
 | Comando | Descrição |
 |---|---|
-| `/help` | Ajuda |
-| `/mode normal\|agent` | Alterna modo de resposta |
+| `/project` | Lista projetos. `/project <nome>` cria ou entra em um |
+| `/mode primocode\|chat` | Alterna o modo |
 | `/model main\|fast` | main = llama-3.3-70b, fast = llama-3.1-8b |
-| `/attach <arquivo>` | Anexa arquivo ao próximo prompt |
-| `/detach` | Remove anexos |
-| `/files` | Lista anexos |
-| `/tree [profundidade]` | Árvore do diretório |
-| `/read <arquivo>` | Exibe conteúdo |
-| `/write <arquivo>` | Salva a última resposta |
-| `/apply` | Aplica todos os blocos de código com hint `// filename: xxx` |
-| `/run <cmd>` | Executa shell local |
-| `/status` | Health check do server |
-| `/clear` | Limpa histórico |
-| `/cls` | Limpa tela |
+| `/attach <arquivo>` | Anexa arquivo ao próximo pedido |
+| `/detach` · `/files` | Remove / lista anexos |
+| `/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 |
+| `/status` | Health check do servidor |
+| `/clear` · `/cls` | Limpa conversa / tela |
+| `/uninstall` | Remove o PrimoCode (seus projetos ficam) |
 | `/exit` | Sair |
 
 ## Configuração
 
-Config em `~/.primocode/config.json`:
+`~/.primocode/config.json`:
 
 ```json
 {
   "server": "https://primocode-server.onrender.com",
-  "model": "main"
+  "model": "main",
+  "token": null
 }
 ```
 
-Ou por variável de ambiente:
+Ou por variável de ambiente — elas têm prioridade:
 
 ```bash
 export PRIMOCODE_SERVER="https://primocode-server.onrender.com"
 export PRIMOCODE_MODEL="main"
+export PRIMOCODE_TOKEN="..."   # só se o servidor exigir
 ```
 
-## Modo Agente (conselho de 3 IAs)
-
-Ative com `--agent` ou `/mode agent`. Roda 3 chamadas encadeadas:
-
-1. **Arquiteto** — desenha a estrutura, sem código.
-2. **Engenheiro** — implementa seguindo o plano.
-3. **Revisor** — consolida, corrige, entrega versão final limpa.
-
-Cada passo é transmitido em tempo real (streaming).
-
-## Modo Act (autônomo com tools)
-
-O modo padrão. A IA pode:
-- Criar/editar arquivos (`write_file`)
-- Ler arquivos (`read_file`)
-- Listar diretórios (`list_dir`)
-- Executar comandos shell (`run_shell`)
-- Abrir terminal novo (`run_in_new_terminal`)
-- Controlar o navegador (`browser_*`)
-- Abrir páginas no browser (`open_in_browser`)
+## Segurança
 
-Tudo sem nunca colar código no chat — apenas resultados.
+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.
 
 ## Arquitetura
 
 ```
-┌────────────────┐   HTTPS/SSE    ┌───────────────────┐    HTTPS   ┌──────────┐
-│  primocode CLI │ ─────────────► │  primocode-server │ ─────────► │  Groq    │
-│  (seu terminal)│ ◄─────────────  │  (Render)         │ ◄───────── │  API     │
-└────────────────┘   streaming    └───────────────────┘            └──────────┘
+┌────────────────┐   HTTPS/SSE    ┌───────────────────┐   HTTPS   ┌──────────┐
+│  primocode CLI │ ─────────────► │  primocode-server │ ────────► │   Groq   │
+│  (seu terminal)│ ◄───────────── │     (Render)      │ ◄──────── │   API    │
+└────────────────┘                └───────────────────┘           └──────────┘
+     executa as tools                monta o prompt
+     localmente                      e fala com o modelo
 ```
 
-- CLI: zero dependências (só stdlib do Node).
-- Server: Express + `groq-sdk`, streaming SSE.
+As tools rodam **no seu computador** — o servidor nunca toca nos seus arquivos.
+Ele decide o que fazer; o CLI faz e devolve o resultado.
 
 ## Licença