auroq-os 1.0.7 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -203,79 +203,88 @@ Setup completo do ambiente Auroq OS. Rodar na primeira vez e quando algo parecer
203
203
 
204
204
  **IMPORTANTE:** Executar cada fase sequencialmente. Dar check em cada item antes de avancar. Se algo falhar, resolver ali na hora antes de continuar.
205
205
 
206
+ **IMPORTANTE — LINGUAGEM:** O expert e leigo em tecnologia. NUNCA assumir que ele sabe o que e terminal, auth, CLI, ou qualquer termo tecnico. Sempre explicar em linguagem simples. Quando mandar abrir algo no browser, dizer exatamente o que vai aparecer e o que fazer. Quando pedir pra voltar pro terminal, dizer "volta pra essa tela preta aqui onde a gente ta conversando".
207
+
208
+ **CRITICAL — OPS FAZ, EXPERT APROVA:**
209
+ O Ops FAZ tudo sozinho. O expert so precisa:
210
+ - Fazer login no browser (GitHub, Vercel, Supabase) quando o Ops abrir a pagina
211
+ - Escolher nome do Companion
212
+ - Responder perguntas simples (nome, email)
213
+ O Ops NUNCA manda o expert rodar comando no terminal. O Ops NUNCA pede pro expert configurar algo tecnico. Se e tecnico, o Ops resolve.
214
+
215
+ **CRITICAL — GATES DE BLOQUEIO:**
216
+ O bootstrap NAO PODE pular fases essenciais. Antes de avancar para a proxima fase, RODAR o comando de verificacao listado. SE o comando falhar = fase NAO completou = NAO avancar.
217
+
218
+ Fases essenciais (BLOCKING — nao pular de jeito nenhum):
219
+ - FASE 1 (pre-requisitos): `node --version` + `git --version` + `gh --version` + `python3 --version` TODOS devem retornar versao
220
+ - FASE 2 (permissao): ler `~/.claude/settings.json` e confirmar `defaultMode: bypassPermissions`
221
+ - FASE 3 (estrutura): verificar existencia de TODAS as pastas + agentes core
222
+ - FASE 5 (GitHub): `gh auth status` DEVE retornar usuario logado + `git remote -v` DEVE mostrar origin
223
+ - FASE 6 (Vercel): `vercel whoami` DEVE retornar username
224
+ - FASE 7 (Supabase): `supabase projects list` NAO DEVE dar erro de auth
225
+
226
+ SE qualquer verificacao falhar:
227
+ 1. PARAR
228
+ 2. Informar o que falhou
229
+ 3. Resolver ali na hora (reinstalar, re-autenticar, refazer)
230
+ 4. Verificar de novo
231
+ 5. SO avancar quando o comando de verificacao PASSAR
232
+
233
+ NUNCA dizer "configurado com sucesso" sem ter rodado o comando de verificacao. NUNCA.
234
+
206
235
  ---
207
236
 
208
237
  **FASE 1 — PRE-REQUISITOS (obrigatorio)**
209
238
 
210
- Verificar e instalar ferramentas base:
239
+ Verificar e instalar ferramentas base. O expert so precisa aceitar as instalacoes — Ops faz o resto.
211
240
 
212
241
  | # | Ferramenta | Check | SE nao tem |
213
242
  |---|-----------|-------|------------|
214
243
  | 1 | **Homebrew** | `brew --version` | `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` |
215
244
  | 2 | **Node.js** (>= 18) | `node --version` | `brew install node` |
216
245
  | 3 | **Git** | `git --version` | `brew install git` |
217
- | 4 | **GitHub CLI** | `gh --version` | `brew install gh` → depois `gh auth login` (guiar login no browser) |
246
+ | 4 | **GitHub CLI** | `gh --version` | `brew install gh` |
247
+ | 5 | **Python 3** | `python3 --version` | `brew install python` |
218
248
 
219
249
  Apos instalar, configurar git se primeira vez:
220
250
  ```
221
251
  git config --global user.name "Nome do Expert"
222
252
  git config --global user.email "email@expert.com"
223
253
  ```
254
+ → Perguntar nome e email ao expert pra configurar.
224
255
 
225
- ---
226
-
227
- **FASE 2 — MODO DE PERMISSAO (YOLO)**
228
-
229
- Perguntar ao expert:
230
- → "O Claude Code tem modos de permissao. Recomendo o modo 'auto' — ele executa tudo sem ficar pedindo permissao a cada acao. Muito mais fluido."
231
-
232
- Opcoes:
233
- 1. **auto** (recomendado) — Claude faz tudo autonomamente
234
- 2. **acceptEdits** — aceita edicoes de arquivo automaticamente, mas pede permissao pra comandos no terminal
235
- 3. **default** — pede permissao pra tudo
236
-
237
- SE expert escolhe auto (recomendado):
238
- → Instruir: "Da proxima vez que abrir o Claude Code, rode:"
239
- ```bash
240
- claude --permission-mode auto
241
- ```
242
- → "Ou pra deixar como padrao permanente, configura nas settings do Claude Code"
243
-
244
- SE expert escolhe outro modo:
245
- → Configurar conforme escolha
246
-
247
- → Check: "Modo de permissao: {modo escolhido}"
256
+ → Check: "Ferramentas base instaladas"
248
257
 
