iron-edge 2.36.0 → 2.37.0

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
@@ -260,7 +260,7 @@ O que esperar:
260
260
 
261
261
  **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.
262
262
 
263
- **Imagens** (skill `imagens`, desde a 2.15.0): no chat, "gera uma imagem do <produto> pro feed" (ou story, quadrado, banner). O Iron monta o pedido com o produto e a marca da loja, mostra quanto vai custar na sua conta do provedor e só gera no seu sim. Quem gera é o site, com a chave da OpenAI ou do fal que você cola em Integrações → Imagens (fica cifrada no servidor, nunca volta pro computador); a imagem fica na aba Imagens da loja, no tamanho certo do destino. As regras da casa (sem logo desenhado, roupa lisa, sem texto) ficam em `skills/imagens/regras.md`. Desde a 2.16.0: com produto da Shopify, a imagem nasce da **foto real** dele (sai a mesma peça, muda a cena); "sobe essa na página do produto" põe a imagem na Shopify depois do seu sim (e "tira essa da Shopify" desfaz); sem chave de provedor, o Iron entrega o **pedido pronto** pra você colar na ferramenta de imagem que já usa, com a foto do produto anexada. Na aba Imagens, o botão **Pedir imagem** monta o pedido e leva pro chat. Desde a 2.16.1, a imagem com a foto real mantém a marcação do próprio produto (logo, selo, texto impresso); pra tirar, peça "sem a marcação".
263
+ **Imagens** (skill `imagens`, desde a 2.15.0): no chat, "gera uma imagem do <produto> pro feed" (ou story, quadrado, banner). O Iron monta o pedido com o produto e a marca da loja, mostra quanto vai custar na sua conta do provedor e só gera no seu sim. Quem gera é o site, com a chave da OpenAI ou do fal que você cola em Integrações → Imagens (fica cifrada no servidor, nunca volta pro computador); a imagem fica na aba Imagens da loja, no tamanho certo do destino. As regras da casa (sem logo desenhado, roupa lisa, sem texto) ficam em `skills/imagens/regras.md`. Desde a 2.16.0: com produto da Shopify, a imagem nasce da **foto real** dele (sai a mesma peça, muda a cena); "sobe essa na página do produto" põe a imagem na Shopify depois do seu sim (e "tira essa da Shopify" desfaz); sem chave de provedor, o Iron entrega o **pedido pronto** pra você colar na ferramenta de imagem que já usa, com a foto do produto anexada. Na aba Imagens, o botão **Pedir imagem** monta o pedido e leva pro chat. Desde a 2.16.1, a imagem com a foto real mantém a marcação do próprio produto (logo, selo, texto impresso); pra tirar, peça "sem a marcação". Desde a 2.37.0 (plugin 0.29.0): com duas ou mais imagens, o Iron mostra as **miniaturas** no chat e você clica na que quer; na aba Imagens, o botão **Escolhi esta** faz o mesmo. O Iron traz o **arquivo original** pro cofre (`Projetos/<loja>/marca/originais/`, ferramenta `image_get`), nunca redesenha a imagem que você aprovou, e o logo aprovado sai também **sem fundo** (PNG transparente, recortado pelo site quando o fundo é liso).
264
264
 
265
265
  **Página de vendas na lógica de quem já vende** (skill `clone-persuasion`, desde a 2.17.0): no chat, "quero vender como esta página: <link>" e diga o produto. O Iron estuda por que a página vende (gancho, oferta, provas, ordem das partes, imagens) e escreve a sua com essa lógica e com as suas palavras: antes, pergunta como você fala com seu cliente (uma pergunta por vez) e grava na ficha da loja. Nada é copiado: um verificador barra 8 palavras seguidas iguais à página de referência (se você preferir reaproveitar frases, ele pergunta antes e avisa o risco). O que você não informou (preço, depoimento, garantia) fica marcado `[PREENCHER]` e listado no fim, nunca inventado. A página entra em Entregas e em Páginas como rascunho. Desde a 2.17.1, o que falta (preço, garantia, frete…) vira um formulário no próprio chat: você responde, pula o que não sabe, e o Iron devolve a página com as respostas no lugar.
266
266
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iron-edge",
3
- "version": "2.36.0",
3
+ "version": "2.37.0",
4
4
  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 26 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",
@@ -24,12 +24,21 @@ description: Cria identidade visual completa e kit de logo premium para QUALQUER
24
24
 
25
25
  ## REGRAS DE OURO (valem o tempo todo)
26
26
 
