iron-edge 2.28.1 → 2.29.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
@@ -263,7 +263,7 @@ O que esperar:
263
263
 
264
264
  **Sobre você** (desde a 2.25.0): a primeira conversa no chat oferece até 5 perguntas opcionais e guarda as respostas em `00 Sobre mim.md`, no cofre; a skill `loja` não repete o que já está lá.
265
265
 
266
- **Período Hoje** (desde a 2.26.0): a skill `anuncios` mede só o dia de hoje quando o pedido vem com `· hoje` ou o aluno pergunta "como está hoje"; o site guarda o último retrato de cada período.
266
+ **Período Hoje** (desde a 2.26.0): a skill `anuncios` mede só o dia de hoje quando o pedido vem com `· hoje` ou o aluno pergunta "como está hoje"; o site guarda o último retrato de cada período. Desde a 2.29.0, medir 7, 15 ou 30 dias também grava o retrato de hoje.
267
267
 
268
268
  **Outro Iron aberto** (desde a 2.27.0): o `ironoffice` mostra de que conta é a chave e, com outro Iron vivo no computador, não abre outro: diz desde quando e o que fazer (`--em-espera` abre assim mesmo). Antes de atualizar o plugin, atualiza a lista de plugins.
269
269
 
@@ -247,7 +247,7 @@ function outroIronAberto(home, o) {
247
247
  if (!pid || pid === d.self || !d.vivo(pid)) return null;
248
248
  let cmd = null;
249
249
  try { cmd = d.cmd(pid); } catch (_) { cmd = null; }
250
- if (cmd !== null && !cmd.includes('iron-office')) return null;
250
+ if (cmd !== null && !(cmd.includes('iron-office') && cmd.includes('server.mjs'))) return null; // onda 55: um editor aberto na pasta iron-office-channel nao e um Iron
251
251
  let since = null;
252
252
  try { since = d.mtime(trava); } catch (_) { since = null; }
253
253
  return { pid, since };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iron-edge",
3
- "version": "2.28.1",
3
+ "version": "2.29.0",
4
4
  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 24 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",
@@ -46,6 +46,8 @@ Nas ferramentas, `ad_account_id` é só o número (sem `act_`).
46
46
 
47
47
  **A janela N:** o pedido do botão vem como `anúncios: atualizar` (N = 7), `anúncios: atualizar · 15 dias` / `· 30 dias` ou `anúncios: atualizar · hoje` (N = 1); em texto, 'hoje', 'só hoje', 'como está hoje', 'o dia de hoje', '1 dia', 'último dia' → 1 ('ontem' ainda não existe: diga em 1 linha e meça hoje), 'últimos 15 dias' → 15, 'últimos 30 dias', 'esse mês', 'no mês' → 30, 'quinzena' → 15; sem número → 7; outro número de dias (2 ou mais) → o mais próximo entre 7, 15 e 30, dito em 1 linha. `since` = hoje − (N − 1), `until` = hoje. **Com N = 1, `since` = `until` = hoje** (o `d(0)` do comando do fuso): do começo do dia até agora, no fuso da conta. A janela de 3 dias do alerta C e a regra das 48 h da rampa **não mudam** com N = 1, e **com N = 1 os alertas A, `recusada` e `recusada_antiga` olham os últimos 3 dias** (a chamada do passo 3c), não só hoje: de manhã o dia ainda não gastou, e a peça que entrega à tarde viraria alerta falso no topo de todos os períodos.
48
48
 
49
+ **Com N de 7, 15 ou 30, meça também o dia de hoje e grave os dois retratos** (vale pro botão e pro pedido em texto). Meça primeiro os N dias inteiros (passos 3a a 3f); depois o retrato de hoje (`window_days: 1`) reaproveita tudo que não depende da janela: o fuso e as datas (passo 2), os grupos e a ficha; `alerts`, `ramp` e `checked` são os mesmos do retrato de N dias (passo 4), copiados sem medir de novo. O que se repete com `since` = `until` = hoje são só 3 chamadas: o passo 3a (por peça), o funil da conta (`level: "ad_account"`) e, com Shopify, o 3f (`ads_by_product` com `days` = 1). Sem a chamada de campanha de novo: os totais e as `campaigns` do retrato de hoje saem da soma das peças do 3a de hoje por `campaign_id` (`status`, `result_label` e a contagem de grupos vêm da leitura de N dias; campanha sem peça com número hoje vai com 0 no gasto, nas vezes que apareceu e nos resultados; `reach` e `frequency` da campanha vão `null`, porque não se somam, e o funil no topo vem da chamada da conta). Com N = 1 (o aluno pediu só hoje), nada disso se aplica: é uma medição só.
50
+
49
51
  ⛔ **Nunca `date_preset: "last_7d"` nem `last_3d`.** Eles deixam o dia de hoje de fora: a peça ligada ontem aparece com zero enquanto já está aparecendo, e você acusaria uma peça boa. Sempre `time_range` explícito, como texto JSON: `'{"since":"<hoje − (N − 1)>","until":"<hoje>"}'`.
50
52
 
51
53
  Antes de passar um campo novo em `fields`, confira com `ads_get_field_context` (a ferramenta recusa campo que não existe naquele nível). Os desta skill, conferidos em 30/10/2026.
@@ -105,6 +107,7 @@ Cada alerta leva a peça, a campanha, o número que o sustenta (`detail`, até 1
105
107
 
106
108
  - `products`, `outside`, `pending`: copiados do `ads_by_product` sem mexer; sem Shopify ou sem a resposta, **omita as 3 chaves**. `product_handle` em `top_ads`: só quando o `ad_handles` trouxer; senão omita a chave. O nome das campanhas no retrato é o mesmo que foi no `ads_by_product` (a coluna Produto da aba casa pelo nome), então não encurte só um dos lados.
107
109
  - `window_days`: a janela medida, 1 (hoje), 7, 15 ou 30 (sem esse campo o site conta como 7). O site guarda o último retrato de cada período: gravar o de hoje não apaga o de 7 dias.
110
+ - **Dois retratos (N de 7, 15 ou 30), nesta ordem: primeiro `ads_status` com `window_days: 1`, depois com `window_days: N`.** O mais novo fica sendo o período que o aluno pediu, e os alertas da tela são do mais novo; a resposta usa o que voltou da gravação de N. A medição de hoje falhou depois da de N dias já ter saído: grave a de N e diga em 1 linha que a de hoje não veio.
108
111
  - Os números do funil (no topo, em cada campanha e nas peças) são **planos** (número direto, nunca objeto dentro de objeto) e vão `null` quando a Meta não mandou: **campo que a Meta não mandou vai como `null`, nunca 0**.
109
112
  - `campaigns`: até 10, as que gastaram mais primeiro. `status` = o `effective_status` como veio (`ACTIVE`, `PAUSED`, `ARCHIVED`, `CAMPAIGN_PAUSED`…): o site mostra `ACTIVE` como "no ar" (ou "parada: nenhum grupo no ar" / "no ar · N de M grupos", pela contagem abaixo) e o resto como "pausada". `adsets_active` e `adsets_total` = a contagem de grupos do passo (c) (campanha sem grupo lido: mande os dois em 0). `top_ads`: as 5 peças que mais gastaram. `alerts` e `ramp`: até 10 cada. `cpa` = gasto ÷ resultados (`null` sem resultado); o site compara o CPA máximo com **gasto ÷ compras** (`purchases`), nunca com esse `cpa`, porque resultados de objetivos diferentes (engajamento, conversa) não são venda. Cada campanha leva também as `impressions` dela (o site divide o "parou nos 3 s" só pelas campanhas com vídeo). `checked.ads` = peças medidas; `checked.copy` = peças com texto lido.
110
113
  - Até 8 kB: nomes longos, encurte. Nome com telefone, e-mail ou `@perfil` chega no site como `[removido]` (o filtro protege o aluno); é esperado.
@@ -116,7 +119,7 @@ Na ficha: a linha Anúncios com a conta (se faltava) e 1 linha no Histórico: `A
116
119
 
117
120
  Leia o `funil.md` (nesta pasta) antes de interpretar o funil.
118
121
 
119
- Até 6 linhas. **Com N = 1**, troque "Últimos N dias" por "Hoje, até HH:MM (<fuso da conta>)" e acrescente na linha 1: "o dia ainda não fechou: os números sobem até a Meta fechar o dia".
122
+ Até 6 linhas, a resposta do período N (uma só, mesmo gravando dois retratos), mais 1 no fim quando o retrato de hoje foi gravado junto: "Hoje, até HH:MM: <gasto> e <purchases> compras." (sem compra hoje, `purchases` 0 ou `null`: "Hoje, até HH:MM: <gasto>, sem compra no site."). **Com N = 1**, troque "Últimos N dias" por "Hoje, até HH:MM (<fuso da conta>)" e acrescente na linha 1: "o dia ainda não fechou: os números sobem até a Meta fechar o dia".
120
123
  1. **Com compras no período** (`purchases` > 0): `Últimos N dias: <gasto> e <purchases> compras no site (custo por compra <valor>)`, os mesmos 3 números do cartão da aba: gasto e compras totais, e o custo = (gasto − `outside.spend`) ÷ (compras − `outside.purchases`). Todas as compras de fora: em vez do custo, "sem compra nos produtos pra calcular o custo". Com `outside.spend` ou `outside.purchases` acima de zero, acrescente a frase da aba: `O custo por compra não conta os <outside.spend> que ficaram fora dos produtos` (e, com compras lá, `nem as <N> compras deles`).
121
124
  **Sem compra** (`purchases` 0 ou `null`): com um objetivo só, `Últimos N dias: <gasto> e <N> <rótulo> (custo por resultado <valor>)`, dizendo "0 compras no site" se `purchases` for 0. Com objetivos diferentes (diga também "0 compras no site" se `purchases` for 0), `Últimos N dias: <gasto>. Resultados de tipos diferentes (<N> conversas, <M> engajamentos): não dá pra dividir o gasto; veja o funil.` **Nunca some resultados de objetivos diferentes** (compras + conversas + engajamentos) nem mostre custo por resultado misturado.
122
125
  2. "<N> alertas" ou "Nenhum alerta de peça hoje." (alerta é de peça: o funil e o CPA vêm nas linhas de baixo). Conte só os alertas vivos; se houver antigas, acrescente numa linha só "N peças antigas recusadas em campanha parada (sem ação)". Nunca ofereça pausar peça `recusada_antiga`.
@@ -142,6 +145,7 @@ Os dois lados, sempre:
142
145
  - **Recusada com a campanha no ar:** peça `DISAPPROVED` com data futura, em campanha `ACTIVE` → `recusada` (o filtro "só no ar" não vale pra ela).
143
146
  - **Antiga × viva:** peça `DISAPPROVED` de 2022 em campanha `PAUSED` sem gasto → `recusada_antiga`; a mesma peça com a campanha `ACTIVE` → `recusada`.
144
147
  - **Por produto:** peça com visita a `/products/x` → produto x; campanha de engajamento sem produto → fora do custo por compra; campanha de venda sem visita a produto, com ou sem compra → pergunta "é de qual produto?".
145
- - **Botão:** 2 pedidos `anúncios: atualizar` seguidos → 2 gravações; ficha mudou entre eles → o 2º usa a ficha nova.
148
+ - **Botão:** 2 pedidos `anúncios: atualizar` seguidos → 2 gravações de N dias; ficha mudou entre eles → o 2º usa a ficha nova.
149
+ - **Hoje junto:** `anúncios: atualizar · 30 dias` → 2 `ads_status`, o de `window_days: 1` antes do de 30; `anúncios: atualizar · hoje` → 1 só.
146
150
  - **Resposta:** janela com aquecimento → resposta por compra, sem "3.340 resultados".
147
151
  Mudou uma regra e um dos dois lados deixou de bater? A skill quebrou, não a conta.
@@ -25,9 +25,11 @@ Na mensagem do porteiro estão o **item** (nome do pacote, link do script, repos
25
25
 
26
26
  ## 2. Onde olhar, por tipo (só leitura)
27
27
 
28
+ Leia a saída do `npm view`, do `curl` e do `pip index` **direto no terminal**. Nunca passe pra `node -e`, `python -c`, `| sh` ou `| node`: o porteiro barra e o estudo trava.
29
+
28
30
  | Tipo | Fonte | O que tirar |
29
31
  |---|---|---|
30
- | pacote npm, pacote executado (e "pacote de um link") | `npm view <pacote> --json` (só lê o registro, não instala) e `https://api.npmjs.org/downloads/point/last-week/<pacote>` | versões e data de cada uma, mantenedores, dependências, `scripts.preinstall`/`install`/`postinstall`, repositório, licença, data de criação |
32
+ | pacote npm, pacote executado (e "pacote de um link") | `npm view <pacote> --json` (só lê o registro, não instala; leia a saída direto, sem `node -e`) e `https://api.npmjs.org/downloads/point/last-week/<pacote>` | versões e data de cada uma, mantenedores, dependências, `scripts.preinstall`/`install`/`postinstall`, repositório, licença, data de criação |
31
33
  | pacote Python | `https://pypi.org/pypi/<pacote>/json` | versões e datas, autor, projeto (repositório), licença, se exige compilar |
32
34
  | programa do Homebrew | `https://formulae.brew.sh/api/formula/<nome>.json` (ou `/cask/<nome>.json`) | de onde baixa, versão, se é oficial do Homebrew |
33
35
  | repositório git | `https://api.github.com/repos/<dono>/<repo>` (e `/contributors`) | estrelas, data do último commit, issues abertas, idade, quem mantém |