@fabioforest/openclaw 3.0.0 → 3.4.1

package/README.md

@@ -1,73 +1,425 @@
-# OpenClaw OS
+# 🦀 OpenClaw AI OS
 
-CLI e starter kit para configuração segura do OpenClaw em VPS, Mac, Windows e Docker.
+**Sistema universal de agentes para IDEs** — instale, configure e use via chat ou terminal.
 
-## Instalação
+O OpenClaw transforma qualquer projeto em um workspace inteligente com skills, regras de segurança e roteamento econômico de modelos de IA. Funciona em **Cursor, VSCode, Gemini Code Assist, Antigravity** e qualquer IDE com suporte a agentes.
+
+---
+
+## 📦 Instalação
+
+### Opção 1: Via npx (recomendado — sem instalar nada)
 
 ```bash
-# Via npx (recomendado)
+# Simula o que será feito (modo seguro, não altera nada)
 npx @fabioforest/openclaw init
 
-# Ou instale globalmente
+# Instala de fato no projeto
+npx @fabioforest/openclaw init --apply
+```
+
+### Opção 2: Instalação global
+
+```bash
 npm install -g @fabioforest/openclaw
-openclaw init
+openclaw init --apply
+```
+
+### Opção 3: Instalação completa para IDEs
+
+```bash
+# Instala o "AI OS" com skills, rules, state e hooks
+npx @fabioforest/openclaw ide install --apply
+```
+
+> **💡 Dica**: Todos os comandos operam em **modo PLAN por padrão** (read-only). Nada é alterado sem `--apply`.
+
+---
+
+## 🎯 Quando usar cada comando
+
+### Resumo rápido
+
+| Situação | Comando | O que faz |
+|----------|---------|-----------|
+| Primeira vez no projeto | `init --apply` | Cria `.agent/` com templates |
+| Atualizar skills/rules | `update --apply` | Atualiza preservando customizações |
+| 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 |
+| Preciso de ajuda geral | `assist` | Assistente com roteamento de skills |
+| Instalar AI OS na IDE | `ide install --apply` | Skills + rules + state + hooks |
+| Verificar IDE configurada | `ide doctor` | Checa se tudo está "armado" |
+| Configurar do zero | `setup` | Wizard interativo passo a passo |
+| Problemas de rede/VPN | `debug` | Diagnóstico de conectividade |
+| Instalar ou reparar (automático) | `check` | Orquestrador inteligente |
+
+---
+
+## 📖 Manual de Uso Detalhado
+
+### `openclaw init` — Instalar no projeto
+
+**Quando usar:** Primeira vez que você quer adicionar o OpenClaw a um projeto.
+
+```bash
+# 1. Primeiro, simule para ver o que vai acontecer
+npx @fabioforest/openclaw init
+#    → Mostra plano: "CREATE .agent/", "COPY templates", "CREATE openclaw.json"
+#    → Nenhum arquivo é criado
+
+# 2. Se estiver tudo certo, aplique
+npx @fabioforest/openclaw init --apply
+#    → Cria .agent/ com skills, rules, hooks e workflows
+#    → Cria openclaw.json com configurações default
+
+# 3. Se já existe e quer sobrescrever (exige confirmação forte)
+npx @fabioforest/openclaw init --apply --force
+#    → Pede para digitar "DESTROY .agent" para confirmar
+```
+
+**Flags disponíveis:**
+
+| Flag | O que faz |
+|------|-----------|
+| `--apply` | Executa de fato (sem isso, só simula) |
+| `--force` | Permite sobrescrever `.agent/` existente |
+| `--path ./dir` | Instala em outro diretório |
+| `--yes` | Pula confirmações interativas |
+| `--no-audit` | Não gera log de auditoria |
+
+---
+
+### `openclaw update` — Atualizar templates
+
+**Quando usar:** Quando sair uma versão nova do OpenClaw e você quiser atualizar skills/rules sem perder customizações.
+
+```bash
+# Simula a atualização (mostra o que mudou)
+npx @fabioforest/openclaw update
+
+# Aplica a atualização
+npx @fabioforest/openclaw update --apply
+
+# Merge seguro (preserva customizações)
+npx @fabioforest/openclaw update --apply --merge
+```
+
+**Como funciona:**
+- Compara cada arquivo por hash SHA-256
+- Se você customizou um arquivo, faz backup (`.bak`) antes de atualizar
+- Novos templates são copiados normalmente
+- Tudo é registrado em `.agent/audit/`
+
+---
+
+### `openclaw inspect` — Analisar ambiente (read-only)
+
+**Quando usar:** Antes de qualquer ação, para entender o contexto. 100% read-only — nunca altera nada.
+
+```bash
+npx @fabioforest/openclaw inspect
 ```
 