27
+ 0. **Logo aprovado não se redesenha.** O aluno aprovou uma imagem gerada por IA COMO O LOGO? **Ela é o logo oficial**, do jeito que está. Clicar numa miniatura (ou em "Escolhi esta") é escolher a imagem; antes de travar, confirme com UMA `ask`: "Esta imagem é o logo final da sua marca?" (opções "Sim, é o logo" · "Não, é só a direção"). "Sim" = regra 0. "Só a direção" = siga as fases do vetor, dizendo que o desenho novo vai ser outro, inspirado nela. Sem confirmar, não trave nada. Proibido: redesenhar à mão em vetor, refazer a partir de print de tela, "limpar" ou "melhorar" letra, trocar fonte ou proporção. O caminho é um só:
28
+ - `image_get` (skill `imagens`, seção "Imagem escolhida") traz o arquivo ORIGINAL pro cofre (`Projetos/<loja>/marca/originais/`);
29
+ - `image_get` com `kind: "alpha"` traz o mesmo desenho em PNG sem fundo, recortado pelo site pixel a pixel. Esse PNG transparente é o **logo oficial em imagem**;
30
+ - vetor (SVG): o Iron Office ainda não vetoriza sem mudar o desenho (o contorno automático não ficou fiel nas letras finas). Diga ao aluno, com todas as letras: "O logo oficial fica em imagem, com fundo transparente. Se você precisar dele em vetor (gráfica, bordado, placa grande), um designer redesenha a partir deste arquivo." Nunca entregue um vetor feito por você no lugar do logo aprovado, e nunca instale programa pra vetorizar.
31
+ - O recorte voltou `ok: false` (fundo não liso, ou desenho com brilho, sombra ou degradê): fica o original com o fundo, e diga ao aluno a frase do retorno.
32
+ - Com logo aprovado, **pule as Fases 3, 4 e 5** (não se desenha nem refina símbolo, nem se monta lockup com outro desenho) e, na Fase 6, o kit é: o original (`kind: "original"`), o PNG sem fundo (`kind: "alpha"`, peça os dois sempre, um depois do outro) e os tamanhos de ícone feitos só por redimensionamento desses arquivos. Versão em 1 cor, troca de cor e SVG ficam fora: diga a frase do designer. A Fase 7 (guidelines) usa o logo como imagem.
33
+ - `image_get` deu erro (imagem não encontrada, de outra loja, site fora do ar): diga ao aluno em 1 linha o que o retorno disse e pare ali. Nunca contorne com `curl`, print, navegador ou redesenho.
34
+ - O arquivo fica no cofre (`Projetos/<loja>/marca/originais/`) ou, sem cofre, em `Iron Office/<loja>/marca/originais/` na pasta do usuário: diga o `path` que o `image_get` devolveu.
35
+ As regras 2 e 6, as Fases 3 a 5 e a seção "Conceitos de símbolo por IA" valem só quando **não** há imagem aprovada (logo que nasce em vetor, desenhado aqui do zero).
27
36
  1. **Decisão é do cliente, com base visual.** Nunca adivinhe gosto. Mostre opções lado a lado (renderizadas) e recomende uma. Ele escolhe.
28
37
  2. **Logo premium é FLAT.** Forma sólida, uma cor chapada, sem gradiente, sem 3D, sem sombra. Estude como Nike (forma única com movimento), Apple (negative space + grid) e Whoop (geometria + 1 acento) são construídos. Tem que funcionar a **16px** e em **preto e branco**. Se precisa de brilho pra ficar bonito, não está resolvido.
29
38
  3. **Uma cor é o acento/"sinal".** Aparece pouco e sempre significa a mesma coisa. Nunca preenche grandes áreas.
30
39
  4. **Anti-vícios de linguagem** (em todo texto: copy, PDF, mockups): nunca use travessão (—), nem a antítese "não é X, é Y", nem negação dramática em duas frases. Afirme direto.
31
40
  5. **Hierarquia, sem pular etapas:** identidade → logo → assets → aplicação.
32
- 6. **Render 3D de IA ≠ logo.** Imagem de IA (skill `imagens`) serve como direção criativa. O logo final é vetor flat. Marca premium tem os dois (o render vira peça hero; o vetor é o logo).
41
+ 6. **Render 3D de IA ≠ logo** (quando o aluno ainda não aprovou nenhuma imagem: com imagem aprovada, vale a regra 0). Imagem de IA (skill `imagens`) serve como direção criativa. O logo final é vetor flat. Marca premium tem os dois (o render vira peça hero; o vetor é o logo).
33
42
 
34
43
  ---
35
44
 
