rivale 0.1.3

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2026 Rivale. Todos os direitos reservados. / All Rights Reserved.
+
+Este software é proprietário e confidencial. É distribuído apenas na forma
+compilada/minificada (dist/cli.js). Nenhuma permissão é concedida para copiar,
+modificar, redistribuir, sublicenciar, fazer engenharia reversa, descompilar ou
+criar obras derivadas do código-fonte ou do artefato distribuído, no todo ou em
+parte, sem autorização prévia por escrito do detentor dos direitos autorais.
+
+This software is proprietary and confidential. It is distributed solely in
+compiled/minified form (dist/cli.js). No permission is granted to copy, modify,
+redistribute, sublicense, reverse engineer, decompile, or create derivative
+works from the source code or distributed artifact, in whole or in part,
+without the prior written consent of the copyright holder.

package/README.md

@@ -0,0 +1,121 @@
+<div align="center">
+
+# ⚔️ Rivale
+
+**Agente autônomo de código no terminal — o desafiante open source do seu editor.**
+
+Multi-agente · memória de longo prazo · MCP (local e remoto) · ferramentas de código de verdade · segurança em primeiro lugar.
+
+</div>
+
+---
+
+## O que é
+
+Rivale é um agente de programação que vive no seu terminal (e no VS Code). Ele lê, escreve e refatora código, roda comandos, pesquisa na web, dirige um browser, versiona com git e coordena **vários subagentes especializados** — tudo com controle de custo, aprovação humana e proteções de segurança embutidas.
+
+Funciona com **múltiplos provedores de LLM**: Groq, OpenAI, Gemini e DeepSeek.
+
+## Destaques
+
+- 🧠 **Multi-agente real** — modo Coordenador que delega para subagentes especializados (coder, security, tester, reviewer, researcher), execução em paralelo e *swarm debate* pra decisões difíceis.
+- 🔌 **MCP local e remoto** — conecta qualquer servidor Model Context Protocol via **stdio** (`npx`/`uvx`/`python`) ou **HTTP streamable / SSE** (endpoints remotos com auth por header).
+- 🗂️ **Ferramentas de código sérias** — ler/editar/criar arquivos, `grep`/`glob`, busca por **AST**, integração **LSP**, **git nativo** (status/diff/log/commit), tarefas em background, `run_command`, browser (Playwright), SQLite e mais.
+- 🧵 **Memória de verdade** — janela de contexto por tokens com auto-compactação, indexação do codebase e **busca semântica de código**.
+- 💸 **Teto de custo por run** — corta o loop antes de queimar dinheiro (`AGENT_MAX_USD_PER_RUN`).
+- 🔒 **Segurança em primeiro lugar** — cofre de chaves criptografado, guard de comandos, modo plan, hooks PreToolUse, proteção contra SSRF e auto-proteção do próprio código.
+- ⌨️ **UX de terminal moderna** — streaming, menção de arquivos com `@`, telas de `/config`, `/mcp`, `/compact`, atalhos configuráveis.
+- 🧩 **Extensão para VS Code** — chat no editor, aprovação in-chat, drag-and-drop de arquivos, timeline de atividade.
+
+## Instalação
+
+```bash
+npm install -g rivale
+```
+
+Requer **Node.js ≥ 18**. (Git é necessário para as ferramentas de versionamento.)
+
+## Começando
+
+```bash
+rivale                        # abre o chat interativo
+rivale "crie um scraper em python para a home do HN"   # modo one-shot
+rivale --stream "explique este repositório"
+```
+
+Dentro do chat:
+
+| Comando | O quê |
+|---|---|
+| `@arquivo` | menciona um arquivo/pasta pro contexto |
+| `/config` | provider, modelo, API key (vai pro **cofre criptografado**) |
+| `/mcp` | conecta/gerencia servidores MCP |
+| `/compact` | resume a conversa pra liberar contexto |
+| `/help` | lista tudo |
+
+## Chaves de API (cofre criptografado 🔒)
+
+Suas chaves ficam cifradas em `~/.rivale/secrets.json` (AES-256-GCM) — **nunca** em texto puro.
+
+```bash
+rivale keys set GROQ_API_KEY        # digita escondido (não vaza no histórico do shell)
+rivale keys list                    # mostra mascarado
+rivale keys import-env              # migra chaves do seu .env atual pro cofre
+```
+
+Você também pode usar variáveis de ambiente ou `~/.rivale/.env` (as chaves reais do ambiente sempre têm prioridade):
+
+```
+GROQ_API_KEY=...
+OPENAI_API_KEY=...
+GEMINI_API_KEY=...
+DEEPSEEK_API_KEY=...
+```
+
+## MCP (Model Context Protocol)
+
+Declare servidores em `.rivale/mcp.json` — stdio (local) ou remoto (URL):
+
+```json
+{
+  "mcpServers": {
+    "playwright": { "command": "npx", "args": ["-y", "@playwright/mcp@latest"] },
+    "context7":   { "command": "npx", "args": ["-y", "@upstash/context7-mcp"] },
+    "remoto": {
+      "url": "https://seu-endpoint.exemplo.com/mcp",
+      "type": "http",
+      "headers": { "Authorization": "Bearer SEU_TOKEN" }
+    }
+  }
+}
+```
+
+## Controle de custo
+
+```
+AGENT_MAX_USD_PER_RUN=0.50      # aborta a run ao atingir US$ 0,50 (0 = ilimitado)
+AGENT_MAX_TOKENS_PER_RUN=200000 # teto por tokens
+```
+
+## Segurança
+
+- **Cofre de chaves** criptografado (AES-256-GCM), fora do `.env`.
+- **Guard de comandos** — bloqueia egress de rede suspeito, escalada de privilégio e execução dinâmica, mesmo com aprovação desligada.
+- **Modo Plan** — bloqueia escrita/comandos perigosos até você aprovar o plano.
+- **Hooks PreToolUse** — intercepte/valide qualquer chamada de ferramenta.
+- **SSRF guard** — nega requisições a IPs privados/metadata de cloud.
+- **Aprovação humana** por ferramenta, com níveis configuráveis.
+
+## Requisitos
+
+- Node.js ≥ 18
+- Git (para as ferramentas de versionamento)
+- Chave de API de pelo menos um provedor
+
+---
+
+<div align="center">
+
+© 2026 Rivale — Todos os direitos reservados. Software proprietário distribuído apenas na forma compilada. Veja [LICENSE](LICENSE).
+
+</div>