invos 1.0.0

package/kit/integracoes/README.md

@@ -0,0 +1,31 @@
+# Integrações
+
+Camada **opcional** do INVOS: conectar o agente a ferramentas externas (Gmail, Sheets, Notion, ads, etc.).
+
+O core do INVOS (**memoria / marca / clientes / proposta**) **funciona sem isso**.  
+Integração é quando o prestador já quer que o agente **leia ou dispare** algo fora da pasta.
+
+## O que tem aqui
+
+| Path | Pra quê |
+|------|---------|
+| [`composio/`](./composio/) | Setup CLI + mapa de ferramentas de marketing/vendas |
+| Skill `social-content` | Criar posts (texto) com voz da marca — **não precisa** de Composio |
+| Composio | **Publicar / puxar dados** de apps conectados (quando o toolkit existir) |
+
+## Ordem de preferência (eficiência)
+
+```text
+1. Arquivos do INVOS (memoria, clientes, conteudo)     ← sempre primeiro
+2. composio CLI  (npx composio / composio)             ← preferido pra executar
+3. Composio MCP  (se o harness só fala MCP)            ← alternativa
+4. API nativa da ferramenta                            ← se for crítico e deep
+```
+
+**Por quê CLI > MCP no INVOS:** menos magia no harness, dá pra `search` → `link` → `execute` com schema e dry-run; o empresário (ou o agente) repete o comando. MCP é cômodo no Claude Code, mas o fluxo CLI é mais auditável e portável entre agentes.
+
+## Segurança
+
+- Tokens e `COMPOSIO_API_KEY` só em **`.env` / ambiente** — nunca em `memoria/` nem commit.  
+- Ver `SECURITY.md` na raiz.  
+- OAuth fica na conta Composio do usuário; o kit **não** embute chaves.

package/kit/integracoes/composio/README.md

