iron-edge 2.14.0 → 2.14.1

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.
package/README.md CHANGED
@@ -249,7 +249,7 @@ O que esperar:
249
249
  5. **Ficha da loja** (skill `loja`, desde a 2.8.0): no site, "Começar com a loja X" (ou diga "monta a ficha"). O Iron lê a Shopify da loja, aponta o que está errado, pergunta só o que falta e grava `Projetos/<loja>/PROJETO.md` e `brand.json` no seu cofre; pro site vai só um resumo de até 600 caracteres (sem sócio, fornecedor, conta de anúncio nem pedido). Daí em diante todo pedido daquela loja chega com a ficha. Desde a 2.9.0, no site as perguntas vêm uma por vez, com botões.
250
250
  **Trilha da loja** (skill `trilha`, desde a 2.9.0): no chat, o botão da loja mostra "4/13 etapas" e o atalho **Trilha** (o primeiro, acima da caixa de mensagem) abre a lista (marca, idioma, imagens, velocidade, página de obrigado, pixel, WhatsApp, Instagram, conta de anúncio, compra teste…). "Pedir ao Iron" manda a etapa; o Iron mede na loja e na Meta, faz o que dá e grava a prova que mediu. Etapa que só você pode fazer (login, cartão, configuração no admin) vira um passo no AGORA VOCÊ. Desde a 2.10.0 o Iron conduz todas as etapas de quem já tem loja (skills `rastreamento-pixel` e `navegador`). Desde a 2.11.0 conduz também o caminho de quem ainda não tem loja: produto e nicho (com 3 concorrentes que anunciam agora) e nome com domínio e @ livres (medidos); a ficha do projeto nasce no cofre.
251
251
 
252
- **Funil e precificação** (desde a 2.14.0): o retrato dos anúncios traz o funil (parou nos 3 s, ficou assistindo, clicou no link, clique virou visita, visita virou carrinho, carrinho virou checkout, checkout virou compra, compras por visita, vezes por pessoa) e o resultado de cada campanha no nome certo ("engajamentos" não cai em "compras"). A skill `anuncios` lê a régua em `skills/anuncios/funil.md` e responde onde o funil vaza e, com a precificação preenchida na aba Anúncios, o CPA real contra o máximo (sobra, paga a conta, prejuízo). Na skill `loja`, "custos da loja" grava o custo dos produtos na Shopify (você confirma antes; só o custo passa).
252
+ **Funil e precificação** (desde a 2.14.0): o retrato dos anúncios traz o funil (parou nos 3 s, ficou assistindo, clicou no link, clique virou visita, visita virou carrinho, carrinho virou checkout, checkout virou compra, compras por visita, vezes por pessoa) e o resultado de cada campanha no nome certo ("engajamentos" não cai em "compras"). A skill `anuncios` lê a régua em `skills/anuncios/funil.md` e responde onde o funil vaza e, com a precificação preenchida na aba Anúncios, o CPA real contra o máximo (sobra, paga a conta, prejuízo). Na skill `loja`, "custos da loja" grava o custo dos produtos na Shopify (você confirma antes; só o custo passa). Desde a 2.14.1 o Iron lê sempre o texto das peças (inclusive as de vídeo) e a aba diz quantas conferiu.
253
253
 
254
254
  **Atualização sozinha** (desde a 2.13.0): antes de abrir, o `ironoffice` compara a versão instalada (`~/.iron/install-manifest.json`) com a do pacote e, se estiver atrás, roda o mesmo `npx iron-edge update` (sem mexer no atalho do shell): troca só o arquivo do pacote que você não editou, avisa antes (`Atualizando o Iron 2.12.0 -> 2.13.0 (alguns segundos, nao feche)...`) e imprime 1 linha no fim (`Iron atualizado 2.12.0 -> 2.13.0: N arquivo(s) trocado(s), M ficaram como estavam (voce mexeu neles)`). Sem internet ou com erro, abre com a versão que está e avisa. `npx iron-edge office --sem-update` pula.
255
255
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iron-edge",
3
- "version": "2.14.0",
3
+ "version": "2.14.1",
4
4
  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 20 skills, com quality gate, memoria, instalador que nunca sobrescreve o comando office (chat do Iron Office no dashboard; confere a chave com o site antes de abrir o Claude) e o doctor (mede a maquina e acende o Setup do site).",