-## Comandos
+**Saída de exemplo:**
+
+```
+🔎 OpenClaw Inspect (Read-Only)
 
-| Comando | Descrição |
-|---------|-----------|
-| `openclaw init` | Instala templates `.agent/` no projeto |
-| `openclaw update` | Atualiza templates preservando customizações |
-| `openclaw status` | Mostra status da instalação |
-| `openclaw doctor` | Healthcheck automatizado do ambiente |
-| `openclaw setup` | Roda wizard interativo de configuração |
+   🖥️  Plataforma: darwin
+   🐳 Docker: false
+   🪟 WSL: false
+   💻 IDE: cursor
+   📂 Path: /home/user/meu-projeto
+   📦 OpenClaw instalado: Sim
+   📋 Config: Sim
+   🐙 Git repo: Sim
 
-### Opções
+   🧠 Skills instaladas (15):
+      • content-sourcer    • context-flush
+      • drive-organizer    • linkedin-optimizer
+      • mission-control    • openclaw-router
+      • smart-router       • web-scraper
+      ...
+
+✅ Inspect concluído (nenhuma alteração feita).
+```
+
+**Modo JSON (para automações):**
 
 ```bash
-openclaw init --force          # Sobrescreve .agent/ existente
-openclaw init --path ./dir     # Instala em diretório específico
-openclaw doctor --quiet        # Saída mínima
+npx @fabioforest/openclaw inspect --quiet
+# → Retorna JSON puro, ideal para pipes e scripts
 ```
 
-## O que é instalado
+---
+
+### `openclaw assist` — Assistente geral com roteamento
 
-O comando `init` cria a seguinte estrutura no seu projeto:
+**Quando usar:** Quando não sabe qual skill usar. O assist analisa sua solicitação e sugere a skill mais adequada.
+
+```bash
+npx @fabioforest/openclaw assist
+```
+
+**Como funciona:**
+1. Detecta contexto (IDE, plataforma, skills disponíveis)
+2. Pede sua solicitação em linguagem natural
+3. Roteia para a skill mais relevante via triggers
+4. Mostra alternativas e protocolo recomendado
+
+**Exemplo de interação:**
+
+```
+🧠 OpenClaw Assist — Modo PLAN por padrão (seguro)
+   IDE: cursor | OpenClaw: instalado
+
+Descreva o que deseja fazer:
+> otimizar meu perfil do linkedin
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Skill selecionada: linkedin-optimizer
+   Descrição: Ajuda a otimizar perfil e posts para LinkedIn
+
+   Alternativas:
+      • content-sourcer: Busca fontes públicas
+      • smart-router: Roteia para perfis de modelo
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### `openclaw ide install` — Instalar AI OS na IDE
+
+**Quando usar:** Para preparar sua IDE para usar o OpenClaw como agente via chat. Instala skills, rules, hooks e state templates.
+
+```bash
+# Simula a instalação (mostra o plano)
+npx @fabioforest/openclaw ide install
+
+# Aplica a instalação
+npx @fabioforest/openclaw ide install --apply
+
+# Força reinstalação completa
+npx @fabioforest/openclaw ide install --apply --force
+```
+
+**O que é instalado:**
 
 ```
 .agent/
