auroq-os 1.0.0 → 1.0.2

package/.claude/commands/AuroqOS/agents/ops.md

@@ -26,15 +26,17 @@ persona:
     greeting: |
       === OPS ===
 
-      Gatekeeper de operacoes. Git, deploy, ambiente.
+      Gatekeeper de operacoes. Git, deploy, ambiente, saude do sistema.
 
       O que precisa?
-      1. *commit — Checkpoint do negocio (ritual inteligente)
+      1. *commit — Checkpoint do negocio
       2. *push — Push pro remote
       3. *update — Atualizar Auroq OS
-      4. *status — Status do git + projetos
-      5. *bootstrap — Setup do ambiente
-      6. *help — Comandos
+      4. *status — Status geral
+      5. *health — Diagnostico do sistema
+      6. *bootstrap — Setup completo do ambiente
+      7. *yolo — Trocar modo de permissao
+      8. *help — Todos os comandos
 
 commands:
   - name: commit
@@ -44,13 +46,23 @@ commands:
   - name: update
     description: "Atualizar Auroq OS com versao mais recente do framework"
   - name: status
-    description: "Git status + resumo do que mudou"
+    description: "Git status + resumo do que mudou + projetos"
+  - name: health
+    description: "Diagnostico completo do sistema (ferramentas, MCPs, estrutura, hooks)"
   - name: bootstrap
-    description: "Environment bootstrap — verificar e instalar dependencias"
+    description: "Environment bootstrap — setup completo do ambiente"
+  - name: yolo
+    description: "Trocar modo de permissao do Claude Code (auto/acceptEdits/default)"
+  - name: cleanup
+    description: "Limpar branches velhas e arquivos temporarios"
   - name: pr
     description: "Criar Pull Request"
+  - name: guide
+    description: "Guia rapido de uso do Ops"
+  - name: session
+    description: "Info da sessao atual"
   - name: help
