@fabioforest/openclaw 3.4.1 → 3.5.0

package/README.md

@@ -44,6 +44,7 @@ npx @fabioforest/openclaw ide install --apply
 |----------|---------|-----------|
 | Primeira vez no projeto | `init --apply` | Cria `.agent/` com templates |
 | Atualizar skills/rules | `update --apply` | Atualiza preservando customizações |
+| Desinstalar do projeto | `uninstall --apply` | Remove `.agent/` com backup |
 | Ver o que está instalado | `status` | Lista componentes e config |
 | Algo não funciona | `doctor` | Diagnóstico completo |
 | Quero entender meu ambiente | `inspect` | Análise 100% read-only |
@@ -113,6 +114,54 @@ npx @fabioforest/openclaw update --apply --merge
 
 ---
 
+---
+
+### `openclaw uninstall` — Desinstalar do projeto
+
+**Quando usar:** Quando quiser remover completamente o OpenClaw de um projeto.
+
+```bash
+# 1. Simula a remoção (mostra o que seria deletado)
+npx @fabioforest/openclaw uninstall
+#    → Mostra tree de .agent/ e openclaw.json
+#    → Alerta sobre audit logs e state que seriam perdidos
+#    → Nenhum arquivo é removido
+
+# 2. Aplica a remoção (com backup automático)
+npx @fabioforest/openclaw uninstall --apply
+#    → Pede para digitar "UNINSTALL" como confirmação
+#    → Oferece fazer backup (.agent.backup-<timestamp>/)
+#    → Remove .agent/ e openclaw.json
+#    → Salva log de auditoria no diretório
+
+# 3. Remoção forçada (sem backup, com --yes pula confirmação)
+npx @fabioforest/openclaw uninstall --apply --force --yes
+```
+
+**Saída de exemplo (modo PLAN):**
+
+```
+🗑️  OpenClaw Uninstall
+
+   📂 Diretório: /home/user/meu-projeto
+
+   🔴 REMOVER  .agent/ (25 arquivos)
+      📁 agents (3 arquivos)
+      📁 audit (1 arquivos)
+      📁 hooks (1 arquivos)
+      📁 rules (5 arquivos)
+      📁 skills (11 arquivos)
+      📁 workflows (7 arquivos)
+   🔴 REMOVER  openclaw.json
+
+   ⚠️  1 log(s) de auditoria serão perdidos!
+
+🔒 Modo PLAN (Read-Only). Nenhuma alteração feita.
+   Para desinstalar, rode: npx @fabioforest/openclaw uninstall --apply
+```
+
+---
+
 ### `openclaw inspect` — Analisar ambiente (read-only)
 
 **Quando usar:** Antes de qualquer ação, para entender o contexto. 100% read-only — nunca altera nada.
@@ -419,6 +468,155 @@ npx @fabioforest/openclaw assist
 
 ---
 