249
258
  ---
250
259
 
251
- **FASE 2.5PERSONALIZAR VISUAL**
252
-
253
- Deixar o Claude Code com a identidade visual do Auroq OS.
254
-
255
- ### Cor da barra de prompt (obrigatorio — nativo)
256
- ```
257
- /color purple
258
- ```
259
- Barra de prompt fica roxa (identidade Auroq OS)
260
- Check: "Prompt bar roxo"
261
-
262
- ### Mascote roxo (opcional — community tool)
263
- Perguntar: "Quer deixar o mascote do Claude Code roxo tambem? (recomendado pra identidade visual)"
264
- SE sim:
265
- 1. Instalar clawd-modifier:
266
- ```bash
267
- npx playbooks add skill openclaw/skills --skill clawd-modifier
268
- ```
269
- 2. Aplicar cor purpura:
270
- ```bash
271
- python scripts/patch_color.py --rgb 120,80,200
272
- ```
273
- 3. Verificar: reiniciar Claude Code e ver mascote roxo
274
- Check: "Mascote roxo" ou "Pulou"
260
+ **FASE 2 — MODO DE PERMISSAO**
261
+
262
+ Configurar automaticamente. **NAO perguntar ao expert. Ops resolve sozinho.**
263
+
264
+ 1. Ler `~/.claude/settings.json` (criar se nao existir)
265
+ 2. Configurar DOIS campos no `permissions`:
266
+ - `"defaultMode": "bypassPermissions"` — modo padrao pra todas as sessoes
267
+ - `"allow"` com todas as tools basicas pre-aprovadas
268
+ 3. Preservar tudo que ja existe no arquivo (hooks, statusLine, etc.)
269
+ 4. Resultado final do bloco `permissions`:
270
+ ```json
271
+ {
272
+ "permissions": {
273
+ "defaultMode": "bypassPermissions",
274
+ "allow": [
275
+ "Bash", "Read", "Write", "Edit", "Glob", "Grep",
276
+ "WebFetch", "WebSearch", "NotebookEdit", "Skill",
277
+ "mcp__playwright__*", "mcp__playwright-firefox__*"
278
+ ],
279
+ "deny": []
280
+ }
281
+ }
282
+ ```
283
+ 5. SE ja tem entries no allow (MCPs do expert): PRESERVAR e adicionar as que faltam
284
+ 6. Informar ao expert (sem perguntar):
285
+ → "Modo de permissao configurado — agora eu executo sem ficar te pedindo confirmacao a cada passo."
275
286
 
276
- ### Nome na tab do terminal (obrigatorio — nativo)
277
- → Ops roda: `/rename {nome do negocio do expert}`
278
- → Check: "Tab renomeada"
287
+ Check: "Modo de permissao: auto (settings.json)"
279
288
 
280
289
  ---
281
290
 
@@ -304,11 +313,11 @@ Verificar agentes core:
304
313
 
305
314
  ---
306
315
 
307
- **FASE 3 — MCPs ESSENCIAIS (obrigatorio)**
316
+ **FASE 4 — MCPs ESSENCIAIS (ferramentas)**
308
317
 
309
- Instalar e registrar MCPs que todo expert precisa:
318
+ Instalar ferramentas que todo expert precisa. NAO inclui servicos (Supabase, Vercel) — esses tem fase propria.
310
319
 
311
- ### 3.1 Playwright MCP — Chromium (navegador padrao)
320
+ ### 4.1 Playwright MCP — Chromium (navegador padrao)
312
321
  ```bash
313
322
  npx @playwright/mcp@latest --browser chromium
314
323
  ```
@@ -318,20 +327,20 @@ claude mcp add playwright -- npx @playwright/mcp@latest --browser chromium
318
327
  ```
319
328
  → Check: "Playwright Chromium instalado"
320
329
 
321
- ### 3.2 Playwright MCP — Firefox Nightly (secundario)
330
+ ### 4.2 Playwright MCP — Firefox Nightly (secundario)
322
331
  ```bash
323
332
  claude mcp add playwright-firefox -- npx @playwright/mcp@latest --browser firefox
324
333
  ```
325
334
  → Check: "Playwright Firefox instalado"
326
335
 
327
- ### 3.3 yt-dlp (download de videos do YouTube e outros)
336
+ ### 4.3 yt-dlp (download de videos do YouTube e outros)
328
337
  ```bash
329
338
  brew install yt-dlp
330
339
  ```
331
340
  Verificar: `yt-dlp --version`
332
341
  → Check: "yt-dlp instalado"
333
342
 
334
- ### 3.4 Whisper local (transcricao de audio/video)
343
+ ### 4.4 Whisper local (transcricao de audio/video)
335
344
  ```bash
336
345
  brew install openai-whisper