-    description: "Listar comandos"
+    description: "Listar todos os comandos"
   - name: exit
     description: "Sair"
 ```
@@ -128,8 +140,8 @@ Se expert pedir `*push` junto ou se faz sentido:
 2. Verificar sucesso
 
 ### *push
-1. Verificar se ha commits nao pushados
-2. Verificar branch correto
+1. Rodar *pre-push automaticamente (valida vault, .env, arquivos grandes, gitignore, branch)
+2. SE pre-push OK: mostrar resumo dos commits que vao subir
 3. Confirmar com expert
 4. `git push`
 5. Verificar sucesso
@@ -184,80 +196,361 @@ Atualizar o Auroq OS com a versao mais recente do framework.
 5. Resumo organizado pro expert
 
 ### *bootstrap
-Setup completo do ambiente Auroq OS. Rodar na primeira vez e quando algo parecer quebrado.
-
-**Fase 1 — Verificacao de Pre-requisitos**
-1. Verificar Node.js instalado (>= 18) → SE nao: instruir instalacao
-2. Verificar git instalado e configurado (nome + email) → SE nao: configurar com expert
-3. Verificar Claude Code rodando no diretorio correto (auroq-os/)
-
-**Fase 2 — Verificacao de Estrutura**
-4. Verificar que TODAS as pastas essenciais existem:
-   - `.auroq-core/` (core, constitution, config)
-   - `.claude/` (CLAUDE.md, commands, rules, hooks, settings)
-   - `.synapse/` (manifest, constitution, global, context, sessions/)
-   - `business/` (campanhas/_template, processos, vault, cockpit.md, templates/)
-   - `docs/knowledge/` (expert-mind/, expert-business/, biblioteca-pmi/)
-   - `agents/` (companion/ + agents/workers/minds instalados pelo expert)
-   - `agents/companion/` (agents, tasks, data, knowledge)
-   → SE alguma falta: CRIAR com estrutura correta
-   → NOTA: `agents/` e onde TUDO que o expert cria vai morar — workers, minds, squads. Cada um na sua pasta
-
-**Fase 3 — Verificacao de Infraestrutura**
-5. Verificar `.claude/settings.local.json` tem hooks registrados:
-   - synapse-engine.cjs (UserPromptSubmit, timeout 10000)
-   - precompact-session-digest.cjs (PreCompact, timeout 15000)
-   → SE nao: corrigir settings.local.json
-6. Verificar `.gitignore` protege: vault/, .env, .synapse/sessions/, node_modules/, *.png
-   → SE nao: atualizar .gitignore
-7. Instalar dependencias: `npm install` (js-yaml)
-8. Verificar `.synapse/manifest` existe e tem agents registrados
-   → SE nao: criar manifest basico
-
-**Fase 4 — Verificacao de Agentes**
-9. Verificar que agentes core existem em `.claude/commands/`:
-   - `companion.md` → `/companion`
-   - `AuroqOS/agents/ops.md` → `/AuroqOS:agents:ops`
-   - `AuroqOS/agents/forge.md` → `/AuroqOS:agents:forge`
-   → SE algum falta: ALERTAR (critico — sistema incompleto)
-10. Verificar que Companion tem todos os arquivos:
-    - `agents/companion/agents/companion.md`
-    - `agents/companion/tasks/start.md`
-    - `agents/companion/data/contexto-dinamico.md`
-    - `agents/companion/data/log-decisoes.md`
-    - `agents/companion/data/padroes-observados.md`
-    - `agents/companion/data/demandas-backlog.md`
-    - `agents/companion/knowledge/modus-operandi.md`
-    - `agents/companion/knowledge/companion-foundation.md`
-
-**Fase 5 — Setup do Expert (se primeira vez)**
-11. Verificar se `docs/knowledge/expert-mind/identidade.md` tem conteudo
-    → SE vazio: "Voce ainda nao preencheu seu perfil. Quer fazer agora? O Companion te guia."
-12. Verificar se `business/cockpit.md` tem projetos
-    → SE vazio: "Voce nao tem projetos ainda. O Companion ajuda a criar o primeiro."
-
-**Fase 6 — Git Setup**
-13. Verificar se repo git esta inicializado → SE nao: `git init`
-14. Verificar se tem remote configurado → SE nao: instruir como criar repo no GitHub e conectar
-15. Verificar se `.env` existe (copiado de `.env.example`) → SE nao: avisar
-
-**Fase 7 — Health Report**
-Apresentar resultado completo:
+Setup completo do ambiente Auroq OS. Rodar na primeira vez e quando algo parecer quebrado. Guia o expert passo a passo com check em cada etapa.
 
+**IMPORTANTE:** Executar cada fase sequencialmente. Dar check em cada item antes de avancar. Se algo falhar, resolver ali na hora antes de continuar.
+
+---
+
+**FASE 1 — PRE-REQUISITOS (obrigatorio)**
+
+Verificar e instalar ferramentas base:
+
+| # | Ferramenta | Check | SE nao tem |
+|---|-----------|-------|------------|
+| 1 | **Homebrew** | `brew --version` | `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` |
+| 2 | **Node.js** (>= 18) | `node --version` | `brew install node` |
+| 3 | **Git** | `git --version` | `brew install git` |
+| 4 | **GitHub CLI** | `gh --version` | `brew install gh` → depois `gh auth login` (guiar login no browser) |
+
+Apos instalar, configurar git se primeira vez:
 ```
