primocode 10.17.1 → 11.0.0

package/LICENSES/fontes-OFL.txt

@@ -474,3 +474,98 @@ INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
 DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
 OTHER DEALINGS IN THE FONT SOFTWARE.
+
+===== Inter =====
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/LICENSES/opencode-MIT.txt

@@ -0,0 +1,24 @@
+Ideias de projeto portadas do OpenCode (https://github.com/sst/opencode), licença MIT.
+Código reescrito em JavaScript; nada foi copiado literalmente. Usado em: lib/casar.js, lib/tool/reparar-entrada.js.
+
+MIT License
+
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSES/pptxgenjs-MIT.txt

@@ -0,0 +1,31 @@
+Arquivos em vendor/pptxgenjs/: pptxgen.cjs.js (PptxGenJS 4.0.1) e jszip.min.js (JSZip 3.10.2, que embute pako).
+Uso: gerar o .pptx editável em lib/entregaveis/slides.js. carregar.js é nosso (MIT, PrimoCode).
+
+===== PptxGenJS, licença MIT =====
+The MIT License (MIT)
+
+Copyright (c) 2015-2022 Brent Ely
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+===== JSZip =====
+Dupla licença: MIT ou GPL-3.0-or-later. Usado sob os termos da MIT.
+Copyright (c) 2009-2016 Stuart Knightley, David Duponchel, Franz Buchinger, António Afonso.
+Inclui pako (MIT e Zlib), Copyright (C) 2014-2017 Vitaly Puzrin e Andrey Tupitsin.
+Texto da MIT: igual ao de PptxGenJS acima, com os titulares citados.

package/README.md

@@ -1,4 +1,4 @@
-# PrimoCode v10.17.1
+# PrimoCode v11.0.0
 
 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 v10.17.1
+ ▐▛███▜▌   Primo Code v11.0.0
 ▝▜█████▛▘  Bem-vindo de volta, Joel
   ▘▘ ▝▝    ~/primocode  · /dir <pasta> muda
 ```
@@ -21,6 +21,13 @@ veja `/mascot` e `/name`.
 
 `/voice` abre a tela do Primo: agenda, clima, música, máquina e um robô 3D no centro. Diga **"Primo"** para chamar; ele fala frase a frase e você pode interromper. Na primeira vez cria `~/.primocode/voz-venv` sozinho (`primocode doutor` mostra o estado). Robô offline: `"robo":"expressive"` em `~/.primocode/voz.json`.
 
+## Novidades da 11.0
+
+- **O placar:** o PrimoCode aprende, neste computador, qual modelo grátis acerta mais em cada tipo de tarefa e passa a preferir esse (`/placar`). Nada sai da máquina.
+- **Mais ferramentas:** `buscar_web`, `ler_url`, `perguntar`, `agentes_buscar` e `capacidade_buscar` (64 no total), diagnóstico depois de cada edição e `run_shell` em segundo plano.
+- **Mais agentes:** 110 especialistas e 204 capacidades, `/review` em duas passadas, `/pesquisar` com fontes, `/testar-app`, `--tentativas N`, `primocode preview` e `primocode review --pr N`.
+- **Motion, editor e documentos:** o kit de peças soltas, a câmera viva no editor de vídeo e o deck de ponta a ponta (.pptx e PDF). Detalhes em `RELEASE-11.0.md`.
+
 ## Novidades da 10.14
 
 - **Vídeo de motion de ponta a ponta** (EffectCraft, 68 receitas, voz, trilha, prévia e editor por comando). Detalhes no `CHANGELOG.md`.
@@ -132,9 +139,9 @@ Tabela completa, com `arquivo:linha`, em [docs/paridade.md](docs/paridade.md). O
 | | Claude Code | Codex | PrimoCode |
 |---|---|---|---|
 | Hooks antes/depois de ferramenta | tem | parcial | tem (`~/.primocode/hooks.json`) |
-| Modo só leitura (plan) | tem | read-only | tem (`/permissoes plano`) |
+| Modo só leitura (plan) | tem | read-only | tem (`/perms plano`) |
 | Headless (`-p`, JSON, stdin) | tem | `codex exec` | tem |
-| Desfazer por pedido | `/rewind` | usa git | tem (`/desfazer`) |
+| Desfazer por pedido | `/rewind` | usa git | tem (`/undo`) |
 | MCP stdio, HTTP, OAuth | tem | tem | tem |
 | Sandbox de SO | opcional | tem | não |
 | Worktrees | tem | não | não |
@@ -272,6 +279,11 @@ mais.
 | `write_todos` | Plano de tarefas da sessão, visível no terminal |
 | `open_in_browser` | Abre HTML ou URL no navegador padrão |
 | `spawn_agent` | Delega uma sub-tarefa a outro agente |
+| `buscar_web` · `ler_url` | Busca na internet (links com trecho) e lê uma página em markdown, sem chave |
+| `perguntar` | Pergunta com 2 a 4 opções, só quando está bloqueado |
+| `agentes_buscar` · `capacidade_buscar` | Acha o especialista (110) ou a receita pronta (204) certa |
+
+Depois de cada edição, o verificador mais barato da linguagem roda e o erro volta junto. A lista completa: `/help all`.
 
 O `edit_file` é rigoroso de propósito: se o trecho não existe, ou aparece mais
 de uma vez sem `replace_all`, ele **recusa** e devolve as linhas reais do
@@ -406,34 +418,52 @@ primocode --worktree <nome>            # worktree ../<repo>-<nome> em branch nov
 | `/worktree <nome>` | Cria `../<repo>-<nome>` numa branch nova e entra nele (só em repo git) |
 | `/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 |
+| `/projects [n]` | Os projetos de `~/primocode` do mais recente para o mais antigo, com quando mexeu e o tamanho. `/projects 2` entra no segundo (o `/project` sem nome mostra a mesma lista) |
+| `/new <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 |
+| `/new` sem nada | Pra quem nunca programou: 3 perguntas (o que criar, pra quem, onde abre) e o primeiro app sai. Sem ideia? Enter mostra 6 ideias pra escolher pelo número |
 | `/mode primocode\|chat\|auto` | Alterna o modo (fica guardado) |
 | `/voice` | Modo voz: você fala, e o que disse entra como se tivesse digitado (na fila, ou como recado no meio da tarefa). A resposta sai em voz alta, resumida; falar por cima corta. `/voice parar` desliga |
-| `/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 |
+| `/commands` | Seus comandos: um `.md` em `~/.primocode/comandos/` (ou `<projeto>/.primocode/comandos/`) vira `/nome`, e `$ARGUMENTOS` recebe o que vem depois. Já vêm `/review`, `/explain` e `/ship`. `/commands novo <nome>` cria um |
+| `/skills` · `/skills store` | 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í |
-| `/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) |
+| `/perms 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 |
+| `/detach` · `/attach` sem nada | Remove / lista anexos |
+| `/attach <url>` | Anexa o texto de uma página ao próximo pedido (sem menu, rodapé e script). `@https://…` no meio do pedido faz o mesmo, só pra aquele pedido |
+| `/help all` | Lista as 64 ferramentas que ele sabe usar, por grupo |
+| `/placar` | Qual modelo grátis acerta mais em cada tipo de tarefa, aprendido neste computador (`/placar zerar` apaga) |
+| `/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. `/undo lista` mostra os pedidos e quantos arquivos cada um mudou · `/undo N` volta os N últimos |
+| `/redo` | Volta o que o último `/undo` desfez — enquanto nenhum pedido novo mexeu nos arquivos |
+| `/check` | Acha sozinho como testar o projeto (os testes, senão o build, senão o lint) e responde em português: "Funcionou" ou "Não funcionou", com as linhas que explicam o erro. Se falhou, pergunta se a IA conserta. Se funcionou, marca o ponto como "funcionava" (aparece com ✓ no `/undo lista`) |
+| `/restore` | Volta o projeto para o último ponto que o `/check` marcou como funcionando, desfazendo os pedidos feitos depois. Mostra o que vai mudar antes de confirmar, e o `/redo` ainda devolve |
+| `/show` · `/show 30` · `/show parar` | Abre o app no celular de quem está no mesmo Wi-Fi, com um link que tem token e prazo (60 min, ou o que você disser). Não publica nada: o link morre no prazo ou quando o PrimoCode fecha, e `.env`, `.git` e `node_modules` nunca saem |
+| `/howto` | Escreve (ou atualiza) o bloco "Como rodar" do `PRIMO.md`: instalar, abrir, conferir e mostrar, tirado do `package.json` ou da página, sem modelo. Rodar de novo troca o bloco, nunca duplica |
+| `/rule` [texto \| tirar N] | Guarda uma regra ("nunca mexa no logo") no topo do `PRIMO.md`, que entra em todo pedido: ela não some quando a conversa é resumida. Sem texto, lista; `tirar N` tira uma. O `/init` reescreve o `PRIMO.md` e as regras voltam pro topo |
+| `/port` | "O app não abre": diz qual porta o projeto declara (`package.json`, `vite.config`, a linha `PORT=` do `.env`, `server.js`), qual responde de verdade em `localhost` (com o título da página) e o endereço certo. Reconhece o AirPlay do Mac na 5000. O `/open` aponta pra ele quando não acha servidor |
+| `/undo fora` | Quando o pedido cita arquivos ("arruma o `login.js`") e o agente mexe em outros, o fim do pedido diz quais. `/undo fora` volta só esses, e o que você pediu fica. Pedido que não cita arquivo não gera aviso |
+| `/map` | O que tem no projeto, em português: as páginas, o estilo, a lógica e os dados, quem usa quem, e o arquivo que alguém pede e não existe (o `index.html` que puxa um `script.js` que nunca nasceu) |
+| `/changes` | O que mudou no projeto, em português: arquivos novos, editados e apagados, e quantas linhas a mais e a menos (contra o último commit; fora do git, o último pedido) |
+| `/timeline` | Abre no navegador a história do projeto: um cartão por pedido, com o que mudou, o selo "funcionava" e o comando pronto (`/undo N` ou `/restore`) pra voltar até ali. Também `/historia` |
+| `/taste` · `/taste tirar N` | O seu gosto de motion: os estilos que você escolheu, os vídeos de referência (numerados) e pra onde isso inclina o próximo motion. `refazer` abre a tela de novo, `apagar` zera. `salvar <nome>` guarda o gosto de agora (um por cliente), `usar <nome>` troca, `estilos` lista. `força pouco/médio/muito` diz quanto as referências pesam, e `provar [assunto]` mostra o que o gosto muda em 30 motions, sem renderizar |
+| `/taste referencias` | Abre a tela do gosto pra soltar os motions que você curtiu: o PrimoCode mede cada um (ritmo, movimento, cores, texto), mostra o que entendeu e você corrige antes de salvar |
+| `/map 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 |
-| `/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 |
+| `/open` sem nada | Abre o projeto atual no navegador: o servidor dele, se estiver de pé, ou a `index.html` (o `/open` sem nada faz o mesmo) |
+| `/copy` | Copia a última resposta para a área de transferência (pbcopy, clip, wl-copy/xclip/xsel) |
+| `/export` | Salva a conversa num `.md` em `~/primocode/conversas/`, pra guardar ou mandar pra alguém. Chave e senha saem trocadas por `[chave escondida]`, e não há link público |
+| `/history [termo]` | Procura nos seus pedidos guardados nesta máquina (`~/.primocode/history.jsonl`), do mais recente. As conversas inteiras da conta ficam no `/chats` |
+| `/doctor 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… |
+| `/usage` | Primeiro em linguagem simples (quantas páginas a IA leu e escreveu, e quem paga: o plano ou a sua chave), depois os tokens por provedor (estimado em caracteres ÷ 4 quando o provedor não manda o número) |
+| `/tasks` | O que roda em segundo plano (servidor de dev, watch), com o endereço · `/tasks rodar <cmd>` sobe algo sem travar · `/tasks abrir` abre no navegador · `/tasks parar <id>`. A barra mostra `● de pé :porta`, e ao sair nada fica órfão |
+| `/keys` | 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 [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 |
@@ -468,7 +498,7 @@ 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
+permissões. Por isso, no modo padrão (`/perms 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`

package/agentes/acessibilidade.md

@@ -0,0 +1,10 @@
+---
+id: acessibilidade
+nome: Acessibilidade
+area: frontend
+quando_usar: teclado, leitor de tela, contraste e semântica
+palavras: acessibilidade a11y aria contraste teclado foco wcag semantica leitor alt label
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em ACESSIBILIDADE (WCAG 2.2 AA). Comece pelo HTML semântico (button é button, nav, main, h1 único, label ligado ao input) antes de qualquer aria. Cheque: tudo operável só com teclado e com foco visível; contraste mínimo 4.5:1 em texto; alt em imagem informativa e vazio em decorativa; erro de formulário anunciado; alvo de toque ≥ 44px; prefers-reduced-motion respeitado. Nunca coloque role/aria que contradiga a semântica, nem remova outline sem substituto. Prova: navegue com Tab pela página inteira, rode axe/Lighthouse se houver e cole as violações antes e depois.

package/agentes/ambiente.md

@@ -0,0 +1,10 @@
+---
+id: ambiente
+nome: Ambiente
+area: devops
+quando_usar: instalar dependências, configurar e fazer rodar
+palavras: instalar dependencias npm pip brew ffmpeg docker venv setup configurar node_modules
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em AMBIENTE — dependências, instalação e execução. Descubra o que a máquina tem (node --version, python3 --version, qual gerenciador: npm/pnpm/yarn, pip/uv, brew/apt/winget) antes de mandar instalar; use o gerenciador que o projeto já usa (o lockfile diz). Instale só o que a tarefa pede, com a versão fixada no manifesto (package.json, requirements.txt), nunca global sem motivo. Se o comando fica de pé (servidor, watch), use run_background e leia com background_output para conferir que subiu; run_in_new_terminal só se a PESSOA quer ver o terminal. O resto em run_shell, lendo a saída inteira — "warning" não é erro, "ERR!" é. Falta algo no sistema (ffmpeg, git, python)? Instale pelo gerenciador do sistema e confira com --version. PROVE: o comando de rodar funcionando, e um LEIA.md com instalar e rodar que qualquer um siga.

package/agentes/api.md

@@ -0,0 +1,10 @@
+---
+id: api
+nome: Desenho de API REST
+area: backend
+quando_usar: contratos HTTP, status, paginação, erros e versionamento
+palavras: api rest http json openapi status paginacao contrato swagger endpoint versionamento
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em DESENHO DE API. Leia as rotas existentes e siga o padrão (nomes, envelope, erro). Recurso no plural, verbo vem do método HTTP; status certo (201 criou, 204 sem corpo, 400 entrada ruim, 401 sem login, 403 sem permissão, 404, 409 conflito, 422 validação); erro sempre no mesmo formato com código estável e mensagem útil. Lista paginada e ordenada com limite máximo; PUT/DELETE idempotente. Nunca devolva campo interno (senha, hash, id de outro tenant), nem mude contrato sem versão. Prova: curl de cada rota com caso feliz e caso de erro, colando status e corpo; atualize o OpenAPI se existir.

package/agentes/backend.md

@@ -0,0 +1,10 @@
+---
+id: backend
+nome: Backend
+area: backend
+quando_usar: API, servidor, dados no servidor e autenticação
+palavras: api servidor rotas endpoint autenticacao webhook middleware sessao token
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em BACKEND. Leia o que existe (rotas, modelos, como o projeto trata erro e configuração) e siga o padrão dele. Regras: valide TODA entrada na borda (tipo, tamanho, faixa) e responda erro com o código HTTP certo e uma mensagem que diz o que corrigir; nunca segredo em código — variável de ambiente, e o .env.example atualizado; nunca concatene entrada do usuário em SQL, comando de shell ou caminho de arquivo; trate o que falha (rede, disco, dado ausente) sem catch vazio; separe rota, regra de negócio e acesso a dados; registre o que importa, sem dado pessoal no log. PROVE: rode o servidor ou o teste com run_shell e mostre a requisição respondendo.

package/agentes/copy.md

@@ -0,0 +1,10 @@
+---
+id: copy
+nome: Copy e redação
+area: escrita
+quando_usar: texto de página, botão, e-mail, anúncio e microtexto
+palavras: copy copywriting texto redacao headline titulo cta email anuncio landing marca tom
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em COPY. Antes de escrever, diga: para quem, o que a pessoa faz depois de ler, e qual a única promessa. Título entrega o benefício concreto (número, prazo, resultado), não o nome do produto. Frase curta, verbo ativo, palavra do cliente, nada de "solução inovadora" ou "líder de mercado". Botão diz o que acontece ("Criar minha conta"). Nunca invente dado, depoimento ou garantia que o cliente não deu. Dê 3 variações do título com a lógica de cada. Prova: releia em voz alta cortando 20% das palavras, e cada afirmação rastreável a algo que o usuário disse.

package/agentes/css-layout.md

@@ -0,0 +1,10 @@
+---
+id: css-layout
+nome: CSS e layout
+area: frontend
+quando_usar: grid, flexbox, responsividade e quebra de layout
+palavras: quebra celular 390px css layout grid flexbox responsivo mobile media query tailwind alinhamento overflow z-index sass
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em CSS E LAYOUT. Leia a folha existente e siga tokens e unidades. Desenhe mobile primeiro (390px), amplie com min-width. Grid para a página em duas dimensões, flex para uma linha; gap em vez de margem entre irmãos; clamp() para tipografia fluida; min-width: 0 em filho de flex que estoura. Nunca use !important, altura fixa em texto, z-index aleatório nem px para fonte. Bug de layout: inspecione o elemento, ache a regra que vence, conserte na origem. Prova: screenshot em 390px e 1280px sem rolagem horizontal, com os dois lados conferidos.

package/agentes/dados.md

@@ -0,0 +1,10 @@
+---
+id: dados
+nome: Dados
+area: dados
+quando_usar: CSV, planilha, análise, modelagem e transformação de dados
+palavras: csv planilha json dataset analise grafico pandas etl estatistica tabela
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em DADOS. Antes de transformar, OLHE os dados de verdade (primeiras linhas, contagem, tipos, nulos, duplicatas) e escreva o que achou; hipótese sobre dado sem olhar é o erro mais caro desta área. Modele com nomes que dizem o que a coluna É, tipos certos (data é data, número é número), chaves e unicidade explícitas. Scripts idempotentes: rodar duas vezes dá o mesmo resultado. Toda conta que vai para tela ou relatório vem com a fórmula ao lado e uma conferência (o total bate com a soma das partes?). Planilha ou tabela para o usuário sai pelo Studio (grade), não por CSV solto, salvo pedido. Nunca invente número: o que não está nos dados fica em branco, e dito. PROVE: mostre a contagem antes e depois.

package/agentes/depuracao.md

@@ -0,0 +1,10 @@
+---
+id: depuracao
+nome: Depuração
+area: programacao
+quando_usar: bug, erro, crash ou comportamento inesperado cuja causa não é óbvia
+palavras: bug erro debug depurar crash excecao stacktrace falha travando quebrou reproduzir causa
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: opus
+---
+Você é o especialista em DEPURAÇÃO. Ordem fixa: 1) REPRODUZIR com o menor comando que falha e colar a saída; sem reprodução não há conserto. 2) LER o erro e a pilha inteiros, de cima a baixo. 3) HIPÓTESE escrita, com o que a refutaria; bisect (git bisect, comentar metade) em vez de adivinhar. 4) CAUSA RAIZ, não sintoma: pergunte "por que" até um fato. 5) Consertar uma coisa só. Nunca mude vários pontos de uma vez, nem silencie o erro, nem culpe o framework antes de excluir o seu código. Prova: o mesmo comando do passo 1 agora passa, mais um teste que falharia sem o conserto.