-├── agents/            # Personas de agente (ex: sysadmin-proativo)
-├── hooks/             # Hooks de segurança (PreToolUse)
-├── rules/             # Guardrails de segurança
-├── skills/
-│   ├── universal-setup/   # Wizard de configuração interativo
-│   └── openclaw-ops/      # 8 skills operacionais
-└── workflows/         # Runbooks e slash commands
+├── agents/            # Personas (sysadmin, automator, setup)
+├── hooks/             # pre-tool-use.js (bloqueia comandos destrutivos)
+├── rules/             # 5 regras de segurança
+│   ├── CONSENT_FIRST.md
+│   ├── SECURITY.md
+│   ├── ROUTER_PROTOCOL.md
+│   ├── DEV_MODE.md
+│   └── WEB_AUTOMATION.md
+├── skills/            # 15 skills disponíveis
+│   ├── openclaw-router/       # Roteador central chat-first
+│   ├── openclaw-inspect/      # Inspeção read-only
+│   ├── smart-router/          # Roteador econômico de modelos
+│   ├── mission-control/       # Empresa de Agentes
+│   ├── linkedin-optimizer/    # Otimização de LinkedIn
+│   ├── drive-organizer/       # Google Drive via API
+│   ├── site-tester/           # Lighthouse + Playwright
+│   ├── web-scraper/           # Scraping responsável
+│   ├── content-sourcer/       # Pesquisa de fontes
+│   └── ... (+ 6 skills operacionais)
+├── state/             # Estado persistente
+│   ├── mission_control.json   # Empresa de Agentes
+│   └── MEMORY.md              # Memória do workspace
+└── workflows/         # Slash commands e runbooks
+```
+
+---
+
+### `openclaw ide doctor` — Verificar IDE
+
+**Quando usar:** Para confirmar que sua IDE está "armada" com todas as regras e skills necessárias.
+
+```bash
+npx @fabioforest/openclaw ide doctor
+```
+
+**Saída de exemplo:**
+
+```
+🏥 IDE Doctor — Verificando instalação para IDE:
+
+   ✅ .agent/
+   ✅ rules/CONSENT_FIRST.md
+   ✅ rules/ROUTER_PROTOCOL.md
+   ✅ skills/openclaw-router/SKILL.md
+   ✅ skills/openclaw-inspect/SKILL.md
+   ✅ skills/openclaw-dev/SKILL.md
+   ✅ hooks/pre-tool-use.js
+
+🎉 IDE está totalmente configurada!
+```
+
+---
+
+### `openclaw status` — Ver status da instalação
+
+**Quando usar:** Para ver rapidamente o que está instalado e configurado.
+
+```bash
+npx @fabioforest/openclaw status
+```
+
+Mostra: componentes instalados, versão, config ativa (com tokens mascarados).
+
+---
+
+### `openclaw doctor` — Healthcheck completo
+
+**Quando usar:** Quando algo não funciona. Faz diagnóstico completo do ambiente.
+
+```bash
+npx @fabioforest/openclaw doctor
+npx @fabioforest/openclaw doctor --quiet  # Saída mínima
+```
+
+Verifica: config, portas, VPN, integridade de arquivos, dependências.
+
+---
+
+### `openclaw setup` — Wizard interativo
+
+**Quando usar:** Primeira configuração completa com perguntas guiadas.
+
+```bash
+npx @fabioforest/openclaw setup
+```
+
+Guia passo a passo para configurar ambiente, modelo de IA, canais e segurança.
+
+---
+
+### `openclaw check` — Orquestrador inteligente
+
+**Quando usar:** Quando não sabe se precisa instalar ou reparar. Ele decide por você.
+
+```bash
+npx @fabioforest/openclaw check
+```
+
+Detecta se o OpenClaw já existe e oferece opções: instalar, atualizar, reparar ou forçar.
+
+---
+
+### `openclaw debug` — Diagnóstico avançado
+
+**Quando usar:** Problemas de rede, VPN, npm ou GitHub.
+
+```bash
+npx @fabioforest/openclaw debug
 ```
 
-### Skills Operacionais
+Verifica conectividade, proxy, versões e integridade do ambiente.
+
+---
+
+## 🧠 Skills Disponíveis (15)
+
+### Core — Infraestrutura do AI OS
+
+| Skill | O que faz | Quando usar |
+|-------|-----------|-------------|
+| `openclaw-router` | Roteador central chat-first | Sempre ativo — decide qual skill usar |
+| `openclaw-inspect` | Inspeção read-only | Para analisar sem alterar |
+| `openclaw-dev` | Modo Devin-like | Para criar features, backend, frontend |
+| `openclaw-security` | Hardening | Para melhorar segurança do workspace |
+| `openclaw-assist` | Assistente geral | Para menu de ações e ajuda |
+| `mission-control` | Empresa de Agentes | Para orquestrar múltiplos agentes |
+| `smart-router` | Roteador econômico | Para escolher modelo de IA por custo |
+| `context-flush` | Flush de memória | Para economizar tokens em sessões longas |
+
+### Produtividade — Automação e Web
+
+| Skill | O que faz | Quando usar |
+|-------|-----------|-------------|
+| `linkedin-optimizer` | Textos para LinkedIn | Para otimizar perfil/posts (human-in-the-loop) |
+| `drive-organizer` | Google Drive via API | Para organizar arquivos na nuvem |
+| `site-tester` | Lighthouse + Playwright | Para testar performance/SEO/acessibilidade |
+| `web-scraper` | Scraping responsável | Para extrair dados de sites |
+| `content-sourcer` | Pesquisa de fontes | Para criar dossiês citáveis |
+
+### Operacionais — DevOps e Infra
+
+| Skill | O que faz | Quando usar |
+|-------|-----------|-------------|
+| `universal-setup` | Setup em qualquer ambiente | Para instalação em VPS/Docker/Mac/Windows |
+| `openclaw-installation-debugger` | Debug de instalação | Para resolver problemas de setup |
+
+---
+
+## 🔒 Segurança
+
+O OpenClaw segue 3 princípios fundamentais:
+
+### 1. Read-only por padrão
+Todo comando opera em **modo PLAN** (simulação). Nada é alterado sem `--apply`.
+
+### 2. Consent-first
+Antes de qualquer alteração, o sistema mostra exatamente o que vai fazer e pede confirmação. Ações destrutivas exigem **confirmação forte** (digitar frase específica).
+
+### 3. Audit-first
+Toda ação gera log detalhado em `.agent/audit/` com timestamp, comando, modo, contexto e resultado.
+
+### Proteções ativas
 
-| # | Skill | Descrição |
-|---|-------|-----------|
-| 01 | VPN WireGuard | Provisiona VPN entre VPS e hosts |
-| 02 | Enroll Host | Onboarding com aprovação humana |
-| 03 | Policy Baseline | RBAC + allowlists deny-by-default |
-| 04 | Remote Exec | Runbooks com timeout e auditoria |
-| 05 | File Transfer | Transferência com hash e allowlist |
-| 06 | Audit Logging | Log JSON com redaction de segredos |
-| 07 | Safe Update | Canary + rollback automático |
-| 08 | Healthchecks | Circuit breaker + auto-restart |
+| Proteção | Como funciona |
+|----------|---------------|
+| **Hook pre-tool-use** | Bloqueia 12+ padrões destrutivos (`rm -rf`, `mkfs`, `dd`, `shutdown`) |
+| **VPN-first** | Sem VPN, sem acesso remoto |
+| **Bind localhost** | Serviços só acessíveis localmente por padrão |
+| **Auth token** | Token obrigatório para acesso |
+| **Break-glass** | Acesso emergencial com expiração automática |
+| **WEB_AUTOMATION rule** | Checklist de compliance para automação web |
 
-## Segurança
+---
 
-- **VPN-first** — sem VPN, sem acesso remoto
-- **bind localhost** + **auth token** por padrão
-- **Hook `pre-tool-use`** — bloqueia comandos destrutivos (`rm -rf`, `mkfs`, `dd`, `shutdown`)
-- **Break-glass** — acesso emergencial com expiração automática
-- **Auditoria** — todos os eventos logados com `request_id`
+## 💰 Roteador Econômico de Modelos
 
-## Desenvolvimento
+O `smart-router` escolhe automaticamente o modelo de IA mais econômico para cada tarefa:
+
+| Perfil | Quando | Provedor default (free) |
+|--------|--------|------------------------|
+| **cheap** | Tarefas simples, formatação, resumos | Gemini Flash-Lite → Groq |
+| **smart** | Planejamento, análise, raciocínio | Gemini Pro → Claude |
+| **coding** | Código, debug, refactor, testes | Gemini Pro → GPT-5.2 |
+
+Prioridade: **free-first** — só usa provedores pagos com autorização explícita.
+
+---
+
+## 🚀 Guia Rápido: Do Zero ao Funcionando
+
+```bash
+# 1. Instale no seu projeto
+npx @fabioforest/openclaw ide install --apply
+
+# 2. Verifique se está tudo OK
+npx @fabioforest/openclaw ide doctor
+
+# 3. Analise seu ambiente
+npx @fabioforest/openclaw inspect
+
+# 4. Use o assistente
+npx @fabioforest/openclaw assist
+```
+
+**Ou via chat na IDE (Cursor, VSCode, Antigravity, Gemini):**
+- Basta perguntar no chat! As skills e rules em `.agent/` guiam o agente automaticamente.
+- O `openclaw-router` decide qual skill usar com base nos triggers de cada uma.
+- Tudo segue o fluxo: **INSPECT → PLAN → CONSENT → APPLY → AUDIT**.
+
+---
+
+## 🛠️ Desenvolvimento
 
 ```bash
 # Instalar dependências