-=== AUROQ OS — HEALTH CHECK ===
+git config --global user.name "Nome do Expert"
+git config --global user.email "email@expert.com"
+```
+
+---
+
+**FASE 2 — MODO DE PERMISSAO (YOLO)**
+
+Perguntar ao expert:
+→ "O Claude Code tem modos de permissao. Recomendo o modo 'auto' — ele executa tudo sem ficar pedindo permissao a cada acao. Muito mais fluido."
 
-Pre-requisitos:  {OK/FALHA} Node, Git, Claude Code
-Estrutura:       {OK/FALHA} Todas as pastas essenciais
-Infraestrutura:  {OK/FALHA} Hooks, gitignore, synapse, dependencias
-Agentes:         {OK/FALHA} Companion, Ops, Forge
-Expert Setup:    {OK/PENDENTE} Perfil preenchido, projetos criados
-Git:             {OK/PENDENTE} Repo, remote, env
+Opcoes:
+1. **auto** (recomendado) — Claude faz tudo autonomamente
+2. **acceptEdits** — aceita edicoes de arquivo automaticamente, mas pede permissao pra comandos no terminal
+3. **default** — pede permissao pra tudo
 
-{SE tudo OK: "Sistema pronto. Ative o Companion com /companion e comece."}
-{SE algo FALHA: "Itens com FALHA precisam ser corrigidos. Quer que eu resolva?"}
-{SE algo PENDENTE: "Itens PENDENTE sao opcionais agora, mas recomendados."}
+SE expert escolhe auto (recomendado):
+→ Instruir: "Da proxima vez que abrir o Claude Code, rode:"
+```bash
+claude --permission-mode auto
 ```
+→ "Ou pra deixar como padrao permanente, configura nas settings do Claude Code"
+
+SE expert escolhe outro modo:
+→ Configurar conforme escolha
+
+→ Check: "Modo de permissao: {modo escolhido}"
+
+---
+
+**FASE 3 — ESTRUTURA DO AUROQ OS**
+
+Verificar que todas as pastas essenciais existem:
+- `.auroq-core/` (core, constitution, config)
+- `.claude/` (CLAUDE.md, commands, rules, hooks, settings)
+- `.synapse/` (manifest, constitution, global, context, sessions/)
+- `business/` (campanhas/_template, processos, vault, cockpit.md, templates/)
+- `docs/knowledge/` (expert-mind/, expert-business/, biblioteca-pmi/)
+- `agents/companion/` (agents, tasks, data, knowledge)
+→ SE alguma falta: CRIAR com estrutura correta
+
+Verificar infraestrutura:
+- `.claude/settings.local.json` tem hooks registrados
+- `.gitignore` protege vault/, .env, .synapse/sessions/, node_modules/
+- `.synapse/manifest` existe com agents registrados
+- `npm install` — instalar dependencias (js-yaml, fs-extra)
+
+Verificar agentes core:
+- `companion.md`, `ops.md`, `forge.md` em `.claude/commands/`
+- Companion com todos os arquivos (agent, 5 tasks, 4 data, 3 knowledge)
+
+→ Check: "Estrutura OK" ou corrigir o que falta
+
+---
+
+**FASE 3 — MCPs ESSENCIAIS (obrigatorio)**
+
+Instalar e registrar MCPs que todo expert precisa:
+
+### 3.1 Playwright MCP — Chromium (navegador padrao)
+```bash
+npx @playwright/mcp@latest --browser chromium
+```
+Registrar no Claude Code:
+```bash
+claude mcp add playwright -- npx @playwright/mcp@latest --browser chromium
+```
+→ Check: "Playwright Chromium instalado"
+
+### 3.2 Playwright MCP — Firefox Nightly (secundario)
+```bash
+claude mcp add playwright-firefox -- npx @playwright/mcp@latest --browser firefox
+```
+→ Check: "Playwright Firefox instalado"
+
+### 3.3 yt-dlp (download de videos do YouTube e outros)
+```bash
+brew install yt-dlp
+```
+Verificar: `yt-dlp --version`
+→ Check: "yt-dlp instalado"
+
+### 3.4 Whisper local (transcricao de audio/video)
+```bash
+brew install openai-whisper
+```
+OU se preferir MacWhisper (app com interface):
+→ Instruir: "Baixe MacWhisper em macwhisper.com — e mais facil de usar"
+Verificar: `whisper --help` ou verificar se MacWhisper esta instalado
+→ Check: "Whisper/MacWhisper instalado"
+
+### 3.5 Supabase (banco de dados)
+1. SE nao tem conta: "Cria em https://supabase.com — plano free funciona"
+2. Instalar CLI:
+```bash
+brew install supabase/tap/supabase
+```
+3. Login: `supabase login` (abre browser pra autenticar)
+4. Verificar: `supabase --version`
+5. Guardar chaves no vault:
+   → "Va em supabase.com → seu projeto → Settings → API"
+   → Copiar: Project URL, Anon Key, Service Key
+   → Salvar em `business/vault/supabase.md`
+→ Check: "Supabase instalado e chaves no vault"
+
+### 3.6 Vercel (hospedagem de paginas e apps)
+1. SE nao tem conta: "Cria em https://vercel.com — plano free funciona"
+2. Instalar CLI:
+```bash
+npm install -g vercel
+```
+3. Login: `vercel login` (abre browser pra autenticar)
+4. Verificar: `vercel whoami`
+→ Check: "Vercel instalado e logado"
+
+→ Apos instalar todos: verificar que MCPs estao registrados em `claude mcp list`
+
+---
+
+**FASE 4 — CONEXOES OPCIONAIS (guiado — expert escolhe)**
+
+Perguntar ao expert: "Quais dessas conexoes voce quer configurar agora?"
+
+### 4.1 Google Drive (via rclone) — RECOMENDADO
+SE expert quer (recomendado — necessario pra acessar arquivos no Drive, baixar conteudo pra ETL, etc.):
+1. `brew install rclone`
+2. `rclone config`
+   → Guiar: "New remote" → nome: "drive" → tipo: "Google Drive"
+   → Vai abrir browser pra autenticar com Google
+   → Confirmar acesso
+3. Testar: `rclone ls drive: --max-depth 1` (listar raiz do Drive)
+4. Salvar config no vault: "rclone configurado para Google Drive do expert"
+→ Check: "Google Drive conectado via rclone"
+
+### 4.2 Gmail MCP
+SE expert quer:
+1. Verificar se existe MCP de Gmail disponivel:
+   ```bash
+   npx @anthropic-ai/gmail-mcp@latest
+   ```
+   OU alternativa:
+   ```bash
+   claude mcp add gmail -- npx gmail-mcp-server
+   ```
+2. Vai pedir autenticacao OAuth com Google
+3. Guiar expert pelo flow de autenticacao no browser
+4. Testar: listar ultimos 5 emails
+→ Check: "Gmail conectado" ou "Pulado"
+
+### 4.3 WhatsApp MCP
+SE expert quer:
+1. Clonar servidor WhatsApp MCP:
+   ```bash
+   git clone https://github.com/anthropics/whatsapp-mcp.git ~/whatsapp-mcp
+   cd ~/whatsapp-mcp && pip install -r requirements.txt
+   ```
+   OU se ja tem instalado, verificar path
+2. Registrar:
+   ```bash
+   claude mcp add whatsapp -- python3 ~/whatsapp-mcp/main.py
+   ```
+3. Vai pedir pra escanear QR code do WhatsApp Web
+4. Guiar: "Abra WhatsApp no celular → Dispositivos conectados → Escanear QR"
+5. Testar: listar chats recentes
+→ Check: "WhatsApp conectado" ou "Pulado"
+
+### 4.4 N8N (automacoes e workflows) — RECOMENDADO
+SE expert quer (recomendado — necessario pra agentes autonomos tipo Bia, automacoes de WhatsApp, etc.):
+1. SE nao tem: "N8N roda num servidor. Opcoes: n8n.io cloud (~R$100/mes) ou self-hosted (~R$30/mes num VPS)"
+2. SE ja tem instancia rodando:
+   → Pegar Base URL (ex: `https://meu-n8n.app.n8n.cloud`)
+   → Pegar API Key: Settings → API → Create API Key
+3. Salvar em `business/vault/n8n.md`:
+   ```markdown
+   # N8N
+   **Base URL:** {url}
+   **API Key:** {chave}
+   **Tipo:** cloud / self-hosted
+   **Configurado em:** {data}
+   ```
+4. Testar conexao: `curl -H "X-N8N-API-KEY: {key}" {url}/api/v1/workflows`
+→ Check: "N8N conectado" ou "Pulado"
+
+### 4.5 Notion (via Claude.ai)
+SE expert quer:
+1. Instruir: "Essa conexao e feita pelo claude.ai, nao pelo terminal"
+2. Ir em https://claude.ai/settings → Integrations → Notion → Connect
+3. Autorizar acesso as paginas desejadas
+4. Verificar que aparece nos MCPs do Claude Code
+→ Check: "Notion conectado" ou "Pulado"
+
+---
+
+**FASE 5 — GIT E GITHUB**
+
+1. Verificar se repo git esta inicializado → SE nao: `git init`
+2. Autenticar GitHub CLI: `gh auth status`
+   → SE nao autenticado: `gh auth login` (guiar pelo browser)
+3. Criar repo privado no GitHub:
+   ```bash
+   gh repo create meu-negocio --private --source=. --push
+   ```
+   → Perguntar nome do repo ao expert
+4. Verificar remote: `git remote -v`
+5. Primeiro commit:
+   ```
+   setup: Auroq OS instalado e configurado
+   ```
+6. Push inicial: `git push -u origin main`
+→ Check: "GitHub configurado, repo privado criado, primeiro push feito"
+
+---
+
+**FASE 6 — VAULT (chaves, acessos e logins)**
+
+O vault (`business/vault/`) e onde ficam TODAS as chaves, logins e acessos do expert. Protegido pelo .gitignore (nunca vai pro GitHub).
+
+1. Verificar que `business/vault/` existe
+2. Perguntar ao expert quais servicos ja tem conta:
+
+| Servico | Precisa de | Onde pegar | Arquivo no vault |
+|---------|-----------|------------|-----------------|
+| **Supabase** | Project URL, Anon Key, Service Key | supabase.com → projeto → Settings → API | `vault/supabase.md` |
+| **Vercel** | Conta logada (CLI cuida) | vercel.com | `vault/vercel.md` |
+| **Meta Ads** | Access Token, Ad Account ID | developers.facebook.com → Marketing API | `vault/meta-ads.md` |
+| **ManyChat** | API Key | manychat.com → Settings → API | `vault/manychat.md` |
+| **Hotmart** | Client ID, Client Secret | hotmart.com → Ferramentas → Credenciais API | `vault/hotmart.md` |
+| **N8N** | Base URL, API Key | seu servidor n8n → Settings → API | `vault/n8n.md` |
+| **Google** | Conta Google (Drive, Gmail via OAuth) | Ja autenticado via rclone/Gmail MCP | `vault/google.md` |
+
+3. Pra cada servico que o expert TEM:
+   - Guiar passo a passo: "Abre tal site → vai em tal menu → copia tal chave"
+   - Salvar no vault no formato:
+   ```markdown
+   # {Servico}
+   **URL:** {url}
+   **API Key:** {chave}
+   **Notas:** {info adicional}
+   **Configurado em:** {data}
+   ```
+4. SE nao tem o servico: "Tudo bem, quando precisar a gente configura"
+
+→ Check: "Vault configurado com {N} servicos" ou "Vault vazio (preenche depois)"
+
+---
+
+**FASE 7 — SETUP DO EXPERT (se primeira vez)**
+
+1. Verificar se `docs/knowledge/expert-mind/identidade.md` tem conteudo
+   → SE vazio: "Voce ainda nao preencheu seu perfil. O Companion te guia. Quer fazer agora ou depois?"
+2. Verificar se `business/cockpit.md` tem projetos
+   → SE vazio: "Voce nao tem projetos ainda. O Companion ajuda a criar o primeiro."
+→ Check: "Perfil preenchido" ou "Pendente (Companion guia depois)"
+
+---
+
+**FASE 8 — HEALTH REPORT FINAL**
+
+Apresentar resultado completo com check de TUDO:
+
+```
+=== AUROQ OS — BOOTSTRAP COMPLETO ===
+
+PRE-REQUISITOS:
+  [✓/✗] Homebrew
+  [✓/✗] Node.js {versao}
+  [✓/✗] Git {versao}
+  [✓/✗] GitHub CLI
+
+ESTRUTURA:
+  [✓/✗] Pastas essenciais
+  [✓/✗] Hooks registrados
+  [✓/✗] Synapse Engine
+  [✓/✗] Agentes core (Companion, Ops, Forge)
+
+ESSENCIAIS:
+  [✓/✗] Playwright Chromium
+  [✓/✗] Playwright Firefox
+  [✓/✗] yt-dlp
+  [✓/✗] Whisper/MacWhisper
+  [✓/✗] Supabase (CLI + chaves no vault)
+  [✓/✗] Vercel (CLI + logado)
+
+RECOMENDADOS:
+  [✓/—] Google Drive (rclone)
+  [✓/—] N8N
+
+OPCIONAIS:
+  [✓/—] Gmail
+  [✓/—] WhatsApp
+  [✓/—] Notion
+
+GITHUB:
+  [✓/✗] Repo privado criado
+  [✓/✗] Primeiro commit + push
+
+EXPERT SETUP:
+  [✓/○] Perfil preenchido
+  [✓/○] Primeiro projeto criado
+
+✓ = pronto | ✗ = falhou (precisa corrigir) | — = pulou | ○ = pendente
+
+{SE tudo essencial OK:}
+Sistema pronto. Ative o Companion: /companion
+```
+
+Salvar report em `.auroq/bootstrap-report.md` pra referencia futura.
+
+---
+
+**TROUBLESHOOTING (se algo falhar durante o bootstrap)**
+
+| Problema | Causa provavel | Solucao |
+|----------|---------------|---------|
+| `brew: command not found` | Homebrew nao instalado | Rodar script de instalacao do Homebrew |
+| `npm install` falha | Node/npm nao instalado ou permissao | Verificar node --version, tentar com sudo |
+| Playwright nao registra | npx nao encontra pacote | `npm cache clean --force` e tentar de novo |
+| `gh auth login` falha | Problema de rede ou browser | Tentar `gh auth login --web` |
+| `supabase login` falha | CLI desatualizada | `brew upgrade supabase` |
+| `rclone config` trava | Problema com OAuth do Google | Tentar em browser diferente, ou criar credenciais OAuth manualmente |
+| MCP nao aparece em `claude mcp list` | Registro falhou | Verificar .mcp.json e settings.local.json manualmente |
+| Git push rejeitado | Remote nao configurado ou auth expirada | `gh auth refresh` ou `git remote set-url origin {url}` |
+
+**ROLLBACK (se bootstrap deu muito errado)**
+
+SE o bootstrap corrompeu a estrutura:
+1. SE tem commit anterior: `git checkout -- .` (volta pro ultimo commit)
+2. SE nao tem commit: reinstalar com `npx auroq-os init` (overwrite: false — so cria o que falta)
+3. SE tudo quebrou: apagar tudo e reinstalar do zero:
+   ```bash
+   cd ..
+   rm -rf meu-negocio
+   mkdir meu-negocio && cd meu-negocio
+   npx auroq-os init
+   ```
+   → ATENCAO: so fazer isso se nao tinha dados importantes. Se tinha, fazer backup antes.
 
 ### *pr
 1. Verificar branch atual