337
346
  ```
@@ -340,166 +349,207 @@ OU se preferir MacWhisper (app com interface):
340
349
  Verificar: `whisper --help` ou verificar se MacWhisper esta instalado
341
350
  → Check: "Whisper/MacWhisper instalado"
342
351
 
343
- ### 3.5 Supabase (banco de dados)
344
- 1. SE nao tem conta: "Cria em https://supabase.com — plano free funciona"
345
- 2. Instalar CLI:
346
- ```bash
347
- brew install supabase/tap/supabase
348
- ```
349
- 3. Login: `supabase login` (abre browser pra autenticar)
350
- 4. Verificar: `supabase --version`
351
- 5. Guardar chaves no vault:
352
- → "Va em supabase.com → seu projeto → Settings → API"
353
- → Copiar: Project URL, Anon Key, Service Key
354
- → Salvar em `business/vault/supabase.md`
355
- → Check: "Supabase instalado e chaves no vault"
356
-
357
- ### 3.6 Vercel (hospedagem de paginas e apps)
358
- 1. SE nao tem conta: "Cria em https://vercel.com — plano free funciona"
359
- 2. Instalar CLI:
360
- ```bash
361
- npm install -g vercel
362
- ```
363
- 3. Login: `vercel login` (abre browser pra autenticar)
364
- 4. Verificar: `vercel whoami`
365
- → Check: "Vercel instalado e logado"
366
-
367
- → Apos instalar todos: verificar que MCPs estao registrados em `claude mcp list`
352
+ Apos instalar: verificar que MCPs estao registrados com `claude mcp list`
368
353
 
369
354
  ---
370
355
 
371
- **FASE 4CONEXOES OPCIONAIS (guiadoexpert escolhe)**
356
+ **FASE 5GITHUB (obrigatorioANTES de Vercel e Supabase)**
372
357
 
373
- Perguntar ao expert: "Quais dessas conexoes voce quer configurar agora?"
358
+ GitHub e a base. Com a conta do GitHub, o expert vai conseguir entrar na Vercel e no Supabase sem criar conta separada.
374
359
 
375
- ### 4.1 Google Drive (via rclone) RECOMENDADO
376
- SE expert quer (recomendado — necessario pra acessar arquivos no Drive, baixar conteudo pra ETL, etc.):
377
- 1. `brew install rclone`
378
- 2. `rclone config`
379
- → Guiar: "New remote" → nome: "drive" → tipo: "Google Drive"
380
- → Vai abrir browser pra autenticar com Google
381
- → Confirmar acesso
382
- 3. Testar: `rclone ls drive: --max-depth 1` (listar raiz do Drive)
383
- 4. Salvar config no vault: "rclone configurado para Google Drive do expert"
384
- → Check: "Google Drive conectado via rclone"
360
+ **Ops resolve tudo. Expert so faz login no navegador.**
385
361
 
386
- ### 4.2 Gmail MCP
387
- SE expert quer:
388
- 1. Verificar se existe MCP de Gmail disponivel:
362
+ 1. Verificar se repo git esta inicializado → SE nao: `git init`
363
+ 2. Verificar GitHub CLI: `gh auth status`
364
+ SE nao autenticado:
365
+ - Informar: "Vou abrir uma pagina no seu navegador pra voce entrar no GitHub."
366
+ - Rodar `gh auth login --web --git-protocol https` — vai direto pro browser sem perguntas
367
+ - Isso abre o navegador automaticamente
368
+ - SE expert nao tem conta GitHub:
369
+ → Dizer: "Se voce nao tem conta no GitHub, nessa mesma pagina que abriu voce consegue criar uma. Clica em 'Create an account' e segue os passos. Quando terminar, volta aqui."
370
+ - SE expert ja tem conta:
371
+ → Dizer: "Faz login normalmente. Quando terminar, volta pra essa tela aqui."
372
+ - Verificar sucesso: `gh auth status` — deve mostrar usuario logado
373
+ - SE ainda nao autenticou: esperar e tentar de novo
374
+ 3. Criar repo privado no GitHub:
375
+ → Perguntar: "Qual nome quer dar pro seu repositorio? (sugestao: nome do seu negocio, sem espaco, sem acento)"
389
376
  ```bash
390
- npx @anthropic-ai/gmail-mcp@latest
377
+ gh repo create {nome} --private --source=. --push
391
378
  ```
392
- OU alternativa:
379
+ 4. Verificar remote: `git remote -v`
380
+ 5. Primeiro commit + push:
393
381
  ```bash
394
- claude mcp add gmail -- npx gmail-mcp-server
382
+ git add .
383
+ git commit -m "setup: Auroq OS instalado e configurado"
384
+ git push -u origin main
395
385
  ```
396
- 2. Vai pedir autenticacao OAuth com Google
397
- 3. Guiar expert pelo flow de autenticacao no browser
398
- 4. Testar: listar ultimos 5 emails
399
- → Check: "Gmail conectado" ou "Pulado"
400
386
 
401
- ### 4.3 WhatsApp MCP
402
- SE expert quer:
403
- 1. Clonar servidor WhatsApp MCP:
404
- ```bash
405
- git clone https://github.com/anthropics/whatsapp-mcp.git ~/whatsapp-mcp
406
- cd ~/whatsapp-mcp && pip install -r requirements.txt
407
- ```
408
- OU se ja tem instalado, verificar path
409
- 2. Registrar:
387
+ **GATE DE VERIFICACAO (BLOCKING — nao avancar sem passar):**
388
+ 1. Rodar `gh auth status` — DEVE mostrar "Logged in to github.com as {username}"
389
+ → SE nao: "GitHub nao ta conectado ainda. Vamos tentar de novo." → REPETIR login
390
+ 2. Rodar `git remote -v` — DEVE mostrar origin apontando pro repo
391
+ SE nao: "Repo nao foi criado. Vamos criar." → REPETIR criacao
392
+ 3. Rodar `git log --oneline -1` — DEVE mostrar pelo menos 1 commit
393
+ → SE nao: "Primeiro commit nao foi feito." → REPETIR commit + push
394
+
395
+ **SO avancar pra FASE 6 quando os 3 checks passarem.**
396
+
397
+ → Check: "GitHub configurado, repo privado criado, primeiro push feito"
398
+
399
+ ---
400
+
401
+ **FASE 6 — VERCEL (login com GitHub)**
402
+
403
+ A Vercel hospeda as paginas e apps do expert. Ops resolve tudo — expert so faz login.
404
+
405
+ **IMPORTANTE: O expert JA TEM conta no GitHub (FASE 5). Usar "Continue with GitHub" pra nao criar conta separada.**
406
+
407
+ 1. Instalar CLI (se nao tem):
410
408
  ```bash