5
5
  "keywords": [
6
6
  "claude",
@@ -57,7 +57,7 @@ b) **Por campanha, 7 dias:** a mesma chamada com `level: "campaign"` e `fields:
57
57
  **Tradução dos campos** (conta e campanha): `reach` = `reach`; `frequency` = `frequency`; `video_3s` = `3_second_video_plays`; `thruplay` = `video_thruplay_watched_actions`; `link_clicks` = `link_click`; `lpv` = `landing_page_view`; `view_content` = `omni_view_content`; `atc` = `omni_add_to_cart`; `ic` = `omni_initiated_checkout`; `payment` = `null`; `purchases` = `omni_purchase`; `revenue` = o `value` de `omni_purchase_values`.
58
58
  c) **Por peça, 3 dias** (só pro alerta C): `level: "ad"`, `time_range` `'{"since":"<hoje − 2>","until":"<hoje>"}'`, `fields: ["name","campaign_name","adset_id","effective_status","amount_spent"]`, até a última página. O gasto do grupo nos 3 dias = soma das peças dele por `adset_id`. **Grupos, 7 dias:** `level: "adset"` com `fields: ["name","campaign_id","effective_status","optimization_goal"]`, até a última página. Serve pro rótulo do resultado e pra contar, **por campanha** (junte pelo `campaign_id` do grupo = o `id` da campanha, nunca pelo nome), quantos grupos ela tem (`adsets_total`) e quantos estão no ar (`adsets_active`: `effective_status` `ACTIVE`, `WITH_ISSUES`, `IN_PROCESS`, `PENDING_REVIEW` ou `PREAPPROVED`). Campanha `ACTIVE` com todos os grupos pausados não gasta: a aba mostra "parada: nenhum grupo no ar" com esses dois números. O **`result_label` de cada campanha** sai do `optimization_goal` dos grupos dela (a mesma tradução do rótulo da conta, abaixo): uma campanha de engajamento não pode aparecer na coluna de compras.
59
59
  d) **Erros:** `ads_get_errors` com `entity_ids: ["<número da conta>"]` (traz os erros das peças dela).
60
- e) **Texto e link das peças:** `ads_get_creatives` com `creative_ids` (os do passo a, em lotes) e `fields: ["body","title","link_url"]`. Se o `link_url` tiver `/products/<handle>`, o `<handle>` vai na peça como `product_handle` (letras minúsculas, números e hífen; até 60). Medido: criativo de vídeo costuma vir **sem** `link_url`; sem link, a peça fica sem `product_handle` e o site compara com o produto principal do projeto. Não chute o handle pelo nome da peça.
60
+ e) **Texto e link das peças (obrigatório, mesmo sem alerta de data):** `ads_get_creatives` com `creative_ids` (os do passo a, em lotes) e `fields: ["body","title","link_url"]`. Medido em 30/10/2026: o texto (`body` e `title`) vem **também nos criativos de vídeo**. Conte aqui `checked.copy` = quantas peças voltaram com `body` ou `title` não vazio, e `checked.ads` = quantas peças você mediu no passo a. Chamada falhou: diga na resposta "não consegui ler o texto das peças". Chamada ok e nenhuma peça com texto: `checked.copy` 0 e diga "as peças estão sem texto (só a arte)". Se o `link_url` tiver `/products/<handle>`, o `<handle>` vai na peça como `product_handle` (letras minúsculas, números e hífen; até 60). Medido: criativo de vídeo costuma vir **sem** `link_url`; sem link, a peça fica sem `product_handle` e o site compara com o produto principal do projeto. Não chute o handle pelo nome da peça.
61
61
 
62
62
  **Resultado** = o que a campanha busca (compra, conversa, cadastro): leia o `indicator` do `results`, o `objective` da campanha e o `optimization_goal` do grupo e escreva o rótulo em palavra de aluno ("compras no site", "conversas no WhatsApp", "cadastros", "engajamentos"; até 24 letras). Ele vale **por campanha** (`result_label` dela) e pra conta. Campanhas com tipos de resultado diferentes: some `results` mesmo assim e use "resultados" no rótulo, dizendo na resposta quais tipos entraram. Em dúvida, "resultados".
63
63