package/agentes/design.md

@@ -0,0 +1,10 @@
+---
+id: design
+nome: Design visual
+area: design
+quando_usar: identidade visual: paleta, tipografia, espaço, hierarquia
+palavras: paleta tipografia identidade marca logo cores fontes icones tema estetica
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: opus
+---
+Você é o especialista em DESIGN VISUAL. Sua entrega é uma identidade que só este projeto poderia ter, escrita em tokens de CSS (cor, tipografia, espaço, raio, sombra) e aplicada. Decida a partir do assunto: quem usa, em que tela, com que sentimento. Uma paleta de 4 a 6 cores com valores (uma dominante, uma de destaque, neutros com leve viés da dominante) e um par de fontes com hierarquia clara (tamanhos numa escala, pesos com intenção). Fuja do genérico: gradiente roxo-azul, cinza puro, tudo centralizado, sombra em todo cartão, emoji como ícone. Espaço em branco é design; alinhe a uma grade. Ícone é SVG desenhado por você, no traço da marca, nunca emoji nem imagem baixada. PROVE: abra a página e descreva o que se vê em 390px e em 1280px.

package/agentes/docs.md

@@ -0,0 +1,10 @@
+---
+id: docs
+nome: Documentação técnica
+area: escrita
+quando_usar: README, guias, comentários de API e changelog
+palavras: documentacao docs readme guia tutorial changelog comentario jsdoc docstring
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em DOCUMENTAÇÃO TÉCNICA. O leitor chega com pressa e um objetivo: o README abre com o que é, em uma frase, e o comando para rodar em 30 segundos. Toda instrução foi EXECUTADA por você; comando que você não rodou leva [não rodei]. Exemplo copiável e completo, com a saída esperada. Estrutura: o que é, instalar, usar, configurar, problemas comuns. Nunca documente o que o código não faz, nem copie o código em prosa, nem deixe link sem checar. Prova: siga o seu próprio guia do zero numa pasta limpa e cole onde travou.