411
- claude mcp add whatsapp -- python3 ~/whatsapp-mcp/main.py
409
+ npm install -g vercel
412
410
  ```
413
- 3. Vai pedir pra escanear QR code do WhatsApp Web
414
- 4. Guiar: "Abra WhatsApp no celular → Dispositivos conectados → Escanear QR"
415
- 5. Testar: listar chats recentes
416
- Check: "WhatsApp conectado" ou "Pulado"
417
-
418
- ### 4.4 N8N (automacoes e workflows) — RECOMENDADO
419
- SE expert quer (recomendadonecessario pra agentes autonomos tipo Bia, automacoes de WhatsApp, etc.):
420
- 1. SE nao tem: "N8N roda num servidor. Opcoes: n8n.io cloud (~R$100/mes) ou self-hosted (~R$30/mes num VPS)"
421
- 2. SE ja tem instancia rodando:
422
- → Pegar Base URL (ex: `https://meu-n8n.app.n8n.cloud`)
423
- → Pegar API Key: Settings → API → Create API Key
424
- 3. Salvar em `business/vault/n8n.md`:
411
+ 2. Informar: "Vou abrir uma pagina no navegador pra conectar a Vercel. Quando abrir, clica em 'Continue with GitHub' — assim voce entra com a mesma conta que acabou de criar."
412
+ 3. Rodar `vercel login`
413
+ Isso abre o browser automaticamente
414
+ Expert clica em "Continue with GitHub"
415
+ → Autoriza o acesso
416
+ Volta pro terminal
417
+ 4. Verificar sucesso: `vercel whoami` deve retornar username
418
+ SE falhou: "Parece que o login nao completou. Vou tentar de novo." repetir
419
+ 5. Salvar automaticamente em `business/vault/vercel.md`:
425
420
  ```markdown
426
- # N8N
427
- **Base URL:** {url}
428
- **API Key:** {chave}
429
- **Tipo:** cloud / self-hosted
421
+ # Vercel
422
+ **Username:** {resultado do whoami}
430
423
  **Configurado em:** {data}
431
424
  ```
432
- 4. Testar conexao: `curl -H "X-N8N-API-KEY: {key}" {url}/api/v1/workflows`
433
- Check: "N8N conectado" ou "Pulado"
425
+ **GATE DE VERIFICACAO (BLOCKING):**
426
+ 1. Rodar `vercel whoami` DEVE retornar username
427
+ → SE retorna "Error" ou nao retorna nada: "Vercel nao ta conectada. Vamos tentar de novo." → REPETIR login
428
+ 2. Verificar `business/vault/vercel.md` existe e tem conteudo
429
+ → SE nao: criar o arquivo com os dados do whoami
434
430
 
435
- ### 4.5 Notion (via Claude.ai)
436
- SE expert quer:
437
- 1. Instruir: "Essa conexao e feita pelo claude.ai, nao pelo terminal"
438
- 2. Ir em https://claude.ai/settings → Integrations → Notion → Connect
439
- 3. Autorizar acesso as paginas desejadas
440
- 4. Verificar que aparece nos MCPs do Claude Code
441
- → Check: "Notion conectado" ou "Pulado"
431
+ **SO avancar pra FASE 7 quando os 2 checks passarem.**
432
+
433
+ Check: "Vercel conectada"
442
434
 
443
435
  ---
444
436
 
445
- **FASE 5GIT E GITHUB**
437
+ **FASE 7SUPABASE (login com GitHub)**
446
438
 
447
- 1. Verificar se repo git esta inicializado SE nao: `git init`
448
- 2. Autenticar GitHub CLI: `gh auth status`
449
- SE nao autenticado: `gh auth login` (guiar pelo browser)
450
- 3. Criar repo privado no GitHub:
439
+ O Supabase e o banco de dados do expert. Ops resolve tudo — expert so faz login.
440
+
441
+ **IMPORTANTE: O expert JA TEM conta no GitHub (FASE 5). Usar "Continue with GitHub" pra nao criar conta separada.**
442
+
443
+ 1. Instalar CLI (se nao tem):
451
444
  ```bash
452
- gh repo create meu-negocio --private --source=. --push
445
+ brew install supabase/tap/supabase
453
446
  ```