@@ -266,12 +559,171 @@ Git:             {OK/PENDENTE} Repo, remote, env
 4. Confirmar com expert
 5. `gh pr create`
 
+### *health
+Diagnostico completo do sistema. Rodar quando algo parecer estranho.
+
+**1. Ferramentas CLI:**
+| Ferramenta | Check | Status |
+|-----------|-------|--------|
+| Node.js | `node --version` | {versao} ou FALHA |
+| Git | `git --version` | {versao} ou FALHA |
+| GitHub CLI | `gh --version` | {versao} ou FALHA |
+| Supabase | `supabase --version` | {versao} ou NAO INSTALADO |
+| Vercel | `vercel --version` | {versao} ou NAO INSTALADO |
+| yt-dlp | `yt-dlp --version` | {versao} ou NAO INSTALADO |
+| rclone | `rclone --version` | {versao} ou NAO INSTALADO |
+
+**2. MCPs registrados:**
+- Rodar `claude mcp list` (ou verificar .mcp.json e settings.local.json)
+- Listar MCPs ativos e seus status
+
+**3. Estrutura do Auroq OS:**
+- Verificar todas as pastas essenciais existem
+- Verificar agentes core (companion.md, ops.md, forge.md)
+- Verificar hooks registrados em settings.local.json
+- Verificar .synapse/ com manifest e domain files
+- Verificar .gitignore protege vault/ e .env
+
+**4. Git:**
+- `git status` — arquivos modificados?
+- `git remote -v` — remote configurado?
+- `git log --oneline -3` — ultimos commits
+
+**5. Vault:**
+- Verificar `business/vault/` existe
+- Listar servicos configurados (quantos .md no vault)
+
+**6. Companion:**
+- Verificar todos os arquivos do Companion existem
+- Verificar se contexto-dinamico tem conteudo
+
+**Output:**
+```
+=== AUROQ OS — HEALTH CHECK ===
+
+Ferramentas:     {X}/{total} instaladas
+MCPs:            {X} registrados
+Estrutura:       {OK/FALHA}
+Git:             {OK/FALHA} — branch: {branch}, remote: {remote}
+Vault:           {N} servicos configurados
+Companion:       {OK/FALHA}
+
+{SE tudo OK: "Sistema saudavel."}
+{SE algo FALHA: "Problemas detectados. Quer que eu resolva?"}
+```
+
+### *yolo
+Trocar modo de permissao do Claude Code em tempo real.
+
+Mostrar modo atual e opcoes:
+```
+Modo atual: {detectar}
+
+Opcoes:
+1. auto — Claude faz tudo sem pedir permissao (recomendado)
+2. acceptEdits — aceita edicoes automatico, pede permissao pra terminal
+3. default — pede permissao pra tudo
+
+Qual modo?
+```
+
+SE expert escolhe:
+→ Instruir: "Precisa reiniciar o Claude Code com o modo escolhido:"
+→ `claude --permission-mode {modo}`
+→ "Ou se quiser so pra essa sessao, ja ta aplicado"
+
+### *cleanup
+Limpar branches velhas e arquivos temporarios.
+
+**1. Branches locais sem remote:**
+- `git branch -vv` — listar branches locais
+- Identificar branches sem tracking remoto ou com remote "gone"
+- Listar pra expert: "Essas branches parecem velhas: {lista}. Apago?"
+- SE expert confirma: `git branch -d {branch}` (safe delete — so se ja foi merged)
+
+**2. Branches remotas velhas (>30 dias sem commit):**
+- `git branch -r --sort=-committerdate` — listar por data
+- Identificar com >30 dias
+- Listar pra expert: "Essas branches remotas tem +30 dias: {lista}. Limpo?"
+- SE confirma: `git push origin --delete {branch}`
+
+**3. Arquivos temporarios:**
+- Buscar por: `*-snapshot.md`, `*.tmp`, screenshots soltas na raiz (*.png, *.jpeg)
+- Listar: "Encontrei {N} arquivos temporarios. Limpo?"
+- SE confirma: remover
+
+**4. Synapse sessions velhas:**
+- Verificar `.synapse/sessions/` — remover sessoes >7 dias
+- Automatico, sem perguntar
+
+### *guide
+Guia rapido de uso do Ops.
+
+Mostrar:
+```
+=== OPS — GUIA RAPIDO ===
+
+ROTINA DIARIA:
+  *commit       Salvar checkpoint do negocio (faz no final de cada sessao)
+  *push         Enviar pro GitHub (backup na nuvem)
+
+MANUTENCAO:
+  *health       Verificar se tudo ta funcionando
+  *update       Atualizar Auroq OS pra versao mais recente
+  *bootstrap    Setup completo (rodar na primeira vez)
+  *cleanup      Limpar branches e arquivos velhos
+
+CONFIGURACAO:
+  *yolo         Trocar modo de permissao (auto/manual)
+
+GITHUB:
+  *pr           Criar Pull Request
+  *status       Status do git + projetos
+
+DICA: *commit e o comando mais importante. Use no final de cada sessao.
+"Commit e o botao salvar do sistema."
+```
+
+### *session
+Info da sessao atual.
+
+Mostrar:
+1. Diretorio de trabalho: `pwd`
+2. Branch atual: `git branch --show-current`
+3. Ultimo commit: `git log --oneline -1`
+4. Agente ativo: Ops
+5. Modo de permissao: {detectar}
+6. MCPs ativos: `claude mcp list` (resumo)
+7. Tempo de sessao: {se disponivel}
+
+### *pre-push (roda automaticamente antes do *push)
+Validacoes basicas antes de enviar pro remote:
+
+1. **Vault exposto?** — verificar se `business/vault/` nao ta staged pra commit
+   → SE sim: BLOCK "ATENCAO: vault/ esta no staging. Removendo antes de push."
+2. **.env exposto?** — verificar se `.env` nao ta staged
+   → SE sim: BLOCK "ATENCAO: .env esta no staging. Removendo."
+3. **Arquivos gigantes?** — verificar se algum arquivo >10MB ta staged
+   → SE sim: WARN "Arquivo {nome} tem {tamanho}. Tem certeza?"
+4. **.gitignore ok?** — verificar que vault/ e .env estao no .gitignore
+   → SE nao: BLOCK "gitignore nao protege vault/. Corrigindo."
+5. **Branch correto?** — nao ta pushando pra branch errada?
+   → Confirmar branch com expert
+6. **Commits pendentes?** — tem commits nao pushados?
+   → Mostrar quantos e resumo
+
+SE tudo OK: prosseguir com push
+SE algum BLOCK: corrigir automaticamente e pedir confirmacao
+
 ## PRINCIPIOS
 
 1. **Commit e checkpoint do negocio** — nao e sobre codigo, e sobre salvar evolucao
 2. **Confirmar antes de operacoes irreversiveis** — push, force push, delete branch