+## 💬 Exemplo Real: Usando o OpenClaw na IDE (Chat)
+
+O OpenClaw funciona como agente via chat na IDE. Aqui está uma simulação de como seria o fluxo real:
+
+### Exemplo 1: Otimizar perfil do LinkedIn
+
+```
+👤 Você (chat na IDE):
+   "Quero otimizar meu perfil do LinkedIn para vagas de AI Engineer"
+
+🤖 Agente (openclaw-router detecta: linkedin-optimizer):
+   📋 INSPECT ─ Coletando contexto:
+      • Objetivo: otimizar perfil LinkedIn para AI Engineer
+      • Idioma: pt-BR
+      • Skills instaladas: linkedin-optimizer ✅
+
+   📝 PLAN ─ Proposta de ações:
+      1. Analisar headline atual e propor 2 versões A/B
+      2. Reescrever seção "Sobre" com keywords de AI/MLOps
+      3. Sugerir ajustes nas experiências com métricas
+      4. Gerar checklist de publicação
+
+   ⚠️  RESTRIÇÃO: LinkedIn proíbe automação. Todo conteúdo
+       será gerado como rascunho para aplicação manual.
+
+   Deseja prosseguir? (S/n)
+
+👤 Você: "S"
+
+🤖 Agente:
+   ✅ APPLY ─ Rascunhos salvos em .agent/state/linkedin/drafts.md
+
+   ## Headline (opção A)
+   "AI Engineer | MLOps | Python | RAG & LLMs | Open Source"
+
+   ## Headline (opção B)
+   "Engenheiro de IA | Construindo pipelines de ML em produção"
+
+   📝 AUDIT ─ log salvo em .agent/audit/
+```
+
+### Exemplo 2: Testar performance de um site
+
+```
+👤 Você:
+   "Testa a performance do meu site https://meu-portfolio.dev"
+
+🤖 Agente (openclaw-router detecta: site-tester):
+   📋 INSPECT:
+      • URL: https://meu-portfolio.dev
+      • robots.txt: verificado ✅
+      • Ferramentas disponíveis: PageSpeed Insights API
+
+   📝 PLAN:
+      1. Rodar Lighthouse via PageSpeed Insights (sem infra local)
+      2. Coletar métricas: Performance, SEO, Acessibilidade, PWA
+      3. Listar as 5 principais oportunidades de melhoria
+      4. Salvar relatório em .agent/state/site-tests/
+
+   Confirmar execução?
+
+👤 Você: "sim"
+
+🤖 Agente:
+   ✅ Resultados:
+      • Performance: 87 → otimizar imagens (ganho estimado: +8pts)
+      • SEO: 95 ✅
+      • Acessibilidade: 72 → falta alt em 3 imagens + contraste baixo
+      • PWA: 60 → falta manifest.json e service worker
+
+   📊 Relatório salvo em .agent/state/site-tests/2026-02-19.json
+   📝 Audit salvo
+```
+
+### Exemplo 3: Atualizar skills após nova versão
+
+```
+👤 Você:
+   "Saiu versão nova do OpenClaw, como atualizo?"
+
+🤖 Agente (openclaw-router detecta: assist):
+   Recomendo o seguinte fluxo:
+
+   1. Primeiro, veja o que mudaria (modo PLAN, seguro):
+      $ npx @fabioforest/openclaw update
+
+   2. Se estiver tudo OK, aplique:
+      $ npx @fabioforest/openclaw update --apply
+
+   3. Para preservar customizações:
+      $ npx @fabioforest/openclaw update --apply --merge
+
+   O update faz backup automático de arquivos customizados
+   antes de sobrescrever, e copia novos templates.
+
+   Quer que eu execute o passo 1 agora?
+```
+
+### Exemplo 4: Desinstalar o OpenClaw de um projeto
+
+```
+👤 Você:
+   "Quero remover o OpenClaw deste projeto"
+
+🤖 Agente:
+   Vou simular a remoção primeiro (modo PLAN, seguro):
+
+   $ npx @fabioforest/openclaw uninstall
+
+   🗑️  PLAN — Seria removido:
+      .agent/ (25 arquivos, 15 skills, 5 rules)
+      openclaw.json
+      ⚠️  3 logs de auditoria seriam perdidos
+
+   Para aplicar de fato:
+   $ npx @fabioforest/openclaw uninstall --apply
+
+   O sistema vai pedir que você digite "UNINSTALL"
+   e oferecerá fazer backup antes de remover.
+
+   Quer que eu execute?
+```
+
+---
+
+## 🔄 Ciclo de Vida Completo
+
+```
+📦 INSTALAR        →  npx @fabioforest/openclaw init --apply
+                       ou: npx @fabioforest/openclaw ide install --apply
+
+🔍 INSPECIONAR     →  npx @fabioforest/openclaw inspect
+                       npx @fabioforest/openclaw status
+
+🛠️ USAR            →  Chat na IDE (skills + router fazem o resto)
+                       ou: npx @fabioforest/openclaw assist
+
+🔄 ATUALIZAR       →  npx @fabioforest/openclaw update --apply
+                       (preserva customizações com --merge)
+
+🏥 DIAGNOSTICAR    →  npx @fabioforest/openclaw doctor
+                       npx @fabioforest/openclaw debug
+
+🗑️ DESINSTALAR     →  npx @fabioforest/openclaw uninstall --apply
+                       (backup automático + confirmação forte)
+```
+
+---
+
 ## 🛠️ Desenvolvimento
 
 ```bash
@@ -445,8 +643,8 @@ Todas as flags funcionam com qualquer comando:
 |------|-----------|--------|
 | `--plan` | Modo simulação (read-only) | **Sim** |
 | `--apply` | Modo execução (aplica alterações) | Não |
-| `--yes, -y` | Pula confirmações | Não |
-| `--force, -f` | Permite operações destrutivas | Não |
+| `--yes, -y` | Pula confirmações interativas | Não |
+| `--force, -f` | Permite operações destrutivas (sem backup no uninstall) | Não |
 | `--path, -p <dir>` | Diretório alvo | `./` |
 | `--quiet, -q` | Saída mínima | Não |
 | `--no-audit` | Desabilita logs de auditoria | Não |

package/bin/openclaw.js

@@ -24,6 +24,7 @@ const pkg = require("../package.json");
 const COMMANDS = {
     init: "../lib/cli/init",
     update: "../lib/cli/update",
+    uninstall: "../lib/cli/uninstall",
     status: "../lib/cli/status",
     doctor: "../lib/cli/doctor",
     debug: "../lib/cli/debug",
@@ -92,6 +93,7 @@ function showHelp() {
   Comandos:
     init      Instala templates .agent/ no projeto atual
     update    Atualiza templates preservando customizações
+    uninstall Remove .agent/ e openclaw.json (com backup)
     status    Mostra status da instalação
     doctor    Healthcheck automatizado do ambiente
     setup     Roda wizard interativo de configuração

package/lib/cli/uninstall.js

@@ -0,0 +1,194 @@
+"use strict";
+
+/**
+ * Comando CLI: uninstall
+ *
+ * Remove a instalação do OpenClaw (.agent/) de um projeto.
+ * Segue o protocolo consent-first:
+ *   - Modo PLAN por padrão (mostra o que seria removido)
+ *   - Exige --apply para executar
+ *   - Exige confirmação forte (digitar frase)
+ *   - Backup opcional antes de remover
+ */
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const { detectContext, getAuditHeader } = require("../context");
+
+function ask(q) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((res) => rl.question(q, (ans) => { rl.close(); res(ans.trim()); }));
+}
+
+/**
+ * Conta arquivos recursivamente em um diretório.
+ */
+function countFiles(dir) {
+    let count = 0;
+    if (!fs.existsSync(dir)) return 0;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            count += countFiles(path.join(dir, entry.name));
+        } else {
+            count++;
+        }
+    }
+    return count;
+}
+
+/**
+ * Lista o conteúdo de um diretório de forma visual (tree).
+ */
+function listTree(dir, prefix = "") {
+    const lines = [];
+    if (!fs.existsSync(dir)) return lines;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    entries.forEach((entry, i) => {
+        const isLast = i === entries.length - 1;
+        const connector = isLast ? "└── " : "├── ";
+        const icon = entry.isDirectory() ? "📁" : "📄";
+        lines.push(`${prefix}${connector}${icon} ${entry.name}`);
+        if (entry.isDirectory()) {
+            const childPrefix = prefix + (isLast ? "    " : "│   ");
+            lines.push(...listTree(path.join(dir, entry.name), childPrefix));
+        }
+    });
+    return lines;
+}
+
+/**
+ * Executa o comando uninstall.
+ * @param {object} options
+ * @param {string} options.targetPath — diretório alvo
+ * @param {object} options.flags — flags do CLI
+ */
+async function run({ targetPath, flags }) {
+    const agentDir = path.join(targetPath, ".agent");
+    const configFile = path.join(targetPath, "openclaw.json");
+    const planMode = !flags.apply;
+    const ctx = detectContext(targetPath);
+
+    console.log("\n🗑️  OpenClaw Uninstall\n");
+
+    // Verificar se existe instalação
+    if (!fs.existsSync(agentDir) && !fs.existsSync(configFile)) {
+        console.log("ℹ️  Nenhuma instalação do OpenClaw encontrada neste diretório.");
+        console.log(`   Path: ${targetPath}`);
+        return;
+    }
+
+    // Mostrar o que será removido
+    console.log(`   📂 Diretório: ${targetPath}`);
+    console.log("");
+
+    const toRemove = [];
+
+    if (fs.existsSync(agentDir)) {
+        const fileCount = countFiles(agentDir);
+        toRemove.push({ path: agentDir, label: ".agent/", files: fileCount, isDir: true });
+        console.log(`   🔴 REMOVER  .agent/ (${fileCount} arquivos)`);
+
+        // Mostrar tree resumido (primeiro nível)
+        const entries = fs.readdirSync(agentDir, { withFileTypes: true });
+        entries.forEach(e => {
+            const icon = e.isDirectory() ? "📁" : "📄";
+            const subCount = e.isDirectory() ? ` (${countFiles(path.join(agentDir, e.name))} arquivos)` : "";
+            console.log(`      ${icon} ${e.name}${subCount}`);
+        });
+    }
+
+    if (fs.existsSync(configFile)) {
+        toRemove.push({ path: configFile, label: "openclaw.json", isDir: false });
+        console.log(`   🔴 REMOVER  openclaw.json`);
+    }
+
+    // Verificar audit logs que seriam perdidos
+    const auditDir = path.join(agentDir, "audit");
+    if (fs.existsSync(auditDir)) {
+        const auditCount = countFiles(auditDir);
+        if (auditCount > 0) {
+            console.log(`\n   ⚠️  ${auditCount} log(s) de auditoria serão perdidos!`);
+        }
+    }
+
+    // Verificar state que seria perdido
+    const stateDir = path.join(agentDir, "state");
+    if (fs.existsSync(stateDir)) {
+        const stateCount = countFiles(stateDir);
+        if (stateCount > 0) {
+            console.log(`   ⚠️  ${stateCount} arquivo(s) de estado serão perdidos (mission_control, MEMORY)!`);
+        }
+    }
+
+    // Modo PLAN: não faz nada
+    if (planMode) {
+        console.log("\n🔒 Modo PLAN (Read-Only). Nenhuma alteração feita.");
+        console.log("   Para desinstalar, rode: npx @fabioforest/openclaw uninstall --apply");
+        return;
+    }
+
+    // Modo APPLY: pedir confirmação forte
+    console.log("");
+    if (!flags.yes) {
+        const confirm = await ask("⚠️  Digite 'UNINSTALL' para confirmar a remoção: ");
+        if (confirm !== "UNINSTALL") {
+            console.log("⏹️  Cancelado. Nada foi removido.");
+            return;
+        }
+    }
+
+    // Backup opcional
+    if (!flags.force) {
+        const doBackup = flags.yes ? "s" : await ask("💾 Fazer backup antes de remover? (S/n): ");
+        if (doBackup.toLowerCase() !== "n") {
+            const backupName = `.agent.backup-${Date.now()}`;
+            const backupPath = path.join(targetPath, backupName);
+            try {
+                fs.cpSync(agentDir, backupPath, { recursive: true });
+                console.log(`   ✅ Backup criado: ${backupName}/`);
+            } catch (err) {
+                console.error(`   ⚠️  Falha no backup: ${err.message}`);
+                const cont = await ask("   Continuar sem backup? (y/N): ");
+                if (cont.toLowerCase() !== "y") {
+                    console.log("⏹️  Cancelado.");
+                    return;
+                }
+            }
+        }
+    }
+
+    // Executar remoção
+    const audit = [getAuditHeader(ctx, "uninstall", flags)];
+
+    try {
+        for (const item of toRemove) {
+            if (item.isDir) {
+                fs.rmSync(item.path, { recursive: true, force: true });
+            } else {
+                fs.unlinkSync(item.path);
+            }
+            console.log(`   ✅ Removido: ${item.label}`);
+            audit.push(`- ACT: REMOVED ${item.label}`);
+        }
+
+        console.log("\n✨ OpenClaw desinstalado com sucesso!");
+        console.log("   Para reinstalar: npx @fabioforest/openclaw init --apply\n");
+
+        // Gravar audit no diretório pai (já que .agent/ foi removido)
+        if (flags.audit !== false) {
+            const filename = `openclaw-uninstall-${new Date().toISOString().replace(/[:.]/g, "-")}.md`;
+            const auditPath = path.join(targetPath, filename);
+            try {
+                fs.writeFileSync(auditPath, audit.join("\n") + "\n", "utf8");
+                console.log(`   📝 Log de auditoria: ${filename}`);
+            } catch (e) { /* silencioso */ }
+        }
+
+    } catch (err) {
+        console.error(`\n❌ Falha: ${err.message}`);
+        process.exit(1);
+    }
+}
+
+module.exports = { run };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabioforest/openclaw",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Agentes autônomos para engenharia de software",
   "publishConfig": {
     "access": "public"