@@ -49,7 +58,7 @@ description: Cria identidade visual completa e kit de logo premium para QUALQUER
49
58
 
50
59
  **FASE 2 — Direção.** 3-4 territórios visuais (cor + tipo de símbolo + tipografia + referência). Recomende um. Antes de desenhar, pergunte 3 coisas que mudam tudo: (a) base do estudo, (b) cor (abrir leque vs refinar), (c) nível do símbolo (minimalismo com personalidade vs elaborado).
51
60
 
52
- **FASE 3 — Conceitos.** 4-6 símbolos em SVG, renderizados num board PNG. Se pedirem mais criatividade, gere conceitos por IA (skill `imagens`, se o aluno tem chave de imagem em Integrações; sem chave, siga só no vetor) como referência. Cliente escolhe a direção.
61
+ **FASE 3 — Conceitos.** (Com logo aprovado pela regra 0, pule para a Fase 6.) 4-6 símbolos em SVG, renderizados num board PNG. Se pedirem mais criatividade, gere conceitos por IA (skill `imagens`, se o aluno tem chave de imagem em Integrações; sem chave, siga só no vetor) como referência. Cliente escolhe a direção.
53
62
 
54
63
  **FASE 4 — Refino.** Itere o traço do símbolo escolhido (ângulo, peso, proporção), mostrando variações em PNG. Depois a COR: símbolo em 5-6 cores sólidas lado a lado pra cravar. Sempre renderize.
55
64
 
@@ -112,7 +121,7 @@ fs.writeFileSync(outPng, r.render().asPng());
112
121
  > Por quê: o Chrome headless em loop pendura no sandbox, e `@import` de fonte por rede falha. resvg resolve os dois.
113
122
 
114
123
  ### Conceitos de símbolo por IA (opcional)
115
- Se o aluno tem chave de imagem em Integrações, use a skill `imagens` pedindo "brand symbol / app icon, minimalista, premium, muito espaço negativo, [paleta], sem texto". São referências de direção; depois vetorize a escolha em SVG flat. Sem chave, siga só no vetor.
124
+ Se o aluno tem chave de imagem em Integrações, use a skill `imagens` pedindo "brand symbol / app icon, minimalista, premium, muito espaço negativo, [paleta], sem texto". Mostre as opções pela `ask` com `images` (miniaturas; nunca os links). **Se o aluno aprovar uma delas como o logo, vale a regra 0** (ela é o logo; não se vetoriza à mão). Se ele quiser só a direção pra um logo novo em vetor, aí sim desenhe o SVG flat do zero, dizendo antes que é um desenho novo inspirado na imagem. Sem chave, siga só no vetor.
116
125
 
117
126
  ### Tamanhos de ícone