@@ -83,6 +435,25 @@ npm run test:watch
 npm run test:coverage
 ```
 
-## Licença
+---
+
+## 📋 Flags Globais
+
+Todas as flags funcionam com qualquer comando:
+
+| Flag | Descrição | Padrão |
+|------|-----------|--------|
+| `--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 |
+| `--path, -p <dir>` | Diretório alvo | `./` |
+| `--quiet, -q` | Saída mínima | Não |
+| `--no-audit` | Desabilita logs de auditoria | Não |
+| `--merge` | Atualização segura (preserva customizações) | Não |
+
+---
+
+## 📄 Licença
 
 MIT

package/bin/openclaw.js

@@ -28,6 +28,9 @@ const COMMANDS = {
     doctor: "../lib/cli/doctor",
     debug: "../lib/cli/debug",
     check: "../lib/cli/orchestrate",
+    inspect: "../lib/cli/inspect",
+    assist: "../lib/cli/assist",
+    ide: "../lib/cli/ide",
 };
 
 /**
@@ -36,7 +39,10 @@ const COMMANDS = {
  * @returns {{ command: string|null, flags: object }}
  */
 function parseArgs(argv) {
-    const flags = {};
+    const flags = {
+        plan: true, // Default: PLAN mode (read-only)
+        audit: true // Default: Generate audit logs
+    };
     let command = null;
 
     for (let i = 0; i < argv.length; i++) {
@@ -49,15 +55,28 @@ function parseArgs(argv) {
         } else if (arg === "--force" || arg === "-f") {
             flags.force = true;
         } else if (arg === "--path" || arg === "-p") {
-            // Próximo argumento é o caminho
             flags.path = argv[++i] || ".";
         } else if (arg === "--quiet" || arg === "-q") {
             flags.quiet = true;
+        } else if (arg === "--apply") {
+            flags.apply = true;
+            flags.plan = false; // Apply overrides Plan default
+        } else if (arg === "--plan") {
+            flags.plan = true;
+        } else if (arg === "--yes" || arg === "-y") {
+            flags.yes = true;
+        } else if (arg === "--no-audit") {
+            flags.audit = false;
+        } else if (arg === "--merge") {
+            flags.merge = true;
         } else if (!arg.startsWith("-") && !command) {
             command = arg;
         }
     }
 
+    // Se apply foi passado, plan é false (a menos que forçado explicitamente, mas apply vence na lógica acima)
+    // Se o usuário não passar nada, plan=true (default)
+
     return { command, flags };
 }
 