@@ -0,0 +1,128 @@
+# Composio no INVOS (CLI primeiro)
+
+Uma conta Composio → OAuth gerenciado → **centenas de apps** (Gmail, Sheets, Notion, Slack, HubSpot, Meta Ads, etc.).
+
+Para o prestador: o agente deixa de só **escrever** proposta/post e passa a **agir** em ferramenta (com permissão).
+
+## Vale a pena?
+
+| Situação | Usar Composio? |
+|----------|----------------|
+| Só memória + proposta + post em Markdown/HTML | **Não** — core basta |
+| Quer Gmail / Sheets / Notion / Slack no agente | **Sim** |
+| CRM (HubSpot) sem MCP nativo | **Sim** (forte) |
+| Meta/LinkedIn **Ads** (campanha, spend) | **Sim** (médio) |
+| Post orgânico Instagram “publicar sozinho” | **Cuidado** — coverage costuma ser ads/API limitada; muitas vezes o fluxo é: agente **escreve** o post (`social-content`) e **você** publica (dono=humano) |
+| Volume absurdo / compliance enterprise | Preferir API nativa + processo |
+
+**Resumo:** Composio é bom **MCP/CLI unificado** de marketing+ops. Não substitui `marca/` nem `conteudo/`. É o **frete** das ações externas.
+
+## Pré-requisitos
+
+- Node 18+  
+- Conta em [composio.dev](https://composio.dev) (free tem cota)  
+- Agente com terminal (Cursor, Claude Code, Codex, Grok…)
+
+## Setup rápido (CLI)
+
+```bash
+# Login (uma vez na máquina)
+npx composio login
+# ou: composio login   se tiver CLI global
+
+npx composio whoami
+```
+
+### Descobrir ferramenta
+
+```bash
+npx composio search "enviar email"
+npx composio search "instagram" --toolkits 
+npx composio search "planilha google"
+```
+
+### Conectar app (OAuth no browser)
+
+```bash
+npx composio link gmail
+npx composio link googlesheets
+npx composio link notion
+# etc.
+```
+
+### Ver o que o tool exige (sem executar)
+
+```bash
+npx composio execute GMAIL_SEND_EMAIL --get-schema
+npx composio execute GMAIL_SEND_EMAIL --dry-run -d '{ ... }'
+```
+
+### Executar
+
+```bash
+npx composio execute GMAIL_SEND_EMAIL -d '{ "recipient_email": "a@b.com", "subject": "Proposta", "body": "..." }'
+```
+
+### Vários de uma vez
+
+```bash
+npx composio execute --parallel \
+  SLUG_A -d '{}' \
+  SLUG_B -d '{}'
+```
+
+### Script (workflow)
+
+```bash
+npx composio run '
+  const me = await execute("GMAIL_FETCH_EMAILS", { max_results: 3 });
+  console.log(me.data);
+'
+```
+
+## MCP (opcional)
+
+Se o harness preferir MCP:
+
+```bash
+npx @composio/mcp@latest setup
+```
+
+No Claude Code: `/mcp` deve listar `composio`.  
+No INVOS, **documentamos CLI como caminho default**; MCP é fallback.
+
+## API key (opcional / time)
+
+```bash
+export COMPOSIO_API_KEY=...   # só no shell ou .env local (gitignore)
+```
+
+Nunca commitar.
+
+## Fluxos úteis pro prestador INVOS
+
+| Você diz | Fluxo |
+|----------|--------|
+| “Manda a proposta por e-mail pro cliente X” | Lê HTML/msg em `clientes/X/` → `composio` Gmail (se linkado) **ou** ⚠️ cola e envia manual |
+| “Joga os leads da planilha no pipeline” | Sheets via Composio → linhas em `clientes/_index.md` |
+| “Resumo dos deals no Notion” | Notion read → checkpoint em `ativo` / histórico |
+| “Quanto gastei em ads essa semana?” | Meta/LinkedIn Ads toolkit se conectado |
+| “Escreve o post da semana” | Skill **`social-content`** (sem Composio) → `conteudo/` |
+
+## Troubleshooting
+
+| Problema | Ação |
+|----------|------|
+| Tool not found / not connected | `composio link <toolkit>` e retry |
+| Auth expirou | `composio connections list` → remove → link de novo |
+| Rate limit | Reduzir calls; free ~cota mensal |
+| Não sei o slug | `composio search "…"` |
+
+Detalhe de toolkits de marketing: [marketing-tools.md](./marketing-tools.md).
+
+## O que o agente deve fazer
+
+1. Preferir dados em `memoria/` + `clientes/` + `marca/`.  
+2. Se a tarefa **exigir app externo** e Composio estiver no ambiente: `search` → `link` se precisar → `execute --get-schema` se inseguro → `execute`.  
+3. Se falhar OAuth ou toolkit não cobrir post orgânico: gerar o artefato no INVOS e marcar **Fila humana** (`⚠️ Sua vez: publicar no Instagram`).  
+4. Nunca gravar token em arquivo do kit.

package/kit/integracoes/composio/marketing-tools.md

@@ -0,0 +1,61 @@
+# Composio — toolkits úteis pra marketing/vendas (mapa)
+
+Referência enxuta pro agente e pro prestador. Depth: Deep = uso diário ok · Medium = core · Shallow = básico.
+
+## CRM / pipeline (fora do `_index` local)
+
+| Toolkit | Auth | Uso típico INVOS | Depth |
+|---------|------|------------------|-------|
+| `HUBSPOT` | OAuth | Contatos, deals — espelhar quentes em `clientes/` | Deep |
+| `SALESFORCE` | OAuth | Leads/opps (se o prestador usa) | Deep |
+
+## E-mail
+
+| Toolkit | Auth | Uso típico | Depth |
+|---------|------|------------|-------|
+| `GMAIL` | OAuth | Enviar proposta / follow-up | Deep |
+| `MAILCHIMP` | OAuth | Lista / campanha (se tiver lista) | Deep |
+| `KLAVIYO` / `ACTIVECAMPAIGN` | API Key | E-mail marketing | Medium |
+
+## Ads (pago)
+
+| Toolkit | Auth | Uso típico | Depth |
+|---------|------|------------|-------|
+| `FACEBOOKADS` | OAuth | Spend, campanhas Meta | Medium |
+| `LINKEDIN` | OAuth | Ads / page analytics | Medium |
+| `GOOGLEADS` | OAuth | Campanhas search | Medium |
+
+## Produtividade
+
+| Toolkit | Auth | Uso típico | Depth |
+|---------|------|------------|-------|
+| `GOOGLESHEETS` | OAuth | Lead list → importar pro `_index` | Deep |
+| `NOTION` | OAuth | Notas / CRM paralelo | Deep |
+| `SLACK` | OAuth | Avisos (se time) | Deep |
+| `AIRTABLE` | OAuth | Base de leads | Deep |
+
+## Commerce
+
+| Toolkit | Auth | Uso típico | Depth |
+|---------|------|------------|-------|
+| `SHOPIFY` | OAuth | Pedidos/produtos (se ecom) | Deep |
+
+## Analytics
+
+| Toolkit | Auth | Uso típico | Depth |
+|---------|------|------------|-------|
+| `GOOGLEANALYTICS` | OAuth | Tráfego do site | Medium |
+
+## Social orgânico (postar feed)
+
+Muitos prestadores esperam “posta no Instagram sozinho”. Na prática:
+
+- Composio brilha em **ads, CRM, e-mail, sheets**.  
+- **Publicação orgânica** (IG/TikTok feed) costuma ser restrita por API da Meta/etc.  
+- Fluxo INVOS recomendado: skill **`social-content`** gera o post → `conteudo/` → dono **humano** publica → opcionalmente registrar “publicado” na fila.
+
+Sempre: `composio search "instagram"` / `"linkedin post"` no ambiente atual — a cobertura muda.
+
+## Preferência se existir ferramenta nativa
+
+Se o harness já tiver MCP/CLI **nativo** e mais profundo (ex.: Stripe, GA4 em alguns setups), prefira o nativo. Composio = **um conector pra muitos apps** e OAuth fácil.

package/kit/marca/README.md

@@ -0,0 +1,13 @@
+# Marca
+
+Sistema visual e de voz do negócio. **Uma fonte de verdade.**
+
+| Path | Pra quê |
+|------|---------|
+| `marca/marca.md` | Cores, fontes, voz, paths de logo |
+| `marca/assets/` | logo.svg / logo.png e variações |
+
+**Quem lê:** skill `proposta` (HTML), futuro conteúdo, qualquer saída “com a cara da empresa”.  
+**Quem escreve:** onboard, você, ou skill `design-marca` (extrair do site).
+
+Não coloque logo do **cliente** aqui — assets de cliente ficam em `clientes/<slug>/arquivos/`.

package/kit/marca/marca.md

@@ -0,0 +1,57 @@
+# Marca
+
+> Identidade visual e de voz **canônica**. Skills de saída (proposta, conteúdo) leem **daqui**, não inventam.
+
+## Identidade
+
+- **Nome da marca:** [ex: Studio Ana]
+- **Founder / responsável:** [seu nome]
+- **Tagline (1 linha):** [opcional]
+- **Site:** [https://…]
+- **Instagram / redes:** [@…]
+- **Contato comercial:** [WhatsApp ou e-mail na proposta]
+
+## Cores
+
+- **Primária:** #0f766e
+- **Fundo:** #ffffff
+- **Texto:** #0f172a
+- **Texto secundário:** #475569
+- **Acento (opcional):** #
+
+## Tipografia
+
+- **Títulos:** [ex: system-ui / Inter]
+- **Corpo:** [ex: system-ui]
+- **Tom visual:** clean | ousado | minimal | caloroso
+
+## Logo e assets
+
+Coloque arquivos em `marca/assets/`:
+
+| Arquivo | Uso |
+|---------|-----|
+| `logo.svg` ou `logo.png` | Proposta / PDF / posts |
+| `logo-icon.png` | Favicon / avatar (opcional) |
+
+- **Logo presente?** não | sim (`marca/assets/…`)
+- **Fundo do logo:** claro | escuro | transparente
+- **Não fazer com o logo:** [ex: não esticar, não mudar cor]
+
+## Voz (marketing + proposta)
+
+- **Tom:** [direto, informal com correção, …]
+- **Pode dizer (3 exemplos):**
+  1. …
+  2. …
+  3. …
+- **Não dizer (3 exemplos):**
+  1. …
+  2. …
+  3. …
+
+## Como preencher
+
+1. **Na mão** no onboard (perguntas de marca).  
+2. **Do site:** skill `design-marca` — cola a URL do site e o agente extrai cores/fontes pra cá.  
+3. **Squad brand** (bônus): se rodar brand book, **grave o resumo aqui** (não deixe só no chat).

package/kit/memoria/ativo.md

@@ -0,0 +1,18 @@
+# Ativo
+
+## Contexto da sessão
+
+- **Data:** 2026-07-24
+- **Sessão anterior:** compact — PRD CLI + skills
+- **Foco:** Implementar MVP `npx invos`
+- **Missão do dia:** CLI init/install/update/doctor + INVOS.json
+- **Done quando:** update não toca USER; doctor green em fixture
+- **Dono da missão:** agente
+
+## Fila agente
+
+- [ ] Implementar package CLI + manifest · desde: 2026-07-24
+
+## Fila humana
+
+- [ ] Checkout Hotmart → token (fase 2) · desde: 2026-07-24

package/kit/memoria/decisoes.md

@@ -0,0 +1,26 @@
+# Decisões
+
+> Registro de decisões por tópico, rastreáveis entre sessões.
+> Cada decisão linka para a data no historico/ onde foi tomada.
+>
+> 🛠 As decisões serão adicionadas automaticamente pelo session-checkpoint.
+
+## Skills & enxugamento (produto)
+
+| Decisão | Data | Origem |
+|---------|------|--------|
+| **Manter** llm-wiki + popular-web-designs no kit: pesquisa do empresário/cliente e sites/artefatos com IA — não é “só dev” | 24-07 | Override auditoria Sieve |
+| **Manter** pd-ikigai: estratégia própria e de clientes (uso recorrente, não one-shot) | 24-07 | Override Sieve |
+| **Manter** apple/* (notes/reminders): hábitos macOS do dono | 24-07 | Override Sieve |
+| **Manter** productivity (gmail, notion, pptx, ocr, nano-pdf): skill nativa > Composio CLI pra fluxo diário do empresário; Composio = redes/outros apps | 24-07 | Override Sieve |
+| **Manter** squads advisory-board + brand como bônus sob demanda | 24-07 | Override Sieve |
+| **Apagar** skill `maps` (geocode/POI): sem encaixe; endereço → Google Maps do humano | 24-07 | Produto |
+| **AGENTS.md:** otimizar por **linhas/clareza**, não por KB; não cortar regra útil (engessa/burro) | 24-07 | Produto |
+| Skills canônicas em **`.agents/skills/`**; Claude Code via **symlink** `.claude/skills/*` → mesmo conteúdo | 24-07 | Multi-harness |
+| social-content **≠** carrossel (texto vs pack visual) — manter as duas | 24-07 | Já decidido |
+
+## [Tópico — template]
+
+| Decisão | Data | Origem |
+|---------|------|--------|
+| [descrição da decisão] | dd-mm | Contexto |

package/kit/memoria/empresa.md

@@ -0,0 +1,46 @@
+# Empresa
+
+> História, estratégia e preferências do negócio.
+>
+> 🛠 PREENCHA COM SEUS DADOS. Este é um template.
+>
+> Este kit foi feito pra quem presta serviço no digital:
+> designer, marketer, mentor, consultor, programador.
+> Você tem cliente, precisa de proposta, histórico, organização.
+> Use como o co-founder do seu negócio.
+
+## Identidade
+
+- **Visão:** [o que você quer construir ou resolver]
+- **Founder:** [seu nome]
+- **Negócio:** [descreva em 1 linha — ex: "Design e marketing para pequenas empresas"]
+- **Estágio:** [ideação | MVP | tração | escala]
+- **Oferta principal:** [o que você vende — ex: "Pacote mensal de design R$1.500"]
+- **Tom de voz:** [como você se comunica com cliente]
+- **Cliente ideal:** [quem paga você — ex: "Pequeno empresário que precisa de site"]
+- **Ferramentas:** [Figma, WordPress, Instagram, WhatsApp, Notion...]
+
+## Brand (resumo — fonte completa em `marca/marca.md`)
+
+> Não duplique sistema visual aqui. Atualize **`marca/marca.md`** + `marca/assets/`.  
+> Skill `design-marca` preenche a partir do site. Skill `proposta` lê `marca/` primeiro.
+
+- **Marca:** [mesmo nome que em marca/marca.md]
+- **Cor:** [#0f766e]
+- **Site ou Instagram:** [https://… ou @seuuser]
+- **Contato na proposta:** [WhatsApp ou e-mail]
+
+## Estratégia de conteúdo (se aplicável)
+
+- Posicionamento:
+- Formatos:
+- Frequência:
+- Nicho:
+- **Fila operacional:** `conteudo/_fila.md`
+
+## Preferências operacionais
+
+- Branch: `develop` para trabalho, `main` só releases
+- Commits: concisos, escopo claro
+- Decisões: primeiros princípios, não convenção
+- Erros: registra em `regras/` pra não repetir

package/kit/memoria/historico/README.md

@@ -0,0 +1,8 @@
+# Histórico de sessões
+
+As sessões são arquivadas aqui automaticamente pelo session-end.
+
+**Formato do diário:** `YYYY-MM-DD.md` apenas.  
+Este `README.md` **não** é histórico — o session-start ignora tudo que não for data ISO.
+
+Se você está vendo só este arquivo, ainda não tem nenhuma sessão arquivada.

package/kit/memoria/insights.md

@@ -0,0 +1,11 @@
+# Insights
+
+> Ideias, epifanias e conexões estratégicas que surgem durante as conversas.
+> Não são decisões tomadas — são sementes pra revisitar depois.
+> Alimentado por session-checkpoint (tipo: insight) e curadoria manual.
+>
+> 🛠 Os insights serão adicionados automaticamente pelo session-checkpoint.
+
+## [YYYY-MM-DD]
+
+- **Título do insight:** descrição detalhada. [Fonte: contexto onde surgiu]

package/kit/memoria/perfil.md

@@ -0,0 +1,29 @@
+# Perfil — [Seu Nome]
+
+> Quem você é, sua essência, sua mentalidade.
+> 🛠 PREENCHA. Isso é o que define como você opera.
+
+## Sua essência
+
+[Escreva aqui quem você é de verdade. Exemplo:
+"Eu não quero ser especialista. Eu quero construir coisas e ter uma comunidade em volta."]
+
+## Seu framework de criação
+
+Tudo que você criar deve responder:
+
+1. **Qual problema isso resolve?**
+2. **Por que a pessoa deveria escolher isso?**
+3. **Pra que isso serve?**
+4. **Qual dor isso cura?**
+
+## Como você opera
+
+- [ex: "Eu começo coisas e tenho dificuldade de terminar — preciso de um sistema que me force a executar"]
+- [ex: "Crítica forte me melhora. Eu gosto."]
+- [ex: "Discussão sem ação é entretenimento"]
+
+## Seu papel
+
+- [ex: "Builder, não guru."]
+- [ex: "Tudo que funciona pra mim vira conteúdo."]

package/kit/memoria/projetos.md

@@ -0,0 +1,27 @@
+# Projetos — Status
+
+> Inventário de todos os projetos ativos. Atualizado a cada sessão.
+>
+> 🛠 PREENCHA SEUS PROJETOS AQUI.
+>
+> Se você presta serviço, cada cliente é um projeto.
+> Use este arquivo pra saber o que fazer hoje e amanhã.
+
+## [Cliente/Projeto] — PRIORIDADE #1
+
+> O marcador **PRIORIDADE #1** no título é o que o session-start usa como “o que importa hoje”.  
+> Só um projeto com #1. Outros: #2, ou sem número.
+
+- **O que é:** [descrição do projeto]
+- **Cliente:** [nome do cliente, se aplicável]
+- **URL:** [se tiver]
+- **Repo:** [se tiver]
+- **Stack:** [ferramentas]
+- **Status atual:** [ideação | fazendo | revisão | entregue]
+- **Próximo:** [o que fazer agora]
+
+## [Outro Cliente/Projeto] — PRIORIDADE #2
+- **O que é:** ...
+- **Cliente:** ...
+- **Status:** ...
+

package/kit/memoria/regras/_TEMPLATE-exemplo.md

@@ -0,0 +1,15 @@
+# Exemplo de regra
+
+> 🛠 TEMPLATE — apague ou substitua na primeira regra real. Não é regra ativa.
+
+**Gatilho:** [Quando essa regra se aplica]
+**Criada em:** YYYY-MM-DD
+**Origem:** [Sessão ou contexto que gerou a lição]
+
+## Regra
+
+[Descrição clara do que fazer e não fazer]
+
+## Por quê
+
+[Contexto do erro ou aprendizado]

package/kit/memoria/regras/task-com-dono.md

@@ -0,0 +1,18 @@
+# Toda task tem dono
+
+**Gatilho:** criar pendência, fila do dia, pipeline de cliente, ou “fica pra depois”
+**Criada em:** 2026-07-24
+**Origem:** INVOS — solo + agentes; anti pendência eterna sem dono
+
+## Regra
+
+1. **Toda task tem dono:** `agente` ou `humano`. Sem dono = inválida (não grava).
+2. **Dono = agente** → o que dá pra fazer no repo/chat (redigir, arquivo, pesquisa, proposta draft, organizar `clientes/`). **Executa** sem empurrar pro humano, salvo bloqueio real.
+3. **Dono = humano** → só o que exige a pessoa: enviar DM de verdade, call, pagar, assinar, decisão de preço/risco, secret/acesso.
+4. Ao criar task `humano`: grava em `memoria/ativo.md` (**Fila humana**) **e alerta no chat** em 1 linha: `⚠️ Sua vez: [task] — done quando: […]`.
+5. Pendência em `ativo` / `clientes/_index.md` **sempre** com `desde: YYYY-MM-DD`. Se > 3 dias e ainda aberta → session-start **alerta atraso**.
+6. Arquivos gerados pro cliente (html, pdf, img, md) → **só** em `clientes/<slug>/arquivos/` (propostas em `propostas/`). Não na raiz do projeto.
+
+## Por quê
+
+Fila sem dono vira lixo eterno. Agente que só “sugere” o que poderia executar desperdiça o time de um. Humano só na restrição real.

package/kit/scripts/smoke-estado.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Smoke: estado vivo — deals pagos no _index não devem coexistir com "enviar proposta" + primeira sessão.
+set -euo pipefail
+INDEX="clientes/_index.md"
+PROJETOS="memoria/projetos.md"
+ATIVO="memoria/ativo.md"
+[[ -f "$INDEX" && -f "$PROJETOS" ]] || { echo "FAIL: falta index ou projetos"; exit 1; }
+
+PAID=$(grep -E '^\| [a-z0-9-]+ \|' "$INDEX" | grep -i '| pago |' | awk -F'|' '{gsub(/^ +| +$/,"",$2); print $2}' || true)
+if [[ -z "${PAID// }" ]]; then
+  echo "OK: nenhum deal pago no _index"
+  exit 0
+fi
+FAIL=0
+if echo "$PAID" | grep -q . && grep -qiE 'enviar proposta|fechar deal' "$PROJETOS"; then
+  # se projetos ainda tem enviar proposta E menciona algum slug pago
+  for slug in $PAID; do
+    if grep -qi "$slug" "$PROJETOS" 2>/dev/null && grep -qiE 'enviar proposta|fechar deal' "$PROJETOS"; then
+      echo "FAIL: slug pago '$slug' e projetos ainda tem 'enviar proposta/fechar deal'"
+      FAIL=1
+    fi
+  done
+fi
+if [[ -f "$ATIVO" ]] && grep -qi 'primeira sessão' "$ATIVO" && [[ -n "$PAID" ]]; then
+  echo "FAIL: deal pago mas ativo tem 'primeira sessão'"
+  FAIL=1
+fi
+if [[ $FAIL -eq 0 ]]; then
+  echo "OK: estado vivo coerente (pagos: $PAID)"
+  exit 0
+fi
+exit 1