118
127
  ```bash
@@ -46,7 +46,7 @@ Aviso único por conversa: com a foto real, etiqueta **anúncio** e marca visív
46
46
  A mesma chamada (mesmo `prompt`, `destination`, `provider`, `n`, `reference`) **sem** `dry_run` e **com o `quote`**. Leva até 2 minutos: antes, um `reply` curto "Gerando, leva até 2 minutos. Não peça de novo enquanto isso." Passaram 15 minutos desde o custo? Peça o custo de novo (o `quote` venceu).
47
47
 
48
48
  ## 8. Responder
49
- "Pronta: <destino> <largura>×<altura> · US$ <cost_usd> · <url>. Está na aba Imagens da loja." e mais 1 frase: **com a foto real** → "A marcação do produto ficou como na foto."; **com "sem a marcação"** → "Tirei a marcação do produto de propósito, como você pediu."; **sem foto real** → "Ela sai sem logo de propósito: ponha o logo da marca depois, no editor que você usa." (O `url` abre a imagem na aba Imagens do site, com o botão Baixar. Mande esse link como veio, nunca um link do Supabase.) Com `images` (mais de uma), mande os links todos. Com `partial`: "Gerei <generated> e cobrei todas, mas só <saved> foram guardadas." Guarde o `id` da imagem (pro passo 9). Com a foto real, termine com "Se quiser, eu ponho na página do produto na Shopify: é só pedir." (sem subir e sem perguntar de novo).
49
+ "Pronta: <destino> <largura>×<altura> · US$ <cost_usd> · <url>. Está na aba Imagens da loja." e mais 1 frase: **com a foto real** → "A marcação do produto ficou como na foto."; **com "sem a marcação"** → "Tirei a marcação do produto de propósito, como você pediu."; **sem foto real** → "Ela sai sem logo de propósito: ponha o logo da marca depois, no editor que você usa." (O `url` abre a imagem na aba Imagens do site, com o botão Baixar. Mande esse link como veio, nunca um link do Supabase.) **Com `images` (duas ou mais), não mande os links:** mande a frase de custo num `reply` curto e, logo depois, a `ask` "Qual destas?" com `images` = os `id` na ordem (até 8) e `skip: true`. O aluno clica na miniatura; o clique chega como `imagem escolhida: <id>` (seção abaixo). Com `partial`: "Gerei <generated> e cobrei todas, mas só <saved> foram guardadas." Guarde o `id` da imagem (pro passo 9). Com a foto real, termine com "Se quiser, eu ponho na página do produto na Shopify: é só pedir." (sem subir e sem perguntar de novo).
50
50
 
51
51
  ## 9. Subir na Shopify (só se o aluno pedir)
52
52
  "sobe essa na página do produto", "coloca na loja": mande a `ask` "Subo a imagem na página do produto <título>? Fica visível na loja na hora. Se não gostar, é só pedir 'tira essa da Shopify'." (Sim / Não; se ele citou variante: "…e prendo na variante <x>"). **Só no Sim**, `image_to_shopify` com `image_id`, `project_id`, `product_handle` e `variant_ids` (os `id` das variantes, se pediu). Responda: `status: "pronta"` → "Está na página do produto <título> (última foto). Pra tirar: 'tira essa da Shopify' ou o botão no detalhe da imagem." · `"processando"` → "Subiu; a Shopify ainda está processando. Confira a página em 1 minuto."
@@ -65,4 +65,11 @@ A mesma chamada (mesmo `prompt`, `destination`, `provider`, `n`, `reference`) **
65
65
  - Qualquer outro `reason` (`shopify`, `shopify fora`, `limite indisponível`, `pedido inválido`, `erro`…): diga a frase que o site mandou; se for tentar de novo, avise antes e tente uma vez só.
66
66
 
67
67
  ## Variação ("variação da imagem <id>: …")
68
- Você não vê a imagem (o site guarda; o Iron só recebe o link na hora de gerar). Pegue o que vem depois dos dois-pontos como a mudança pedida; se estiver vazio, pergunte "o que você quer diferente nela?". Monte um pedido novo (passos 2 a 4, com a foto real do produto quando houver) com a mudança e siga do passo 5: variação também custa e também pede o sim.
68
+ Pra ver a imagem, traga o original com `image_get` (`project_id` e o id COMPLETO) e leia o arquivo. Se você só tem os 8 primeiros (o botão "Pedir variação" manda assim), peça ao aluno, numa `ask`, pra abrir a imagem na aba Imagens e tocar em **Escolhi esta** (o clique traz o id completo); nunca peça pra ele copiar código. Pegue o que vem depois dos dois-pontos como a mudança pedida; se estiver vazio, pergunte "o que você quer diferente nela?". Monte um pedido novo (passos 2 a 4, com a foto real do produto quando houver) com a mudança e siga do passo 5: variação também custa e também pede o sim.
69
+
70
+ ## Imagem escolhida ("imagem escolhida: <id>")
71
+ Chega quando o aluno clica numa miniatura da `ask` ou no botão **Escolhi esta** (aba Imagens). O `<id>` é o id COMPLETO.
72
+ 1. `image_get` com `project_id` (a linha `[loja: …]`) e `image_id` = esse id. Volta o `path` do arquivo original (no cofre, `Projetos/<loja>/marca/originais/`; sem cofre, `Iron Office/<loja>/marca/originais/` na pasta do usuário) e o `sha256`. Leia o arquivo pelo `path` pra ver a imagem. Deu erro (não encontrada, outra loja, site fora): diga em 1 linha o que o retorno disse e pare; nunca contorne.
73
+ 2. Responda em 1 linha: "Guardei o original da imagem que você escolheu, na pasta marca/originais da sua loja." e siga o pedido que estava em andamento (no brand kit, a regra "Logo aprovado não se redesenha" da skill `brandkit`).
74
+ 3. Chegou outra `imagem escolhida` depois? A escolha nova vale: traga o original dela e diga "Troquei: agora vale a imagem <8 primeiros do id>."
75
+ 4. **Imagem que o aluno aprovou é a imagem.** Nunca redesenhe, nunca refaça a partir de print de tela, nunca baixe por `curl` nem pelo navegador: o original vem só pelo `image_get`. Logo, marca ou ícone: peça também o sem fundo (`image_get` com `kind: "alpha"`, PNG recortado pelo site). Volta `ok: false` (fundo não liso, ou desenho com brilho, sombra ou degradê): fica o original, e diga ao aluno a frase do retorno.