invos 1.0.0 → 2.0.2

package/kit/marketing/README.md

@@ -0,0 +1,44 @@
+# marketing/ — saídas do INVOS
+
+Tudo que as skills de marketing produzem cai aqui. Skills do INVOS já sabem onde salvar — você raramente precisa criar pasta manualmente.
+
+## Estrutura padrão
+
+```
+marketing/
+├── conteudo/                    saídas do /carrossel e /publicar-tema
+│   └── <tipo>-<tema>-<YYYY-MM-DD>/
+│       ├── carrossel.html
+│       ├── render.js
+│       ├── instagram/slide-XX.png
+│       ├── legenda.md
+│       └── legenda-linkedin.md
+│
+├── seo/                         saídas do /seo (8 passos)
+│   ├── 01-pesquisa-demanda.md
+│   ├── 02-analise-concorrencia.md
+│   ├── 03-google-meu-negocio.md
+│   ├── 04-otimizacao-on-page.md
+│   ├── 05-estrategia-conteudo.md
+│   ├── 06-google-ads.md
+│   ├── 07-checklist-monitoramento.md
+│   └── 08-geo-otimizacao-ia.md
+│
+├── campanhas/                   saídas do /anuncio-google e /relatorio-ads
+│   ├── google-ads-<YYYY-MM-DD>/  CSVs prontos pra importar
+│   └── relatorios/               relatórios semanais
+│
+└── avaliacoes-google/           histórico do /responder-avaliacoes (opcional)
+```
+
+## Como funciona
+
+- **`/carrossel` ou `/publicar-tema`** → cria pasta em `conteudo/<tipo>-<tema>-<data>/`
+- **`/seo`** → preenche os 8 arquivos numerados em `seo/`
+- **`/anuncio-google`** → cria pasta em `campanhas/google-ads-<data>/` com CSVs
+- **`/relatorio-ads`** → cria arquivo em `campanhas/relatorios/<data>-relatorio.md`
+- **`/responder-avaliacoes`** → opcionalmente salva histórico em `avaliacoes-google/`
+
+## Versionamento
+
+Tudo aqui versiona no git pelo `/salvar`. Útil pra comparar evolução de SEO entre meses, rever copies antigas, ou recuperar peça depois de mexer no Insta.

package/kit/saidas/README.md

@@ -0,0 +1,29 @@
+# saidas/ — outputs gerais do INVOS
+
+Pasta pra qualquer output que não é marketing puro (não cabe em `marketing/`).
+
+## O que vai aqui
+
+- **Análises** de `/analisar-dados` — resumos executivos de CSV/XLSX/PDF
+- **Emails** rascunhados por `/email-profissional`
+- **Relatórios diversos** que não são de ads
+- **Documentos** que skills geram e você precisa enviar/imprimir/anexar
+
+## Estrutura sugerida
+
+```
+saidas/
+├── analises/        relatórios de /analisar-dados
+├── emails/          rascunhos de /email-profissional
+└── outros/          qualquer coisa solta
+```
+
+Skills sabem onde salvar — você não precisa criar subpasta manualmente. Se uma skill perguntar onde salvar, vai propor aqui.
+
+## Por que separar de `marketing/`?
+
+`marketing/` é histórico vivo do trabalho de marketing — peças, campanhas, SEO acumulado.
+
+`saidas/` é "coisa pontual gerada hoje" — relatório que você manda pro cliente e nunca mais olha, rascunho de email que copia e cola no Gmail.
+
+A divisão importa pra `/salvar` (commit) e pra clareza ao navegar a pasta.

package/kit/scripts/README.md