@@ -78,19 +97,29 @@ function showHelp() {
     setup     Roda wizard interativo de configuração
     debug     Diagnóstico avançado de instalação e rede
     check     Orquestrador inteligente (instala ou repara)
+    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)
 
-  Opções:
+  Opções Globais:
     --path, -p <dir>   Diretório alvo (padrão: ./)
-    --force, -f        Sobrescreve .agent/ existente (init)
+    --plan             Modo Simulação (PADRÃO): Mostra o que será feito sem alterar nada
+    --apply            Modo Execução: Aplica as alterações propostas
+    --yes, -y          Confirma automaticamente (skip prompts)
+    --force, -f        Permite operações destrutivas (exige confirmação forte)
+    --no-audit         Desabilita geração de logs de auditoria
+    --merge            Atualização segura (não sobrescreve customizações)
     --quiet, -q        Saída mínima
     --help, -h         Mostra esta ajuda
     --version, -v      Mostra a versão
 
   Exemplos:
-    npx openclaw init
-    npx openclaw init --force --path ./meu-projeto
-    npx openclaw doctor
-    npx openclaw status
+    npx openclaw init --plan           (Simula instalação)
+    npx openclaw init --apply          (Instala de fato)
+    npx openclaw check                 (Orquestrador seguro)
+    npx openclaw inspect               (Analisa contexto)
+    npx openclaw assist                (Assistente geral)
+    npx openclaw ide install --apply   (Instala AI OS na IDE)
 `);
 }
 

package/lib/cli/assist.js

@@ -0,0 +1,84 @@
+"use strict";
+
+/**
+ * Comando CLI: assist
+ *
+ * Assistente geral do OpenClaw AI OS.
+ * Detecta contexto, roteia para a skill correta e apresenta plano.
+ * Funciona tanto via terminal quanto como "cérebro" para IDEs (chat-first).
+ */
+
+const path = require("path");
+const readline = require("readline");
+const collectContext = require("../context/collector");
+const { matchSkill } = require("../router/match");
+
+// Caminho dos templates e skills do pacote
+const TEMPLATES_DIR = path.join(__dirname, "..", "..", "templates");
+const SKILLS_DIR = path.join(TEMPLATES_DIR, ".agent", "skills");
+
+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()); }));
+}
+
+/**
+ * Executa o comando assist (menu interativo com roteamento de skills).
+ * @param {object} options
+ * @param {string} options.targetPath — diretório alvo
+ * @param {object} options.flags — flags do CLI
+ */
+async function run({ targetPath, flags }) {
+    // 1. Coletar contexto (read-only)
+    const ctx = collectContext({
+        targetPath,
+        templatesDir: TEMPLATES_DIR,
+    });
+
+    console.log("\n🧠 OpenClaw Assist — Modo PLAN por padrão (seguro)\n");
+    console.log(`   IDE: ${ctx.ide} | OpenClaw: ${ctx.openclaw.hasAgentDir ? "instalado" : "não instalado"}`);
+    console.log(`   Plataforma: ${ctx.env.platform} | Docker: ${ctx.env.docker}\n`);
+
+    // 2. Se não tem OpenClaw instalado, sugerir instalação
+    if (!ctx.openclaw.hasAgentDir) {
+        console.log("⚠️  OpenClaw não detectado neste workspace.");
+        console.log("   Rode: npx openclaw init --apply  (para instalar)\n");
+        return;
+    }
+
+    // 3. Pedir solicitação do usuário
+    console.log("Descreva o que deseja fazer:");
+    console.log("  (ex: 'criar skill', 'melhorar segurança', 'mission control tick')\n");
+    const request = await ask("> ");
+
+    if (!request) {
+        console.log("⏹️  Nenhuma solicitação. Saindo.");
+        return;
+    }
+
+    // 4. Rotear para skill correta
+    const match = matchSkill({ skillsDir: SKILLS_DIR, userText: request });
+
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    if (match.chosen) {
+        console.log(`🎯 Skill selecionada: ${match.chosen.name}`);
+        console.log(`   Descrição: ${match.chosen.description}`);
+    } else {
+        console.log("❓ Nenhuma skill correspondente encontrada.");
+        console.log("   Tente reformular a solicitação ou use 'openclaw inspect' para ver skills disponíveis.");
+    }
+
+    if (match.alternatives.length > 0) {
+        console.log(`\n   Alternativas:`);
+        match.alternatives.forEach(a => console.log(`      • ${a.name}: ${a.description}`));
+    }
+
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("\n✅ Protocolo recomendado:");
+    console.log("   1) Rodar INSPECT (read-only) e revisar o contexto");
+    console.log("   2) Descrever exatamente o que quer alterar");
+    console.log("   3) Confirmar APPLY para executar");
+    console.log("   4) Tudo será registrado em .agent/audit/\n");
+}
+
+module.exports = { run };