454
- Perguntar nome do repo ao expert
455
- 4. Verificar remote: `git remote -v`
456
- 5. Primeiro commit:
447
+ 2. Informar: "Vou abrir uma pagina no navegador pra conectar o Supabase. Quando abrir, clica em 'Continue with GitHub' — mesma conta que voce ja criou."
448
+ 3. Rodar `supabase login`
449
+ Isso abre o browser automaticamente
450
+ → Expert clica em "Continue with GitHub"
451
+ → Autoriza o acesso
452
+ → Volta pro terminal
453
+ 4. Verificar sucesso: `supabase projects list` — SE nao da erro de auth, ta logado
454
+ → SE falhou: "Parece que o login nao completou. Vou tentar de novo." → repetir
455
+ 5. SE expert ja tem projeto: listar e pedir pra escolher
456
+ SE nao tem projeto: "Voce ainda nao tem projeto no Supabase. Quando precisar, seu Companion te ajuda a criar. Por enquanto ta conectado."
457
+ 6. SE tem projeto selecionado — capturar chaves automaticamente:
458
+ → Usar Playwright: navegar pra `https://supabase.com/dashboard/project/{ref}/settings/api`
459
+ → Extrair Project URL, Anon Key e Service Key da pagina
460
+ → SE Playwright falhar: pedir pro expert copiar as 3 chaves da tela
461
+ 7. Salvar automaticamente em `business/vault/supabase.md`:
462
+ ```markdown
463
+ # Supabase
464
+ **Project URL:** {url}
465
+ **Anon Key:** {key}
466
+ **Service Key:** {key}
467
+ **Projeto:** {nome}
468
+ **Configurado em:** {data}
457
469
  ```
458
- setup: Auroq OS instalado e configurado
470
+ SE nao tem projeto ainda: salvar so o status de conexao:
471
+ ```markdown
472
+ # Supabase
473
+ **Status:** Conectado (sem projeto ainda)
474
+ **Configurado em:** {data}
459
475
  ```
460
- 6. Push inicial: `git push -u origin main`
461
- Check: "GitHub configurado, repo privado criado, primeiro push feito"
476
+
477
+ **GATE DE VERIFICACAO (BLOCKING):**
478
+ 1. Rodar `supabase projects list 2>&1` — NAO DEVE conter "Error" ou "unauthorized"
479
+ → SE da erro de auth: "Supabase nao ta conectado. Vamos tentar de novo." → REPETIR login
480
+ 2. SE tem projeto com chaves: verificar `business/vault/supabase.md` existe e tem Project URL
481
+ → SE nao: capturar chaves ou criar arquivo minimo
482
+
483
+ **SO avancar pra FASE 8 quando os checks passarem.**
484
+
485
+ → Check: "Supabase conectado"
462
486
 
463
487
  ---
464
488
 
465
- **FASE 6VAULT (chaves, acessos e logins)**
489
+ **FASE 8CONEXOES OPCIONAIS (expert escolhe)**
466
490
 
467
- O vault (`business/vault/`) e onde ficam TODAS as chaves, logins e acessos do expert. Protegido pelo .gitignore (nunca vai pro GitHub).
491
+ Perguntar: "Agora vem a parte opcional. Tem algumas conexoes extras que a gente pode configurar agora ou deixar pra depois. Quais dessas voce quer fazer agora?"
468
492
 
469
- 1. Verificar que `business/vault/` existe
470
- 2. Perguntar ao expert quais servicos ja tem conta:
493
+ Listar:
494
+ 1. **Google Drive** (recomendado necessario pra acessar seus arquivos)
495
+ 2. **Gmail** (ler e enviar emails pelo sistema)
496
+ 3. **WhatsApp** (ler e enviar mensagens)
497
+ 4. **N8N** (automacoes avancadas)
498
+ 5. **Notion** (acessar suas paginas)
499
+ 6. **Nenhuma por enquanto** — pode fazer depois
471
500
 
472
- | Servico | Precisa de | Onde pegar | Arquivo no vault |
473
- |---------|-----------|------------|-----------------|
474
- | **Supabase** | Project URL, Anon Key, Service Key | supabase.com projeto → Settings → API | `vault/supabase.md` |
475
- | **Vercel** | Conta logada (CLI cuida) | vercel.com | `vault/vercel.md` |
476
- | **Meta Ads** | Access Token, Ad Account ID | developers.facebook.com Marketing API | `vault/meta-ads.md` |
477
- | **ManyChat** | API Key | manychat.com Settings → API | `vault/manychat.md` |
478
- | **Hotmart** | Client ID, Client Secret | hotmart.com Ferramentas Credenciais API | `vault/hotmart.md` |
479
- | **N8N** | Base URL, API Key | seu servidor n8n Settings API | `vault/n8n.md` |
480
- | **Google** | Conta Google (Drive, Gmail via OAuth) | Ja autenticado via rclone/Gmail MCP | `vault/google.md` |
501
+ ### 8.1 Google Drive (via rclone) RECOMENDADO
502
+ 1. `brew install rclone`
503
+ 2. `rclone config`
504
+ Guiar: "New remote" nome: "drive" tipo: "Google Drive"
505
+ Informar: "Vai abrir o navegador pra voce autorizar o acesso ao seu Drive."
506
+ Confirmar acesso
507
+ 3. Testar: `rclone ls drive: --max-depth 1`
508
+ Check: "Google Drive conectado"
481
509
 