@@ -0,0 +1,51 @@
+# scripts/ — utilitários do INVOS
+
+Scripts Node.js e Python que as skills chamam quando precisam fazer coisas fora do alcance da IA pura (gerar imagem, postar em rede social, renderizar HTML em PNG).
+
+A pasta vem **vazia** — cada skill que precisa de script tem instrução de como criar (e geralmente é um único setup por integração que você vai ativar).
+
+## Scripts comuns
+
+Conforme você for ativando skills, isso aqui vai sendo populado. Lista do que cada skill espera encontrar:
+
+| Skill | Script esperado | O que faz |
+|---|---|---|
+| `/carrossel` (com foto IA) | `gerar-imagem.js` | Gera foto realista via OpenAI API (DALL-E 3) |
+| `/carrossel` (render PNG) | `render.js` (gerado por carrossel, fica na pasta do conteúdo) | Playwright tira screenshot 1080x1350 de cada slide |
+| `/aprovar-post` | `postar-instagram.js` | Publica carrossel no Instagram via Meta Graph API |
+| `/aprovar-post` | `postar-facebook.js` | Publica carrossel no Facebook via Meta Graph API |
+| `/anuncio-google` | (nenhum — gera CSV direto) | — |
+| `/relatorio-ads` | (lê CSV exportado das plataformas) | — |
+
+## Pré-requisitos comuns
+
+A maioria dos scripts depende de:
+
+**Node.js 20+** instalado na máquina
+
+**.env** na raiz do projeto com as chaves de API:
+```bash
+OPENAI_API_KEY=sk-...               # pra gerar-imagem.js
+META_PAGE_ACCESS_TOKEN=...          # pra postar-instagram.js + postar-facebook.js
+META_PAGE_ID=...
+META_IG_USER_ID=...
+SITE_URL=https://seudominio.com.br
+```
+
+**Playwright** (pra renderizar HTML em PNG):
+```bash
+npm install playwright
+npx playwright install chromium
+```
+
+## Como o INVOS lida com isso
+
+Quando você roda uma skill que precisa de script ausente, o Claude vai:
+
+1. Detectar que falta o script
+2. Te perguntar se quer configurar agora
+3. Te guiar no setup das chaves de API (Meta, OpenAI, etc.)
+4. Criar o script já configurado
+5. Rodar a skill
+
+Você não precisa decorar nada. Roda a skill, segue o fluxo.

package/kit/templates/perfis/agents-agencia.md

