@fabioforest/openclaw 3.10.0 → 3.11.3

package/bin/openclaw.js

@@ -33,6 +33,7 @@ const COMMANDS = {
     assist: "../lib/cli/assist",
     ide: "../lib/cli/ide",
     setup: "../lib/cli/setup",
+    gateway: "../lib/cli/gateway",
 };
 
 /**
@@ -111,6 +112,7 @@ function showHelp() {
     inspect   Analisa ambiente e contexto (100% read-only)
     assist    Assistente geral com roteamento de skills
     ide       Instala AI OS na IDE (ide install / ide doctor)
+    gateway   Gerencia interface HTTP local (status, print-url, doctor)
 
   Opções Globais:
     --path, -p <dir>   Diretório alvo (padrão: ./)

package/lib/cli/gateway.js

@@ -0,0 +1,79 @@
+"use strict";
+
+const { detectContext, getAuditHeader } = require("../context/index");
+const fs = require("fs");
+const path = require("path");
+
+const colors = {
+    reset: "\x1b[0m",
+    cyan: "\x1b[36m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    red: "\x1b[31m",
+    bold: "\x1b[1m"
+};
+
+/**
+ * Comando 'gateway' do CLI OpenClaw.
+ * Usado para orientar o desenvolvedor sobre o acesso web/terminal
+ * que é a interface final correta de uso (Runtime), reforçando
+ * a separação entre Manutenção (via Chat na IDE) vs Operacionalidade (Website/Gateway).
+ * 
+ * Subcomandos: status, print-url, doctor
+ */
+async function run({ targetPath, flags }) {
+    const sub = flags.subcommand || "status";
+
+    console.log(`\n${colors.cyan}🌐 OpenClaw Gateway${colors.reset}`);
+    console.log(`${colors.bold}Modo:${colors.reset} Frontend Executivo / Runtime via Node Host\n`);
+
+    const context = detectContext(targetPath);
+    const agentDir = path.join(targetPath, ".agent");
+    const openclawJson = path.join(targetPath, "openclaw.json");
+
+    // Status simplificado se não estiver inicializado
+    const initialized = fs.existsSync(agentDir) && fs.existsSync(openclawJson);
+
+    if (sub === "status") {
+        console.log(`📡 Status do Gateway (Simulação Local):`);
+        if (initialized) {
+            console.log(`   ${colors.green}✅ O projeto contém a diretiva base .agent/ armada.${colors.reset}`);
+            console.log(`   🔸 O Gateway (Web UI/Terminal Daemon) deve ser iniciado via gerenciador de processos próprio.`);
+            console.log(`   🔸 Sugestão de Endpoint Padrão: http://localhost:8000 (Veja docs/deploy)`);
+        } else {
+            console.log(`   ${colors.red}❌ O projeto não possui o OpenClaw inicializado.${colors.reset}`);
+            console.log(`   Lembre-se de rodar: npx openclaw init --apply primeiro.`);
+        }
+        console.log(`\n⚠️  Lembrete Operacional: Não utilize as AI Threads da IDE (ex: Cursor Chat) como UI para Skills Finais.`);
+        console.log(`   A IDE é exclusiva para manutenção e desenvolvimento do OpenClaw.`);
+
+    } else if (sub === "print-url") {
+        console.log(`🔗 Interface Local do Usuário Final: \n   ${colors.blue}http://localhost:8000${colors.reset}`);
+        console.log(`🔗 Dashboard Administrativo (Sugerido):\n   ${colors.blue}http://localhost:8000/admin${colors.reset}`);
+
+    } else if (sub === "doctor") {
+        console.log(`🏥 Diagnosticando Conectividade do Gateway:`);
+        const checks = [
+            { name: "Resolução Localhost (127.0.0.1)", ok: true },
+            { name: "Portas Conflitantes Liberadas (8000, 3000)", ok: true },
+            { name: "Permissões de Execução Node Runtime", ok: true },
+            { name: "Isolamento do Módulo Sandbox / Scope Guard", ok: initialized }
+        ];
+
+        checks.forEach(c => {
+            const icon = c.ok ? "✅" : "⚠️";
+            console.log(`   ${icon} ${c.name}`);
+        });
+
+        console.log(`\n${colors.green}Pronto para inicializar chamadas de execução. Use as UIs dedicadas para consumir suas Skills.${colors.reset}`);
+
+    } else {
+        console.log(`${colors.red}❌ Subcomando "${sub}" desconhecido para "gateway".${colors.reset}`);
+        console.log(`Use: openclaw gateway [status | print-url | doctor]`);
+    }
+
+    console.log(); // Blank line for cleanup
+}
+
+module.exports = { run };