482
- 3. Pra cada servico que o expert TEM:
483
- - Guiar passo a passo: "Abre tal site → vai em tal menu → copia tal chave"
484
- - Salvar no vault no formato:
485
- ```markdown
486
- # {Servico}
487
- **URL:** {url}
488
- **API Key:** {chave}
489
- **Notas:** {info adicional}
490
- **Configurado em:** {data}
510
+ ### 8.2 Gmail MCP
511
+ 1. ```bash
512
+ claude mcp add gmail -- npx gmail-mcp-server
491
513
  ```
492
- 4. SE nao tem o servico: "Tudo bem, quando precisar a gente configura"
514
+ 2. Informar: "Vai abrir o navegador pra voce autorizar o acesso ao seu Gmail."
515
+ 3. Guiar pelo flow de autenticacao
516
+ 4. Testar: listar ultimos 5 emails
517
+ → Check: "Gmail conectado" ou "Pulado"
493
518
 
494
- Check: "Vault configurado com {N} servicos" ou "Vault vazio (preenche depois)"
519
+ ### 8.3 WhatsApp MCP
520
+ 1. Instalar:
521
+ ```bash
522
+ git clone https://github.com/anthropics/whatsapp-mcp.git ~/whatsapp-mcp
523
+ cd ~/whatsapp-mcp && pip install -r requirements.txt
524
+ ```
525
+ 2. Registrar:
526
+ ```bash
527
+ claude mcp add whatsapp -- python3 ~/whatsapp-mcp/main.py
528
+ ```
529
+ 3. Informar: "Vai aparecer um QR Code na tela. Abre o WhatsApp no celular, vai em Dispositivos Conectados, e escaneia esse QR."
530
+ 4. Testar: listar chats recentes
531
+ → Check: "WhatsApp conectado" ou "Pulado"
532
+
533
+ ### 8.4 N8N (automacoes)
534
+ 1. SE nao tem: "N8N roda num servidor. Opcoes: n8n.io cloud (~R$100/mes) ou self-hosted (~R$30/mes num VPS). Se nao tem, pula — configura depois quando precisar."
535
+ 2. SE ja tem instancia:
536
+ → Pegar Base URL e API Key
537
+ 3. Salvar em `business/vault/n8n.md`
538
+ 4. Testar conexao
539
+ → Check: "N8N conectado" ou "Pulado"
540
+
541
+ ### 8.5 Notion (via Claude.ai)
542
+ 1. Instruir: "Essa conexao e feita pelo site do Claude, nao aqui. Abre claude.ai/settings no navegador, vai em Integrations, e conecta o Notion."
543
+ 2. Verificar que aparece nos MCPs
544
+ → Check: "Notion conectado" ou "Pulado"
495
545
 
496
546
  ---
497
547
 
498
- **FASE 7 — PERSONALIZAR COMPANION**
548
+ **FASE 9 — PERSONALIZAR COMPANION**
499
549
 
500
550
  O Companion e o cerebro do sistema — parceiro cognitivo do expert. Vem com nome generico "Companion" mas o expert escolhe o nome.
501
551
 
502
- 1. Perguntar: "Seu Companion e seu parceiro cognitivo — vai te situar todo dia, lembrar o que importa, pensar junto, rotear pro agente certo e proteger seu foco. Qual nome voce quer dar pra ele? (ex: Jarvis, Atlas, Nova, ou qualquer nome que fizer sentido pra voce)"
552
+ 1. Perguntar: "Agora a parte mais legal. Voce vai dar um nome pro seu parceiro cognitivo — e ele que vai te situar todo dia, lembrar o que importa, pensar junto com voce e proteger seu foco. Qual nome voce quer dar pra ele? (pode ser qualquer coisa: Jarvis, Atlas, Nova, o que fizer sentido pra voce)"
503
553
 
504
554
  2. Expert escolhe o nome. Salvar em variavel {NOME}.
505
555
 
@@ -520,71 +570,99 @@ O Companion e o cerebro do sistema — parceiro cognitivo do expert. Vem com nom
520
570
  - `.claude/CLAUDE.md` — trocar "Companion" por {NOME} e ativacao de `/companion` pra `/{slug}`
521
571
  - `.claude/rules/` — trocar referencias ao "Companion" pelo {NOME} onde aparecer
522
572
 
523
- 6. Confirmar: "Seu Companion agora se chama {NOME}. Ative com /{slug}"
573
+ 6. Confirmar: "Pronto! Seu parceiro agora se chama {NOME}. Pra ativar ele, e so digitar /{slug}"
524
574
 
525
575
  → Check: "Companion personalizado: {NOME} — ativacao: /{slug}"
526
576
 
527
577
  ---
528
578
 
529
- **FASE 8 — SETUP DO EXPERT (se primeira vez)**
579
+ **FASE 10 — SETUP DO EXPERT (se primeira vez)**
530
580
 
531
581
  1. Verificar se `docs/knowledge/expert-mind/identidade.md` tem conteudo
532
- → SE vazio: "Voce ainda nao preencheu seu perfil. O {NOME} te guia. Quer fazer agora ou depois?"
582
+ → SE vazio: "Voce ainda nao preencheu seu perfil. O {NOME} te ajuda com isso quando voce ativar ele, so pede 'me ajuda a preencher meu perfil'."
533
583
  2. Verificar se `business/cockpit.md` tem projetos
534
- → SE vazio: "Voce nao tem projetos ainda. O {NOME} ajuda a criar o primeiro."
535
- → Check: "Perfil preenchido" ou "Pendente (Companion guia depois)"
584
+ → SE vazio: "Voce nao tem projetos ainda. Quando ativar o {NOME}, ele ajuda a criar o primeiro."
585
+ → Check: "Perfil preenchido" ou "Pendente ({NOME} guia depois)"
536
586
 
537
587
  ---
538
588
 
539
- **FASE 8 — HEALTH REPORT FINAL**
589
+ **FASE 11 — HEALTH REPORT FINAL (VERIFICACAO REAL)**
540
590
 
541
- Apresentar resultado completo com check de TUDO:
591
+ **CRITICAL: NAO imprimir [✓] sem rodar o comando de verificacao. Cada item DEVE ser verificado com o comando listado. Se o comando falhar = [✗]. Sem excecao.**
542
592
 
543
- ```
544
- === AUROQ OS — BOOTSTRAP COMPLETO ===
593
+ Rodar TODOS os comandos abaixo e montar o report com os resultados REAIS:
545
594
 
