sauron-cli 1.2.0 → 1.4.0

package/README.md

@@ -20,17 +20,51 @@ Para inicializar o Sauron CLI no seu projeto, basta rodar o comando abaixo no te
 npx sauron-cli init
 ```
 
-## Comandos (MVP)
+## Comandos
 
 ### `sauron init`
 
-Inicializa o Sauron Memory System no projeto atual.
-Ele copia passivamente toda a estrutura base (templates de instrução e JSON de mapa mental) para o diretório raiz do usuário.
+Inicializa o Sauron Memory System no projeto atual de forma inteligente.
+O comando executa uma **varredura heurística não-bloqueante** ($O(1)$) na raiz do repositório para detectar de forma autônoma a linguagem primária, frameworks, bancos de dados, gerenciadores de pacotes e ferramentas de IA ativas (Cursor, Windsurf, Aider, Antigravity).
+
+Durante o onboarding interativo, as perguntas são pré-populadas de forma inteligente com as informações detectadas. Ao concluir, o Sauron realiza a **injeção automática de receitas de Wiki** (Wiki Recipes) personalizadas para a sua stack tecnológica em `.sauron/wiki/standards/` (ex. TypeScript, Next.js, React, Tailwind CSS, PostgreSQL) de forma idempotente e não-destrutiva, gerando o manifesto dinâmico `AGENTS.md` e as regras de governança locais das IAs.
 
 ```bash
+# Inicialização interativa padrão
 sauron init
+
+# Inicialização silenciosa/não-interativa programática
+sauron init -y --conflict ours
+
+# Saída estruturada em formato JSON
+sauron init -y --json
+```
+*Nota: Graças ao nosso **Merge Engine** nativo, o comando é seguro para ser rodado várias vezes. Em ambientes programáticos (como scripts ou bots), use `--conflict ours|theirs` para tomada de decisão automática de merges.*
+
+### `sauron doctor`
+
+Executa uma auditoria completa de integridade e conformidade estrutural e criptográfica (SHA-256) das regras, sumário da wiki e adaptadores de IAs configurados no projeto.
+
+```bash
+# Diagnóstico visual interativo
+sauron doctor
+
+# Diagnóstico com saída estruturada JSON (útil em pipelines de CI/CD)
+sauron doctor --json
+```
+
+### `sauron uninstall`
+
+Desvincula as preferências do Sauron no repositório local e central. Realiza a higiene cirúrgica das IDEs (removendo vinculações e regras específicas).
+*Nota: A wiki de documentação em `.sauron/wiki/` é preservada por padrão (degradação graciosa). Para removê-la fisicamente por completo, utilize a flag `--purge`.*
+
+```bash
+# Desinstalação com preservação da wiki
+sauron uninstall
+
+# Desinstalação profunda com purga física completa
+sauron uninstall -y --purge
 ```
-*Nota: Este comando é seguro e bloqueará automaticamente caso os diretórios `.sauron` ou `.agents` já existam no repositório, evitando a corrupção do seu histórico atual.*
 
 ## Estrutura Injetada
 
@@ -38,10 +72,12 @@ Ao rodar o comando `init`, a CLI injeta a seguinte topologia no projeto:
 
 ```text
 /
+├── AGENTS.md
 ├── .agents/
 │   ├── rules/
 │   └── skills/
 └── .sauron/
+    ├── .manifest.json
     └── wiki/
         ├── summary.json
         ├── history/
@@ -74,7 +110,6 @@ npm link
 ```
 
 ## Próximos Passos no Roadmap
-- `sauron check`: Comando de validação rigorosa para auditar a integridade da documentação deixada pela IA e bater o Markdown com o `summary.json`.
 - `sauron map`: Visão em formato de árvore hierárquica direto no terminal do seu "Cérebro de IA".
 
 ---