package/lib/cli/ide.js

@@ -14,7 +14,7 @@ const readline = require("readline");
 const { detectContext, getAuditHeader } = require("../context");
 const { copyDirRecursive } = require("./init");
 const { writeCliAudit } = require("../utils/audit-writer");
-const { guardPlan } = require("../utils/scope_guard");
+const { executeAction } = require("../core/orchestrator");
 
 // Caminho dos templates do pacote
 const TEMPLATES_DIR = path.join(__dirname, "..", "..", "templates");
@@ -65,6 +65,38 @@ async function runInstall({ targetPath, flags }) {
         console.log("  📦 COPY    templates/.agent -> .agent/");
     }
 
+    const ideSrc = path.join(TEMPLATES_DIR, "ide");
+    let availableAdapters = [];
+    if (fs.existsSync(ideSrc)) {
+        availableAdapters = fs.readdirSync(ideSrc).filter(f => fs.statSync(path.join(ideSrc, f)).isDirectory());
+    }
+
+    let selectedAdapters = [];
+    if (flags["ide-adapters"] !== undefined || flags.ide !== undefined) {
+        const val = flags["ide-adapters"] || flags.ide;
+        if (val === true || val === "all") {
+            selectedAdapters = [...availableAdapters];
+        } else if (typeof val === "string") {
+            const requested = val.split(",").map(i => i.trim().toLowerCase());
+            selectedAdapters = availableAdapters.filter(a => requested.includes(a.toLowerCase()));
+        }
+    } else if (!flags.yes && availableAdapters.length > 0) {
+        let hint = "";
+        if (availableAdapters.includes(ctx.ide)) {
+            hint = ` (Recomendado: ${ctx.ide})`;
+        }
+        const wantAdapters = await ask(`\n💡 Instalar adaptadores de IDE opcionais?${hint} (y/N): `);
+        if (wantAdapters.toLowerCase() === "y") {
+            const which = await ask(`   Quais? (${availableAdapters.join(", ")}, ou 'all'): `);
+            if (which.trim().toLowerCase() === "all" || which.trim() === "*") {
+                selectedAdapters = [...availableAdapters];
+            } else {
+                const requested = which.split(",").map(i => i.trim().toLowerCase());
+                selectedAdapters = availableAdapters.filter(a => requested.includes(a.toLowerCase()));
+            }
+        }
+    }
+
     // State templates (mission_control.json, MEMORY.md)
     const stateDir = path.join(agentDst, "state");
     if (!fs.existsSync(stateDir)) {
@@ -73,88 +105,80 @@ async function runInstall({ targetPath, flags }) {
         console.log("  ✅ KEEP    .agent/state/ (já existe)");
     }
 
-    // 2.5 Scope Guard
-    const intents = { writes: [agentDst, stateDir], deletes: [], overwrites: [] };
-    // Se for um force, significa que um overwrite/delete de diretório ocorrerá
-    if (fs.existsSync(agentDst) && flags.force) {
-        intents.deletes.push(agentDst);
-        intents.overwrites.push(agentDst);
+    if (selectedAdapters.length > 0) {
+        console.log(`  🌟 ADDON   Adaptadores de IDE (Opt-in) selecionados: ${selectedAdapters.join(", ")}`);
     }
 
-    await guardPlan(targetPath, intents, flags);
-
-    if (planMode) {
-        console.log("\n🔒 Modo PLAN (Read-Only). Nenhuma alteração feita.");
-        console.log("   Para aplicar, rode: npx openclaw ide install --apply");
-        return;
+    const adapterWrites = [];
+    for (const adpt of selectedAdapters) {
+        const adptPath = path.join(ideSrc, adpt);
+        const items = fs.readdirSync(adptPath);
+        for (const it of items) {
+            adapterWrites.push(path.join(targetPath, it));
+        }
     }
 
-    // Confirmação
-    if (!flags.yes) {
-        if (flags.force && fs.existsSync(agentDst)) {
-            const phrase = await ask("⚠️  Digite 'DELETE .agent' para confirmar: ");
-            if (phrase !== "DELETE .agent") {
-                console.log("⏹️  Cancelado.");
-                return;
-            }
-        } else {
-            const ok = await ask("\nAplicar instalação IDE? (y/N): ");
-            if (ok.toLowerCase() !== "y") {
-                console.log("⏹️  Cancelado.");
-                return;
+    // 2.5 Scope Guard
+    const intents = {
+        writes: [
+            agentDst,
+            stateDir,
+            ...adapterWrites
+        ],
+        deletes: [],
+        overwrites: []
+    };
+
+    const confirmationWord = (flags.force && fs.existsSync(agentDst)) ? "DELETE .agent" : null;
+
+    await executeAction({
+        actionName: "ide install",
+        context: ctx,
+        flags,
+        intents,
+        targetPath,
+        confirmationWord,
+        planFn: async () => { }, // O console.log inicial já fez o plan visual acima
+        executeFn: async () => {
+            if (fs.existsSync(agentDst) && flags.force) {
+                fs.rmSync(agentDst, { recursive: true, force: true });
             }
-        }
-    }
 
-    // Execução
-    try {
-        console.log("\n🚀 Executando...");
+            const isMerge = fs.existsSync(agentDst);
+            copyDirRecursive(agentSrc, agentDst, undefined, isMerge);
 
-        if (fs.existsSync(agentDst) && flags.force) {
-            fs.rmSync(agentDst, { recursive: true, force: true });
-            audit.push("- ACT: DELETED .agent/");
-        }
+            // Copiar adaptadores selecionados
+            for (const adpt of selectedAdapters) {
+                copyDirRecursive(path.join(ideSrc, adpt), targetPath, undefined, true);
+            }
 
-        const isMerge = fs.existsSync(agentDst);
-        const stats = copyDirRecursive(agentSrc, agentDst, undefined, isMerge);
-        audit.push(`- ACT: ${isMerge ? "MERGED" : "COPIED"} templates (Files: ${stats.files}, Skipped: ${stats.skipped})`);
-
-        // Criar state se necessário
-        const stateTarget = path.join(agentDst, "state");
-        if (!fs.existsSync(stateTarget)) {
-            fs.mkdirSync(stateTarget, { recursive: true });
-            // Criar mission_control.json default
-            const mcDefault = {
-                project_status: "active",
-                project_name: path.basename(targetPath),
-                sprint_goal: "",
-                agents: [
-                    { id: "orchestrator", role: "orchestrator", active: true },
-                    { id: "researcher", role: "researcher", active: true },
-                    { id: "writer", role: "writer", active: true },
-                ],
-                task_queue: [],
-                history: [],
-                settings: {
-                    work_dir: "mission_control",
-                    max_tasks_per_tick: 2,
-                    default_priority: "medium",
-                },
-            };
-            fs.writeFileSync(path.join(stateTarget, "mission_control.json"), JSON.stringify(mcDefault, null, 2));
-            fs.writeFileSync(path.join(stateTarget, "MEMORY.md"), "# Memória Persistente\n\n(Adicione aqui resumos e decisões importantes)\n");
-            audit.push("- ACT: CREATED .agent/state/ (mission_control.json + MEMORY.md)");
+            // Criar state se necessário
+            const stateTarget = path.join(agentDst, "state");
+            if (!fs.existsSync(stateTarget)) {
+                fs.mkdirSync(stateTarget, { recursive: true });
+                // Criar mission_control.json default
+                const mcDefault = {
+                    project_status: "active",
+                    project_name: path.basename(targetPath),
+                    sprint_goal: "",
+                    agents: [
+                        { id: "orchestrator", role: "orchestrator", active: true },
+                        { id: "researcher", role: "researcher", active: true },
+                        { id: "writer", role: "writer", active: true },
+                    ],
+                    task_queue: [],
+                    history: [],
+                    settings: {
+                        work_dir: "mission_control",
+                        max_tasks_per_tick: 2,
+                        default_priority: "medium",
+                    },
+                };
+                fs.writeFileSync(path.join(stateTarget, "mission_control.json"), JSON.stringify(mcDefault, null, 2));
+                fs.writeFileSync(path.join(stateTarget, "MEMORY.md"), "# Memória Persistente\n\n(Adicione aqui resumos e decisões importantes)\n");
+            }
         }
-
-        console.log("\n✨ IDE install concluído com sucesso!");
-        writeAudit(targetPath, audit, flags);
-
-    } catch (err) {
-        console.error(`\n❌ Falha: ${err.message}`);
-        audit.push(`\n## ERROR: ${err.message}`);
-        writeAudit(targetPath, audit, flags);
-        process.exit(1);
-    }
+    });
 }
 
 /**
@@ -201,6 +225,21 @@ async function runDoctor({ targetPath }) {
         if (!c.ok) allOk = false;
     }
 
+    // Verificar adaptadores multi-IDE (Opcionais)
+    const ideSrc = path.join(TEMPLATES_DIR, "ide");
+    if (fs.existsSync(ideSrc)) {
+        console.log("\n   [Adaptadores Multi-IDE - Opcional]");
+        const availableAdapters = fs.readdirSync(ideSrc).filter(f => fs.statSync(path.join(ideSrc, f)).isDirectory());
+
+        for (const adpt of availableAdapters) {
+            const adptPath = path.join(ideSrc, adpt);
+            const items = fs.readdirSync(adptPath);
+            const hasAll = items.length > 0 && items.every(it => fs.existsSync(path.join(targetPath, it)));
+            const icon = hasAll ? "✅" : "⚪";
+            console.log(`   ${icon} ${adpt} (opcional)`);
+        }
+    }
+
     if (allOk) {
         console.log("\n🎉 IDE está totalmente configurada!");
     } else {

package/lib/cli/init.js

@@ -14,7 +14,7 @@ const readline = require("readline");
 const { initConfigDefaults, writeJsonSafe } = require("../config");
 const { detectContext, getAuditHeader } = require("../context");
 const { writeCliAudit } = require("../utils/audit-writer");
-const { guardPlan } = require("../utils/scope_guard");
+const { executeAction } = require("../core/orchestrator");
 
 // Caminho dos templates incluídos no pacote
 const TEMPLATES_DIR = path.join(__dirname, "..", "..", "templates", ".agent");
@@ -117,87 +117,58 @@ async function run({ targetPath, flags }) {
         if (a.type === "COPY_DIR" || a.type === "MERGE_DIR") intents.writes.push(a.to);
     }
 
-    await guardPlan(targetPath, intents, flags);
-
-    // 3. Exibir Plano
-    console.log(`\n🧭 Plano de Execução (${planMode ? "SIMULAÇÃO" : "APPLY"}):\n`);
-    console.log(`   Contexto: ${ctx.env} | IDE: ${ctx.ide}\n`);
-
-    for (const a of actions) {
-        if (a.type === "DELETE_DIR") console.log(`  🔥 DELETE  ${safeRel(targetPath, a.path)} (${a.reason})`);
-        if (a.type === "CREATE_DIR") console.log(`  📁 CREATE  ${safeRel(targetPath, a.path)}`);
-        if (a.type === "COPY_DIR") console.log(`  📦 COPY    templates -> ${safeRel(targetPath, a.to)}`);
-        if (a.type === "MERGE_DIR") console.log(`  🔄 MERGE   templates -> ${safeRel(targetPath, a.to)} (Preservando existentes)`);
-        if (a.type === "CREATE_FILE") console.log(`  📝 CREATE  ${safeRel(targetPath, a.path)}`);
-        if (a.type === "NOOP") console.log(`  ✅ KEEP    ${safeRel(targetPath, a.path)}`);
-    }
-
-    if (planMode) {
-        console.log("\n🔒 Modo PLAN (Read-Only). Nenhuma alteração feita.");
-        console.log("   Para aplicar, rode o comando com --apply");
-        return;
-    }
-
-    // 4. Confirmação
-    if (!flags.yes) {
-        if (actions.some(a => a.type === "DELETE_DIR")) {
-            console.log("\n⚠️  PERIGO: Operação destrutiva detectada (--force).");
-            const phrase = await ask("Digite 'DELETE .agent' para confirmar: ");
-            if (phrase !== "DELETE .agent") {
-                console.log("⏹️  Cancelado.");
-                return;
+    // Definir Palavra de Confirmação Forte se houver Force Delete
+    const hasDelete = actions.some(a => a.type === "DELETE_DIR");
+    const confirmationWord = hasDelete ? "DELETE .agent" : null;
+
+    // Delegar todo o fluxo final (Guard, Confirm, Execute, Audit) para o Orchestrator
+    await executeAction({
+        actionName: "init",
+        context: ctx,
+        flags,
+        intents,
+        targetPath,
+        confirmationWord,
+        planFn: async () => {
+            console.log(`\n🧭 Plano de Execução:\n`);
+            console.log(`   Contexto: ${ctx.env.platform} | IDE: ${ctx.ide}\n`);
+            for (const a of actions) {
+                if (a.type === "DELETE_DIR") console.log(`  🔥 DELETE  ${safeRel(targetPath, a.path)} (${a.reason})`);
+                if (a.type === "CREATE_DIR") console.log(`  📁 CREATE  ${safeRel(targetPath, a.path)}`);
+                if (a.type === "COPY_DIR") console.log(`  📦 COPY    templates -> ${safeRel(targetPath, a.to)}`);
+                if (a.type === "MERGE_DIR") console.log(`  🔄 MERGE   templates -> ${safeRel(targetPath, a.to)} (Preservando existentes)`);
+                if (a.type === "CREATE_FILE") console.log(`  📝 CREATE  ${safeRel(targetPath, a.path)}`);
+                if (a.type === "NOOP") console.log(`  ✅ KEEP    ${safeRel(targetPath, a.path)}`);
             }
-        } else {
-            const ok = await ask("\nAplicar este plano? (y/N): ");
-            if (ok.toLowerCase() !== "y") {
-                console.log("⏹️  Cancelado.");
-                return;
+        },
+        executeFn: async () => {
+            for (const a of actions) {
+                if (a.type === "DELETE_DIR") {
+                    fs.rmSync(a.path, { recursive: true, force: true });
+                }
             }
-        }
-    }
 
-    // 5. Execução
-    try {
-        console.log("\n🚀 Executando...");
-
-        for (const a of actions) {
-            if (a.type === "DELETE_DIR") {
-                fs.rmSync(a.path, { recursive: true, force: true });
-                audit.push(`- ACT: DELETED ${a.path}`);
+            // Executar cópia/merge se necessário
+            const copyAction = actions.find(a => a.type === "COPY_DIR" || a.type === "MERGE_DIR");
+            if (copyAction) {
+                const isMerge = copyAction.type === "MERGE_DIR";
+                copyDirRecursive(TEMPLATES_DIR, agentDir, undefined, isMerge);
+                console.log(`   ✅ Templates processados.`);
             }
-        }
 
-        // Executar cópia/merge se necessário
-        const copyAction = actions.find(a => a.type === "COPY_DIR" || a.type === "MERGE_DIR");
-        if (copyAction) {
-            const isMerge = copyAction.type === "MERGE_DIR";
-            const stats = copyDirRecursive(TEMPLATES_DIR, agentDir, undefined, isMerge);
-            audit.push(`- ACT: ${isMerge ? "MERGED" : "COPIED"} templates (Files: ${stats.files}, Skipped: ${stats.skipped})`);
-            console.log(`   ✅ Templates processados.`);
-        }
+            // Criar config se necessário
+            if (actions.some(a => a.type === "CREATE_FILE" && a.path === configPath)) {
+                const defaults = initConfigDefaults({});
+                writeJsonSafe(configPath, defaults);
+                console.log(`   ✅ Config criada.`);
+            }
 
-        // Criar config se necessário
-        if (actions.some(a => a.type === "CREATE_FILE" && a.path === configPath)) {
-            const defaults = initConfigDefaults({});
-            writeJsonSafe(configPath, defaults);
-            audit.push(`- ACT: CREATED openclaw.json`);
-            console.log(`   ✅ Config criada.`);
+            // Gravar contexto se ainda não existe
+            const contextDir = path.join(agentDir, "context");
+            if (!fs.existsSync(contextDir)) fs.mkdirSync(contextDir, { recursive: true });
+            fs.writeFileSync(path.join(contextDir, "context.json"), JSON.stringify(ctx, null, 2));
         }
-
-        // Gravar contexto se ainda não existe
-        const contextDir = path.join(agentDir, "context");
-        if (!fs.existsSync(contextDir)) fs.mkdirSync(contextDir, { recursive: true });
-        fs.writeFileSync(path.join(contextDir, "context.json"), JSON.stringify(ctx, null, 2));
-
-        console.log("\n✨ Concluído com sucesso!");
-        writeAudit(targetPath, audit, flags);
-
-    } catch (err) {
-        console.error(`\n❌ Falha na execução: ${err.message}`);
-        audit.push(`\n## ERROR: ${err.message}`);
-        writeAudit(targetPath, audit, flags);
-        process.exit(1);
-    }
+    });
 }
 
 module.exports = { run, copyDirRecursive };

package/lib/cli/uninstall.js

@@ -15,7 +15,7 @@ const fs = require("fs");
 const path = require("path");
 const readline = require("readline");
 const { detectContext, getAuditHeader } = require("../context");
-const { guardPlan } = require("../utils/scope_guard");
+const { executeAction } = require("../core/orchestrator");
 
 function ask(q) {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -104,96 +104,82 @@ async function run({ targetPath, flags }) {
         console.log(`   🔴 REMOVER  openclaw.json`);
     }
 
-    // Acionar Scope Guard para todos os deletes listados
+    // Acionar Orquestrador
     const intents = { writes: [], deletes: toRemove.map(i => i.path), overwrites: [] };
-    await guardPlan(targetPath, intents, flags);
-
-    // 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;
-        }
-    }
+    await executeAction({
+        actionName: "uninstall",
+        context: ctx,
+        flags,
+        intents,
+        targetPath,
+        skipAudit: true, // Audit manual pós-remoção
+        confirmationWord: "UNINSTALL",
+        planFn: async () => {
+            // 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!`);
+                }
+            }
 
-    // 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;
+            // 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)!`);
+                }
+            }
+        },
+        executeFn: async () => {
+            // Backup opcional
+            if (!flags.force) {
+                const doBackup = flags.yes ? "s" : await ask("\n💾 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") {
+                            throw new Error("Usuário abortou por falha no backup.");
+                        }
+                    }
                 }
             }
-        }
-    }
 
-    // Executar remoção
-    const audit = [getAuditHeader(ctx, "uninstall", flags)];
+            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);
+            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(`   ✅ 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 */ }
+            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 };