implementado graphify.sh

TOOLS.md

@@ -115,6 +115,17 @@ Este documento lista ferramentas de linha de comando (CLI) e utilitários que ot
 - **Por que ajuda as IAs e Operadores:** Previne o inchaço (*bloat*) do Git da Wiki desacoplando binários pesados (PDFs, imagens em alta resolução, vídeos, capturas de tela e anexos), gerando links e snippets Markdown prontos para inclusão imediata na documentação.
 - **Uso:** `sh .agent/scripts/upload-paiol-wiki.sh <caminho-do-arquivo> <slug-funcionalidade-ou-pagina> [modulo-override]`
 
+### graphify.sh (`.agent/scripts/graphify.sh`)
+- **Descrição:** Utilitário canônico de Grafo de Conhecimento (*Knowledge Graph*) do código-fonte baseado em `@sentropic/graphify`.
+- **Por que ajuda as IAs:** Permite que o comando `/plano` e os agentes localizem símbolos, mapeiem dependências entre pacotes e calculem o raio de impacto em cascata (*Blast Radius*) em segundos sem varreduras cegas. Instala automaticamente o binário via Bun (`bun i -g @sentropic/graphify`) caso não exista na máquina, atualiza o `.gitignore` (`.graphify/`, `.engram/`, `graphify-out/`) e gera o grafo sob demanda (`ensure`).
+- **Uso:**
+  - `bash .agent/scripts/graphify.sh update` (reconstrói/atualiza o grafo AST)
+  - `bash .agent/scripts/graphify.sh ensure` (garante instalação, `.gitignore` e grafo existente)
+  - `bash .agent/scripts/graphify.sh query "<termo>" [budget]` (busca nós e arquivos no grafo)
+  - `bash .agent/scripts/graphify.sh explain "<simbolo-ou-arquivo>"` (detalha conexões e imports)
+  - `bash .agent/scripts/graphify.sh impact <arq1> [arq2...]` (calcula raio de impacto e lacunas de testes via `review-delta`)
+  - `bash .agent/scripts/graphify.sh summary` (exibe principais hubs e comunidades do projeto)
+
 ---
 
 ## 8. Instalação Rápida (Copia e Cola)
@@ -131,8 +142,8 @@ sudo apt-get install -y ripgrep fd-find jq shellcheck bat tree eza httpie gh
 # 2. Instalar ferramentas em Node
 npm install -g @ast-grep/cli @biomejs/biome
 
-# 3. Instalar automação de navegador para IA (visível com --headed)
-bun i -g agent-browser && agent-browser install
+# 3. Instalar automação de navegador e Grafo de Conhecimento para IA via Bun
+bun i -g agent-browser @sentropic/graphify && agent-browser install
 
 # 4. Instalar yq via snap 
 sudo snap install yq
@@ -144,5 +155,5 @@ sudo snap install yq
 # Instalar utilitários essenciais
 brew install ripgrep fd ast-grep jq yq shellcheck bat tree eza httpie gh
 npm install -g @biomejs/biome
-bun i -g agent-browser && agent-browser install
+bun i -g agent-browser @sentropic/graphify && agent-browser install
 ```