package/agentes/frontend.md

@@ -0,0 +1,10 @@
+---
+id: frontend
+nome: Frontend
+area: frontend
+quando_usar: tela, HTML, CSS e o JavaScript do navegador
+palavras: html css javascript navegador tela interface componente layout botao pagina formulario
+ferramentas: read_file grep edit_file run_shell
+modelo_sugerido: sonnet
+---
+Você é o especialista em FRONTEND. Antes de escrever, leia o HTML/CSS que já existe e siga o padrão dele (nomes, unidades, como a paleta é declarada). O que separa interface de rascunho: HTML semântico (header/nav/main/section/button — nunca div clicável); CSS com variáveis para cor, espaço e tipo, escala de espaço consistente (4/8/12/16/24/32), grid/flex com gap em vez de margin solta; responsivo de 360px a 1440px sem rolagem horizontal; todo controle com hover, focus-visible e disabled; texto real, nunca lorem; contraste legível (4.5:1). JS sem framework quando vanilla resolve; nada de dependência nova sem o projeto já usar. PROVE antes de terminar: abra a página (browser_open) e leia o console — erro no console é tarefa inacabada.

package/agentes/geral/capacidades/arquivos.json

@@ -0,0 +1,132 @@
+{
+ "grupo": "arquivos",
+ "descricao": "Arquivos e documentos",
+ "itens": [
+  {
+   "id": "arq-ler-pdf",
+   "nome": "Ler PDF",
+   "receita": "pdftotext -layout arq.pdf - ; para escaneado, OCR (tesseract)",
+   "prova": "texto extraído amostrado"
+  },
+  {
+   "id": "arq-imagem-converter",
+   "nome": "Converter/redimensionar imagem",
+   "receita": "magick in.png -resize 1200x out.webp; sips no macOS",
+   "prova": "tamanho e dimensão conferidos"
+  },
+  {
+   "id": "arq-video-ffmpeg",
+   "nome": "Cortar/converter vídeo",
+   "receita": "ffmpeg -ss ini -to fim -i in.mp4 -c copy out.mp4; reencode: -c:v libx264 -crf 23",
+   "prova": "ffprobe da saída"
+  },
+  {
+   "id": "arq-audio-extrair",
+   "nome": "Extrair áudio",
+   "receita": "ffmpeg -i v.mp4 -vn -acodec libmp3lame a.mp3",
+   "prova": "duração igual à do vídeo"
+  },
+  {
+   "id": "arq-renomear-lote",
+   "nome": "Renomear em lote",
+   "receita": "simule antes (echo mv ...); padrão claro; sem sobrescrever",
+   "prova": "lista antes e depois"
+  },
+  {
+   "id": "arq-organizar",
+   "nome": "Organizar pasta",
+   "receita": "proponha a estrutura; mova (não apague); registre o que foi onde",
+   "prova": "árvore final"
+  },
+  {
+   "id": "arq-duplicados",
+   "nome": "Achar arquivos iguais",
+   "receita": "compare por hash (shasum), não por nome",
+   "prova": "grupos de hash iguais listados"
+  },
+  {
+   "id": "arq-docx",
+   "nome": "Ler/gerar Word",
+   "receita": "pandoc a.docx -t markdown; gerar: pandoc a.md -o a.docx",
+   "prova": "arquivo abre"
+  },
+  {
+   "id": "arq-xlsx",
+   "nome": "Ler/gerar Excel",
+   "receita": "pandas.read_excel / openpyxl; fórmulas só com openpyxl",
+   "prova": "abrir e conferir células"
+  },
+  {
+   "id": "arq-markdown-pdf",
+   "nome": "Markdown para PDF",
+   "receita": "pandoc a.md -o a.pdf (ou navegador headless imprimindo HTML)",
+   "prova": "PDF abre e páginas conferidas"
+  },
+  {
+   "id": "arq-zip-seguro",
+   "nome": "Descompactar com segurança",
+   "receita": "unzip -l antes; extraia numa pasta nova; cuidado com ../ nos caminhos",
+   "prova": "só arquivos esperados"
+  },
+  {
+   "id": "arq-encoding",
+   "nome": "Descobrir encoding",
+   "receita": "file -I arq; iconv -f latin1 -t utf-8",
+   "prova": "acentos corretos"
+  },
+  {
+   "id": "arq-json-editar",
+   "nome": "Editar JSON",
+   "receita": "jq '.a.b = 1' in.json > out.json; nunca sed em JSON",
+   "prova": "jq . valida"
+  },
+  {
+   "id": "arq-yaml",
+   "nome": "Validar YAML",
+   "receita": "python3 -c \"import yaml,sys;yaml.safe_load(open(sys.argv[1]))\" arq",
+   "prova": "sem exceção"
+  },
+  {
+   "id": "arq-env",
+   "nome": "Arquivo .env",
+   "receita": "nunca no git; .env.example com chaves vazias; carregue na entrada",
+   "prova": ".gitignore tem .env"
+  },
+  {
+   "id": "arq-log-grande",
+   "nome": "Ler log gigante",
+   "receita": "tail -n 2000; rg -c por tipo; rg -C em torno do erro",
+   "prova": "erro e contexto isolados"
+  },
+  {
+   "id": "arq-ocr-imagem",
+   "nome": "Texto de imagem",
+   "receita": "tesseract img.png - -l por+eng",
+   "prova": "texto amostrado"
+  },
+  {
+   "id": "arq-screenshot",
+   "nome": "Tirar print de página",
+   "receita": "navegador headless (playwright screenshot URL arq.png) em 390 e 1280",
+   "prova": "arquivos png vistos"
+  },
+  {
+   "id": "arq-svg",
+   "nome": "Otimizar SVG",
+   "receita": "svgo in.svg -o out.svg; viewBox presente; sem script",
+   "prova": "renderiza igual"
+  },
+  {
+   "id": "arq-hash",
+   "nome": "Conferir integridade",
+   "receita": "shasum -a 256 arq; compare com o publicado",
+   "prova": "hashes iguais"
+  },
+  {
+   "id": "arq-backup",
+   "nome": "Backup rápido",
+   "receita": "rsync -a origem/ destino/; teste restaurar um arquivo",
+   "prova": "arquivo restaurado abre"
+  }
+ ]
+}