@@ -0,0 +1,70 @@
+# [Nome da Agência] — INVOS
+
+> Molde do perfil INVOS (seção final do AGENTS.md) aplicado a **agência** — equipe pequena entregando
+> pra múltiplos clientes ao mesmo tempo. O sistema gira em torno de
+> proposta, atendimento e produção em paralelo. O `/instalar` adapta
+> esse molde com a sua realidade.
+
+> Colado/adaptado pelo **/instalar** no final do `AGENTS.md`. Não substitui o boot multi-harness.
+
+## O que é esse workspace
+
+[Uma frase do que essa pasta representa. Ex: "Operação da agência.
+Aqui ficam todos os clientes, propostas, conteúdo e entregas."]
+
+**Estrutura de pastas:**
+- `_memoria/` — quem é a agência, como falamos, foco atual
+- `marca/` — marca da agência (aplicada nas peças internas)
+- `clientes/` — uma subpasta por cliente, autossuficiente
+- `briefings/` — briefings antes de virar cliente
+- `propostas/` — propostas em andamento
+- `marketing/` — conteúdo institucional da agência
+- `saidas/` — documentos pontuais, análises
+- `dados/` — arquivos a analisar (relatórios de cliente, exports)
+- `tarefas.md` — pipeline da agência
+
+## Sobre a agência
+
+Somos uma [tipo: marketing digital / design / conteúdo / consultoria de IA].
+Atendemos [perfil de cliente real]. Nossos serviços principais:
+
+- [serviço 1]
+- [serviço 2]
+- [serviço 3]
+
+Time: [N pessoas]. Capacidade: [N clientes ativos simultâneos].
+
+## Clientes ativos
+
+[Lista breve. O `/atualizar` mantém isso sincronizado com as pastas em
+`clientes/`.]
+
+## O que mais produzimos aqui
+
+- Propostas comerciais pra novos clientes
+- [outros entregáveis frequentes: ads, conteúdo, relatórios]
+
+## Tom de voz
+
+[Como a agência se comunica — com cliente, em conteúdo público,
+internamente. Frase real ajuda mais que adjetivos.]
+
+Evitar: [o que destoa]
+
+## Regras do sistema
+
+- Cliente novo → criar pasta `clientes/<Nome>/` com briefing, `AGENTS.md` (+ `CLAUDE.md` `@AGENTS.md`) e subpastas conforme as entregas contratadas
+- Proposta nova → `propostas/<cliente>-<data>.html` antes de fechar
+- Casos de sucesso ficam em `clientes/<Nome>/caso.md` (reuso em pitches)
+- [outras regras que aparecerem com o uso]
+
+## Ferramentas conectadas
+
+- [ ] Notion
+- [ ] Gmail
+- [ ] Google Calendar
+- [ ] Canva
+- [ ] Meta Ads
+- [ ] Google Ads
+
+*(Marcar conforme for instalando os MCPs)*

package/kit/templates/perfis/agents-empresa.md

@@ -0,0 +1,75 @@
+# [Nome da Empresa] — INVOS
+
+> Molde do perfil INVOS (seção final do AGENTS.md) aplicado a **empresa estruturada** — setores,
+> processos, várias frentes rodando juntas. O sistema gira em torno
+> de organização interna e fluxo entre áreas. O `/instalar` adapta
+> esse molde com a sua realidade.
+
+
+> Colado/adaptado pelo **/instalar** no final do `AGENTS.md`. Não substitui o boot multi-harness.
+
+## O que é esse workspace
+
+[Uma frase do que essa pasta representa. Ex: "Operação da empresa.
+Cada setor tem sua área, com processos, entregas e documentos."]
+
+**Estrutura de pastas:**
+- `_memoria/` — quem é a empresa, como falamos, foco atual
+- `marca/` — marca aplicada em tudo que o sistema gera
+- `marketing/` — campanhas, conteúdo, mídia paga
+- `comercial/` — pipeline, propostas, materiais de venda
+- `financeiro/` — relatórios, fluxo, orçamentos
+- `rh/` — processos seletivos, onboarding, equipe
+- `operacoes/` — processos internos, SOPs, fornecedores
+- `projetos/` — projetos que envolvem mais de um setor
+- `saidas/` — documentos pontuais
+- `dados/` — arquivos a analisar
+- `tarefas.md` — o que tá em jogo agora
+
+## Sobre a empresa
+
+[Nome] é uma [tipo: consultoria / comércio / serviços / indústria / tech].
+Atuamos em [mercado/segmento] atendendo [perfil de cliente].
+Somos [N] pessoas organizadas em [setores existentes].
+
+## Setores e responsáveis
+
+- **Marketing:** [quem cuida, o que produz]
+- **Comercial:** [quem cuida, o que faz]
+- **Financeiro:** [quem cuida, o que acompanha]
+- **RH:** [quem cuida, o que gerencia]
+- **Operações:** [quem cuida, processos principais]
+
+*(Adicione ou remova setores conforme a realidade)*
+
+## O que mais fazemos aqui
+
+- [entregável frequente 1: ex. campanhas de marketing]
+- [entregável frequente 2: ex. propostas comerciais]
+- [entregável frequente 3: ex. relatórios financeiros mensais]
+
+## Tom de voz
+
+[Como a empresa se comunica — interno vs externo pode ser diferente.
+Frase real ajuda mais que adjetivos.]
+
+Evitar: [o que destoa da marca]
+
+## Regras do sistema
+
+- Cada setor tem sua pasta na raiz
+- Projetos que cruzam setores ficam em `projetos/`
+- Propostas comerciais salvar em `comercial/propostas/`
+- Relatórios salvar em `financeiro/relatorios/`
+- [outras regras de organização]
+
+## Ferramentas conectadas
+
+- [ ] Notion
+- [ ] Gmail
+- [ ] Google Calendar
+- [ ] Google Ads
+- [ ] Meta Ads
+- [ ] Slack
+
+*(Marcar conforme for instalando os MCPs)*

package/kit/templates/perfis/agents-freelancer.md

@@ -0,0 +1,68 @@
+# [Seu Nome] — INVOS
+
+> Molde do perfil INVOS (seção final do AGENTS.md) aplicado a **freelancer** — você vende tempo e
+> talento pra clientes terceiros. O sistema gira em torno de captar,
+> entregar e cobrar. O `/instalar` adapta esse molde com a sua realidade.
+
+> Colado/adaptado pelo **/instalar** no final do `AGENTS.md`. Não substitui o boot multi-harness.
+
+## O que é esse workspace
+
+[Uma frase do que essa pasta representa. Ex: "Operação freelancer.
+Aqui ficam todos os clientes, briefings, entregas e cobrança."]
+
+**Estrutura de pastas:**
+- `_memoria/` — quem sou, como falo, foco atual
+- `marca/` — minha marca pessoal aplicada nas entregas
+- `clientes/` — uma subpasta por cliente, autossuficiente
+- `propostas/` — propostas em rascunho ou enviadas
+- `marketing/` — meu próprio conteúdo (Insta, LinkedIn, portfolio)
+- `saidas/` — emails, documentos pontuais
+- `dados/` — arquivos a analisar
+- `tarefas.md` — pipeline, prazos, próximos passos
+
+## Quem sou
+
+Sou [nome], freelancer de [área: design / dev / copy / marketing / etc].
+Trabalho com [tipo de cliente] entregando [especialidade real].
+
+## Meu serviço
+
+- [serviço principal 1]
+- [serviço principal 2]
+- [serviço principal 3]
+
+Ticket médio: [se quiser registrar]. Capacidade simultânea: [N projetos
+ao mesmo tempo no máximo].
+
+## Clientes ativos
+
+[Lista breve ou descrição. O `/atualizar` mantém isso sincronizado com
+as pastas em `clientes/`.]
+
+## Como trabalho
+
+[Seu processo: como recebe briefing, como entrega, ferramentas que usa,
+tempo médio de cada projeto.]
+
+## Tom de voz
+
+[Como você fala com cliente. Frase real ajuda mais que adjetivos.]
+
+Evitar: [o que destoa do seu jeito]
+
+## Regras do sistema
+
+- Cliente novo → criar pasta `clientes/<Nome>/` com `briefing.md` e `AGENTS.md` (+ `CLAUDE.md` com `@AGENTS.md`)
+- Proposta enviada → `clientes/<Nome>/proposta.html` (ou pasta `propostas/`
+  se ainda não fechou)
+- [outras regras que aparecerem com o uso]
+
+## Ferramentas conectadas
+
+- [ ] Notion
+- [ ] Gmail
+- [ ] Google Calendar
+- [ ] Stripe / cobrança
+
+*(Marcar conforme for instalando os MCPs)*

package/kit/templates/perfis/agents-solopreneur.md

@@ -0,0 +1,68 @@
+# [Seu Nome] — INVOS
+
+> Molde do perfil INVOS (seção final do AGENTS.md) aplicado a **criador solo** — uma pessoa, uma marca,
+> audiência como ativo principal. O sistema gira em torno do que você
+> produz e publica. O `/instalar` adapta esse molde com a sua realidade.
+
+
+> Colado/adaptado pelo **/instalar** no final do `AGENTS.md`. Não substitui o boot multi-harness.
+
+## O que é esse workspace
+
+[Uma frase do que essa pasta representa. Ex: "Operação da minha marca
+pessoal e do meu negócio. Aqui eu produzo, publico, mantenho relação
+com audiência e fecho venda."]
+
+**Estrutura de pastas:**
+- `_memoria/` — quem eu sou, como falo, o que tá em foco
+- `marca/` — cores, fontes, logo, padrão visual
+- `marketing/` — conteúdo, SEO, campanhas (saída das skills)
+- `saidas/` — análises, emails, documentos pontuais
+- `produtos/` — meus produtos próprios (cursos, ebooks, ofertas)
+- `audiencia/` — listas, dados, contatos da minha base
+- `dados/` — arquivos a analisar (CSV, PDF, planilha)
+- `scripts/` — utilitários (gerar imagem, postar, render)
+- `tarefas.md` — o que tá em jogo agora
+
+## Quem sou
+
+Sou [nome]. [O que eu faço em uma frase].
+[O que diferencia o meu jeito — viés, ponto de vista, marca pessoal].
+
+## O que produzo
+
+- [tipo de conteúdo 1: ex. vídeos no YouTube]
+- [tipo de conteúdo 2: ex. carrosséis no Instagram]
+- [produto próprio: ex. curso, mentoria, ebook]
+
+## Minha audiência
+
+[Quem me acompanha hoje. Perfil real, não persona genérica. Tamanho da
+base se for relevante.]
+
+## Tom de voz
+
+[Como você escreve. Frase de exemplo é melhor que adjetivos abstratos.]
+
+Evitar: [o que destoa de você]
+
+## Posicionamento
+
+[O que você defende. Sua tese. Por que alguém te escolheria em vez do
+próximo criador do mesmo nicho.]
+
+## Regras do sistema
+
+- Conteúdo novo salvar em `marketing/conteudo/<tipo>-<tema>-<data>/`
+- Cada lançamento de produto cria pasta em `produtos/<nome>/`
+- [outras regras que aparecerem com o uso]
+
+## Ferramentas conectadas
+
+- [ ] Notion
+- [ ] Canva
+- [ ] Google Calendar
+- [ ] Meta Ads
+- [ ] Google Ads
+
+*(Marcar conforme for instalando os MCPs)*

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "invos",
-  "version": "1.0.0",
-  "description": "INVOS — cérebro do negócio em arquivos para agentes de IA. CLI: init, install, update, doctor.",
+  "version": "2.0.2",
+  "description": "INVOS — OS do negócio em arquivos. Open-source. CLI: init, install, update, doctor.",
   "type": "module",
   "bin": {
     "invos": "bin/invos.js"
@@ -23,21 +23,16 @@
     "invos",
     "ai-agents",
     "memory",
-    "claude",
-    "cursor",
     "business-os",
-    "markdown"
+    "open-source"
   ],
-  "author": "Felipe Natanael",
+  "author": "Felipe Alves",
   "license": "MIT",
+  "private": false,
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/felipenalves/invos.git",
-    "directory": "packages/cli"
+    "url": "git+https://github.com/felipenalves/invos.git"
   },
   "homepage": "https://inovadigitalid.com/invos",
-  "bugs": {
-    "url": "https://github.com/felipenalves/invos/issues"
-  },
   "dependencies": {}
 }

package/src/commands/doctor.js

@@ -2,103 +2,88 @@ import { existsSync, readdirSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { loadManifest } from '../manifest.js';
 import { readLock } from '../lock.js';
-import { checkClaudeSymlinks } from '../symlinks.js';
+import { checkClaudeSymlinks, syncClaudeSymlinks } from '../symlinks.js';
 
-const ESSENTIAL_FILES = [
-  'AGENTS.md', 'MEMORY.md', 'SECURITY.md', '.env.example', 'COMECE-AQUI.md',
-  'INVOS.json',
-];
-
-const ESSENTIAL_DIRS = [
-  'memoria', 'marca', 'clientes', 'conteudo', 'scripts',
-  '.agents/skills', '.agents/squads',
-];
+async function askFix(hasWarnings) {
+  if (!hasWarnings) return true;
+  try {
+    const rl = await import('node:readline/promises');
+    const r = rl.createInterface({ input: process.stdin, output: process.stdout });
+    const ans = await r.question('⚠️ Doctor found issues. Apply --fix? (y/N) ');
+    r.close();
+    return ans.toLowerCase().startsWith('y');
+  } catch {
+    return false; // non-TTY — fail safe
+  }
+}
 
 export async function doctor(kit, kitRoot, targetDir, args) {
   const fix = args.includes('--fix');
-  let allOk = true;
-  const report = [];
+  let ok = true;
+  const r = [];
 
-  report.push('INVOS Doctor — ' + targetDir);
+  r.push('INVOS Doctor — ' + targetDir);
 
-  // 1. Essential files
-  let filesOk = 0;
-  for (const f of ESSENTIAL_FILES) {
-    const p = resolve(targetDir, f);
-    if (existsSync(p)) {
-      filesOk++;
-    } else {
-      report.push('  ✗ ' + f + ' — missing');
-      allOk = false;
+  for (const f of ['AGENTS.md', 'CLAUDE.md', 'INVOS.json']) {
+    if (existsSync(resolve(targetDir, f))) r.push('  ✓ ' + f);
+    else {
+      r.push('  ✗ ' + f);
+      ok = false;
     }
   }
-  report.push('  Files: ' + filesOk + '/' + ESSENTIAL_FILES.length);
 
-  // 2. Essential dirs
-  let dirsOk = 0;
-  for (const d of ESSENTIAL_DIRS) {
-    const p = resolve(targetDir, d);
-    if (existsSync(p)) {
-      dirsOk++;
-    } else {
-      report.push('  ✗ ' + d + '/ — missing');
-      allOk = false;
-    }
+  const mem = existsSync(resolve(targetDir, '_memoria')) || existsSync(resolve(targetDir, 'memoria'));
+  if (mem) r.push('  ✓ _memoria|memoria');
+  else {
+    r.push('  ✗ memory dir');
+    ok = false;
   }
-  report.push('  Dirs: ' + dirsOk + '/' + ESSENTIAL_DIRS.length);
-
-  // 3. Skills vs manifest
-  const man = loadManifest(resolve(targetDir, 'INVOS.json'));
-  const agentsSkillsDir = resolve(targetDir, '.agents', 'skills');
-  const manifestSkills = man?.seed?.skills || [];
 
-  if (existsSync(agentsSkillsDir)) {
-    const present = readdirSync(agentsSkillsDir).filter(e => {
-      return existsSync(resolve(agentsSkillsDir, e, 'SKILL.md'));
-    });
-    const missing = manifestSkills.filter(s => {
-      if (s === 'notion') {
-        return !existsSync(resolve(targetDir, '.claude', 'skills', 'notion'));
-      }
-      return !present.includes(s);
-    });
-    if (missing.length > 0) {
-      report.push('  Skills missing: ' + missing.join(', '));
-      allOk = false;
-    } else {
-      report.push('  Skills: all ' + manifestSkills.length + ' present');
-    }
+  const skillsDir = resolve(targetDir, '.agents/skills');
+  if (existsSync(skillsDir)) {
+    const n = readdirSync(skillsDir).filter(e =>
+      existsSync(resolve(skillsDir, e, 'SKILL.md')),
+    ).length;
+    r.push(`  ✓ skills: ${n}`);
+    if (n < 5) ok = false;
+  } else {
+    r.push('  ✗ .agents/skills');
+    ok = false;
   }
 
-  // 4. Lock file
   const lock = readLock(targetDir);
-  if (lock) {
-    report.push('  Lock: ✓ (' + lock.version + ', installed ' + (lock.installedAt ? lock.installedAt.substring(0, 10) : '?') + ')');
-  } else {
-    report.push('  Lock: ✗ INVOS-LOCK.json missing');
-    allOk = false;
+  if (lock) r.push(`  ✓ lock v${lock.version}`);
+  else {
+    r.push('  ✗ INVOS-LOCK.json');
+    ok = false;
   }
 
-  // 5. Claude symlinks
-  const symCheck = checkClaudeSymlinks(targetDir);
-  if (symCheck.ok) {
-    report.push('  Symlinks: ✓');
-  } else {
-    report.push('  Symlinks: ✗ ' + symCheck.errors.join('; '));
-    allOk = false;
+  if (fix) {
+    const confirmed = await askFix(!ok);
+    if (!confirmed) {
+      r.push('  --fix: skipped (not confirmed)');
+    } else {
+      syncClaudeSymlinks(kitRoot, targetDir);
+      r.push('  --fix: symlinks');
+    }
   }
 
-  // 6. Version
-  report.push('  Kit version: ' + (man?.version || 'unknown'));
+  const sym = checkClaudeSymlinks(targetDir);
+  if (sym.ok) r.push('  ✓ .claude symlinks');
+  else {
+    r.push('  ✗ symlinks: ' + sym.errors.slice(0, 3).join('; '));
+    ok = false;
+  }
 
-  console.log(report.join('\n'));
+  const man = loadManifest(resolve(targetDir, 'INVOS.json'));
+  r.push(`  kit ${man?.version || kit?.version || '?'}`);
+  r.push('  update: npm package kit (npx invos@latest update)');
 
-  if (!allOk) {
-    console.log('  Status: ⚠️  issues found');
-    if (fix) console.log('  Run: invos install');
-    else console.log('  Run: invos doctor --fix');
-    return;
+  console.log(r.join('\n'));
+  if (!ok) {
+    console.log('  Status: ⚠️');
+    process.exitCode = 1;
+  } else {
+    console.log('  Status: ✓');
   }
-
-  console.log('  Status: ✓ all checks passed');
 }