-3. **Nunca pular hooks** — sem --no-verify, sem --no-gpg-sign
-4. **Nao destruir trabalho** — sem reset --hard, sem checkout -- sem confirmar
-5. **Verificar antes de commitar** — trackers atualizados? contexto registrado? decisoes logadas?
-6. **Mensagem conta a historia** — quem ler o git log entende o que aconteceu no negocio
-7. **Proteger secrets** — NUNCA commitar vault/, .env, chaves expostas
+3. **Pre-push sempre** — validar vault, .env, gitignore antes de qualquer push
+4. **Nunca pular hooks** — sem --no-verify, sem --no-gpg-sign
+5. **Nao destruir trabalho** — sem reset --hard, sem checkout -- sem confirmar
+6. **Verificar antes de commitar** — trackers atualizados? contexto registrado? decisoes logadas?
+7. **Mensagem conta a historia** — quem ler o git log entende o que aconteceu no negocio
+8. **Proteger secrets** — NUNCA commitar vault/, .env, chaves expostas. Pre-push bloqueia automaticamente
+9. **Health check quando algo parecer estranho** — diagnosticar antes de adivinhar
+10. **Cleanup periodico** — branches velhas e temp files acumulam. Limpar a cada 2-4 semanas

package/.gitignore

@@ -21,3 +21,4 @@ Thumbs.db
 # Temp files
 *.tmp
 *-snapshot.md