595
+ ```
546
596
  PRE-REQUISITOS:
547
- [✓/✗] Homebrew
548
- [✓/✗] Node.js {versao}
549
- [✓/✗] Git {versao}
550
- [✓/✗] GitHub CLI
597
+ ```
598
+ | Item | Comando de verificacao | ✓ se |
599
+ |------|----------------------|------|
600
+ | Homebrew | `brew --version` | retorna versao |
601
+ | Node.js | `node --version` | retorna v18+ |
602
+ | Git | `git --version` | retorna versao |
603
+ | GitHub CLI | `gh --version` | retorna versao |
604
+ | Python 3 | `python3 --version` | retorna versao |
551
605
 
606
+ ```
552
607
  ESTRUTURA:
553
- [✓/✗] Pastas essenciais
554
- [✓/✗] Hooks registrados
555
- [✓/✗] Synapse Engine
556
- [✓/✗] Agentes core (Companion, Ops, Forge)
557
-
558
- ESSENCIAIS:
559
- [✓/✗] Playwright Chromium
560
- [✓/✗] Playwright Firefox
561
- [✓/✗] yt-dlp
562
- [✓/✗] Whisper/MacWhisper
563
- [✓/✗] Supabase (CLI + chaves no vault)
564
- [✓/✗] Vercel (CLI + logado)
565
-
566
- RECOMENDADOS:
567
- [✓/—] Google Drive (rclone)
568
- [✓/—] N8N
569
-
570
- OPCIONAIS:
571
- [✓/—] Gmail
572
- [✓/—] WhatsApp
573
- [✓/—] Notion
608
+ ```
609
+ | Item | Comando de verificacao | ✓ se |
610
+ |------|----------------------|------|
611
+ | Pastas essenciais | verificar existencia de `.auroq-core/`, `.claude/`, `.synapse/`, `business/`, `docs/knowledge/`, `agents/companion/` | todas existem |
612
+ | Hooks registrados | ler `.claude/settings.local.json` e verificar `hooks.UserPromptSubmit` | hook existe |
613
+ | Synapse Engine | verificar `.auroq-core/core/synapse/` existe e tem arquivos | existe |
614
+ | Agentes core | verificar `.claude/commands/` tem ops.md + forge.md + {slug do companion}.md | todos existem |
615
+ | Vault protegido | verificar `.gitignore` contem `business/vault/` | contem |
574
616
 
575
- GITHUB:
576
- [✓/✗] Repo privado criado
577
- [✓/✗] Primeiro commit + push
617
+ ```
618
+ CONEXOES:
619
+ ```
620
+ | Item | Comando de verificacao | ✓ se |
621
+ |------|----------------------|------|
622
+ | GitHub autenticado | `gh auth status` | mostra usuario logado |
623
+ | GitHub repo criado | `git remote -v` | mostra origin apontando pro repo |
624
+ | Vercel CLI | `vercel --version 2>/dev/null` | retorna versao |
625
+ | Vercel logada | `vercel whoami 2>/dev/null` | retorna username |
626
+ | Supabase CLI | `supabase --version` | retorna versao |
627
+ | Supabase logado | `supabase projects list 2>/dev/null` | nao da erro de auth |
578
628
 
579
- EXPERT SETUP:
580
- [✓/○] Perfil preenchido
581
- [✓/○] Primeiro projeto criado
629
+ ```
630
+ FERRAMENTAS:
631
+ ```
632
+ | Item | Comando de verificacao | ✓ se |
633
+ |------|----------------------|------|
634
+ | Playwright Chromium | `claude mcp list 2>/dev/null` e verificar playwright | aparece na lista |
635
+ | Playwright Firefox | `claude mcp list 2>/dev/null` e verificar playwright-firefox | aparece na lista |
636
+ | yt-dlp | `yt-dlp --version 2>/dev/null` | retorna versao |
637
+ | Whisper/MacWhisper | `whisper --help 2>/dev/null` OU verificar MacWhisper instalado | um dos dois funciona |
638
+
639
+ ```
640
+ PERMISSAO:
641
+ ```
642
+ | Item | Comando de verificacao | ✓ se |
643
+ |------|----------------------|------|
644
+ | Modo auto | ler `~/.claude/settings.json` e verificar `permissions.defaultMode` | valor = "bypassPermissions" |
582
645
 
583
- = pronto | ✗ = falhou (precisa corrigir) | — = pulou | ○ = pendente
646
+ **MONTAR O REPORT:**
647
+
648
+ Depois de rodar TODOS os comandos, apresentar:
584
649
 
585
- {SE tudo essencial OK:}
586
- Sistema pronto. Ative seu Companion: /{slug do nome escolhido na Fase 7}
587
650
  ```
651
+ === AUROQ OS — BOOTSTRAP COMPLETO ===
652
+
653
+ {pra cada item: [✓] se passou, [✗] se falhou, [—] se pulou (opcional)}
654
+
655
+ {listar todos os itens com resultado real}
656
+
657
+ RESULTADO: {X} de {total} verificacoes OK
658
+ ```
659
+
660
+ **SE tem algum [✗] em item essencial (pre-requisitos, estrutura, conexoes GitHub/Vercel/Supabase):**
661
+ → NAO dizer que o sistema ta pronto
662
+ → Dizer: "Tem {N} itens que precisam ser resolvidos antes de comecar. Quer resolver agora?"
663
+ → Listar os itens com [✗] e oferecer corrigir cada um
664
+
665
+ **SO dizer "Sistema pronto" se TODOS os itens essenciais tiverem [✓].**
588
666
 
589
667
  Salvar report em `.auroq/bootstrap-report.md` pra referencia futura.
590
668
 
@@ -599,7 +677,8 @@ Salvar report em `.auroq/bootstrap-report.md` pra referencia futura.
599
677
  | Playwright nao registra | npx nao encontra pacote | `npm cache clean --force` e tentar de novo |
600
678
  | `gh auth login` falha | Problema de rede ou browser | Tentar `gh auth login --web` |
601
679
  | `supabase login` falha | CLI desatualizada | `brew upgrade supabase` |
602
- | `rclone config` trava | Problema com OAuth do Google | Tentar em browser diferente, ou criar credenciais OAuth manualmente |
680
+ | `vercel login` falha | CLI desatualizada | `npm update -g vercel` |
681
+ | `rclone config` trava | Problema com OAuth do Google | Tentar em browser diferente |
603
682
  | MCP nao aparece em `claude mcp list` | Registro falhou | Verificar .mcp.json e settings.local.json manualmente |
604
683
  | Git push rejeitado | Remote nao configurado ou auth expirada | `gh auth refresh` ou `git remote set-url origin {url}` |
605
684
 
@@ -678,24 +757,16 @@ Companion: {OK/FALHA}
678
757
  ```
679
758
 
680
759
  ### *yolo
681
- Trocar modo de permissao do Claude Code em tempo real.
682
-
683
- Mostrar modo atual e opcoes:
684
- ```
685
- Modo atual: {detectar}
686
-
687
- Opcoes:
688
- 1. auto Claude faz tudo sem pedir permissao (recomendado)
689
- 2. acceptEdits aceita edicoes automatico, pede permissao pra terminal
690
- 3. default pede permissao pra tudo
691
-
692
- Qual modo?
693
- ```
694
-
695
- SE expert escolhe:
696
- → Instruir: "Precisa reiniciar o Claude Code com o modo escolhido:"
697
- → `claude --permission-mode {modo}`
698
- → "Ou se quiser so pra essa sessao, ja ta aplicado"
760
+ Trocar modo de permissao do Claude Code.
761
+
762
+ 1. Ler `~/.claude/settings.json` e verificar `permissions.defaultMode` atual
763
+ 2. SE nao esta em `bypassPermissions`:
764
+ Configurar `"defaultMode": "bypassPermissions"` + tools no `allow` (mesmo da FASE 2)
765
+ → "Modo auto ativado — Claude executa sem pedir permissao. Reinicia o Claude Code pra aplicar."
766
+ 3. SE ja esta em `bypassPermissions` e expert quer reduzir:
767
+ Perguntar: "Ja ta em auto. Quer trocar pra `acceptEdits` (aceita edicoes, pede pra terminal) ou `default` (pede pra tudo)?"
768
+ Atualizar `defaultMode` conforme resposta
769
+ 4. Sempre informar: "Reinicia o Claude Code pra aplicar o novo modo."
699
770
 
700
771
  ### *install
701
772
  Instalar squad, worker, mind ou agente a partir de arquivo zip ou pasta.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "auroq-os",
3
- "version": "1.0.7",
3
+ "version": "1.0.9",
4
4
  "description": "Auroq OS — Sistema Operacional de IA para Experts",
5
5
  "bin": {
6
6
  "auroq-os": "bin/auroq-os.js"