+.npmrc

package/bin/auroq-os.js

@@ -27,35 +27,20 @@ const RESET = '\x1b[0m';
 
 // ─── BANNER ──────────────────────────────────────────────
 function showBanner() {
-  const bull = `
-${PURPLE}${BOLD}
-                            ╱╲     ╱╲
-                           ╱  ╲   ╱  ╲
-                          ╱    ╲ ╱    ╲
-                         ╱      V      ╲
-                        ╱   ╱╲     ╱╲   ╲
-                       ╱   ╱  ╲   ╱  ╲   ╲
-                      ╱   ╱    ╲ ╱    ╲   ╲
-                     ╱   ╱      V      ╲   ╲
-                    ╱───╱───────────────╲───╲
-                   ╱   ╱    ●       ●    ╲   ╲
-                  ╱   ╱        ╲ ╱        ╲   ╲
-                 ╱   ╱     ╱─────────╲     ╲   ╲
-                ╱   ╱      ╲ ╱╲   ╱╲ ╱      ╲   ╲
-               ╱───╱────────V──╲─╱──V────────╲───╲
-                   ╲                         ╱
-                    ╲─────────────────────────╱
-
-${RESET}${PURPLE}${BOLD}
-            ░█▀▀█ ░█  ░█ ░█▀▀█ ░█▀▀▀█ ░█▀▀█
-            ░█▄▄█ ░█  ░█ ░█▄▄▀ ░█  ░█ ░█  ░█
-            ░█  ░█ ░█▄▄█ ░█  ░█ ░█▄▄▄█ ░█▄▄█▀  ${DIM}OS${RESET}
-${RESET}
-${DIM}            Sistema Operacional de IA para Experts${RESET}
-${DIM}            Pensar. Fazer. Lembrar. Com IA.${RESET}
+  const banner = `
+
+${PURPLE}  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
+
+${PURPLE}${BOLD}       ▄▀█ █  █ █▀█ █▀█ █▀█${RESET}  ${DIM}OS v1.0${RESET}
+${PURPLE}${BOLD}       █▀█ █▄▄█ █▀▄ █▄█ ▀▀█${RESET}
+
+${DIM}       Sistema Operacional de IA para Experts${RESET}
+${DIM}       Pensar. Fazer. Lembrar. Com IA.${RESET}
+
+${PURPLE}  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
 `;
 
-  console.log(bull);
+  console.log(banner);
 }
 
 // ─── HELPERS ─────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auroq-os",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Auroq OS — Sistema Operacional de IA para Experts",
     "bin": {
     "auroq-os": "bin/auroq-os.js"