iron-edge 2.12.0 → 2.13.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
@@ -249,7 +249,9 @@ 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
- **Anúncios** (skill `anuncios`, desde a 2.12.0): na aba Anúncios do site, o botão **Atualizar agora** (ou no chat "como estão meus anúncios") faz o Iron medir os últimos 7 dias da sua conta da Meta e mostrar gasto, resultados, custo por resultado e o que corrigir hoje: peça nova que não aparece há mais de 48 h, data vencida ainda no ar, dinheiro indo pra peça vencida e peça recusada. O Iron só lê; pausar uma peça ele pergunta antes. A Meta tem que estar ligada no seu Iron (`/mcp` → `meta-ads` → Authenticate).
252
+ **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.
253
+
254
+ **Anúncios** (skill `anuncios`, desde a 2.12.0): na aba Anúncios do site, o botão **Atualizar agora** (ou no chat "como estão meus anúncios") faz o Iron medir os últimos 7 dias da sua conta da Meta e mostrar gasto, resultados, custo por resultado e o que corrigir hoje (desde a 2.13.0 sem sair da aba; campanha no ar com todos os grupos pausados aparece como "parada"): peça nova que não aparece há mais de 48 h, data vencida ainda no ar, dinheiro indo pra peça vencida e peça recusada. O Iron só lê; pausar uma peça ele pergunta antes. A Meta tem que estar ligada no seu Iron (`/mcp` → `meta-ads` → Authenticate).
253
255
  6. **Deixe essa aba do terminal aberta.** É ela que faz o Iron responder no site.
254
256
  7. **Pra fechar:** Ctrl+C duas vezes ou `/exit`, e o escritório anoitece em 1 a 2 segundos. No **Warp**, fechar a aba pelo X demora cerca de 1 minuto: o Warp guarda a aba fechada pra poder reabrir, e nesse tempo o canal ainda está vivo. Feche com Ctrl+C antes do X, ou desligue a reabertura de abas fechadas nas configurações do Warp.
255
257
 
package/bin/iron-edge.js CHANGED
@@ -14,8 +14,9 @@
14
14
  * arquivos cujo hash bate com o manifesto — os que
15
15
  * ninguem alterou — e preserva o resto
16
16
  *
17
- * office [--safe] [--sem-feed|--com-feed] liga o Iron Office: instala o plugin de canal e abre o
18
- * Claude Code conversando com o chat do dashboard
17
+ * office [--safe] [--sem-feed|--com-feed] [--sem-update] liga o Iron Office: instala o plugin de
18
+ * canal, atualiza as skills e agentes do Iron (o mesmo `update`;
19
+ * --sem-update pula) e abre o Claude Code conversando com o chat
19
20
  *
20
21
  * doctor [--json] mede a maquina (Node, git, Claude Code, Iron Edge, chave,
21
22
  * plugin, cofre, atalho) e, com a chave aceita, manda o resultado
@@ -174,6 +175,6 @@ if (cmd === 'install') {
174
175
  process.exit(r.status ?? 1);
175
176
 
176
177
  } else {
177
- console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre|--sem-cofre] [--safe] [--sem-feed|--com-feed] [--json]');
178
+ console.log('uso: iron-edge <install|update|verify|office|doctor|uninstall> [--dry-run] [--source <dir>] [--cofre|--sem-cofre] [--safe] [--sem-feed|--com-feed] [--sem-update] [--json]');
178
179
  process.exit(cmd && cmd !== '--help' && cmd !== '-h' ? 1 : 0);
179
180
  }
@@ -8,7 +8,8 @@
8
8
  * faz o Iron responder no site.
9
9
  *
10
10
  * Flags: --safe tira o `--permission-mode bypassPermissions` (o Claude pede licenca a cada
11
- * ferramenta). --sem-feed / --com-feed gravam `office_feed: off|on` no ~/.iron/config.yaml (onda 21).
11
+ * ferramenta). --sem-update nao atualiza as skills e agentes do Iron antes de abrir (onda 28 rev1).
12
+ * --sem-feed / --com-feed gravam `office_feed: off|on` no ~/.iron/config.yaml (onda 21).
12
13
  * Qualquer outro argumento vai direto pro `claude`.
13
14
  *
14
15
  * Consentimento (onda 21): na primeira abertura (ou quando o texto muda de versao) mostra o que o canal
@@ -39,7 +40,7 @@ const { perguntaSN } = require('./pergunta');
39
40
  const { setFeed } = require('./feed');
40
41
 
41
42
  // Muda a versao quando o texto do consentimento mudar de sentido: todo mundo ve de novo.
42
- const CONSENT_VERSION = '2026-10-21';
43
+ const CONSENT_VERSION = '2026-10-30'; // rev1 da 28: as skills tambem se atualizam sozinhas
43
44
  const CONSENT_TEXT = [
44
45
  'Antes de ligar o canal do Iron Office:',
45
46
  ' - o que voce escrever no site vira pedido nesta sessao do Claude Code,',
@@ -48,7 +49,8 @@ const CONSENT_TEXT = [
48
49
  ' dos arquivos criados ou editados, o comeco de cada comando, buscas,',
49
50
  ' a pasta e os nomes dos conectores; o chat e as entregas ficam no site;',
50
51
  ' - apagamos padroes conhecidos de senha, chave e token (nem sempre todos);',
51
- ' - a cada abertura o plugin se atualiza e o conector da Meta e instalado;',
52
+ ' - a cada abertura o plugin se atualiza, o conector da Meta e instalado',
53
+ ' e as skills do Iron tambem (o que voce editou fica; pular: --sem-update);',
52
54
  ' - politica: ' + OFFICE_URL + '/termos',
53
55
  ];
54
56
 
@@ -102,7 +104,67 @@ function aplicarFlagsFeed(argv, home) {
102
104
  return '';
103
105
  }
104
106
 
105
- const NOSSAS_FLAGS = new Set(['--safe', '--sem-feed', '--com-feed']);
107
+ const NOSSAS_FLAGS = new Set(['--safe', '--sem-feed', '--com-feed', '--sem-update']);
108
+
109
+ // Onda 28 rev1: o pacote instalado em ~/.claude (skills, agentes, steps) so' mudava com `npx iron-edge update`, e
110
+ // nenhum aviso dizia que havia versao nova. Agora o `ironoffice` compara a versao do manifesto com a deste pacote e,
111
+ // se estiver atras, roda o MESMO update.js em processo filho (troca so' o que bate com o hash do manifesto; o que o
112
+ // aluno editou fica). Melhor-esforco, igual ao plugin: falhou, segue com a versao instalada. --sem-update pula.
113
+ const UPDATE_TIMEOUT_MS = 180000;
114
+
115
+ function versaoNum(v) {
116
+ const m = String(v || '').replace(/^iron-edge-/, '').match(/^(\d+)\.(\d+)\.(\d+)/);
117
+ return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
118
+ }
119
+
120
+ // -1 a < b · 0 iguais · 1 a > b (versao ilegivel conta como a mais antiga)
121
+ function compararVersao(a, b) {
122
+ const x = versaoNum(a), y = versaoNum(b);
123
+ if (!x || !y) return !x && !y ? 0 : (!x ? -1 : 1);
124
+ for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i] ? -1 : 1;
125
+ return 0;
126
+ }
127
+
128
+ function versaoDoPacote() {
129
+ try { return require(path.join(__dirname, '..', 'package.json')).version || ''; } catch (_) { return ''; }
130
+ }
131
+
132
+ // Devolve a linha que o office imprime (sempre uma; nunca lanca). o.spawn e o.updateScript existem pro teste.
133
+ function atualizarPacote(home, o) {
134
+ const opts = o || {};
135
+ const h = home || os.homedir();
136
+ const pacote = opts.pkgVersion || versaoDoPacote();
137
+ const man = path.join(h, '.iron', 'install-manifest.json');
138
+ let instalada;
139
+ try { instalada = JSON.parse(fs.readFileSync(man, 'utf8')).version || ''; }
140
+ catch (e) {
141
+ if (e && e.code === 'ENOENT') return ' [aviso] nao achei o registro da instalacao do Iron: as skills nao se atualizam sozinhas (rode npx iron-edge update)';
142
+ return ' [aviso] o registro da instalacao do Iron esta ilegivel: seguindo com o que esta instalado (rode npx iron-edge update)';
143
+ }
144
+ const antes = String(instalada).replace(/^iron-edge-/, '') || '?';
145
+ if (!pacote || compararVersao(instalada, pacote) >= 0) return ' [ok] Iron ja esta na ' + antes;
146
+ // a saida do filho e' capturada: sem esta linha o aluno ficava ate 3 min olhando o terminal parado (gate r1)
147
+ if (opts.antes) opts.antes(' Atualizando o Iron ' + antes + ' -> ' + pacote + ' (alguns segundos, nao feche)...');
148
+ const spawn = opts.spawn || spawnSync;
149
+ // --sem-atalho: o update automatico nunca cria o alias no ~/.zshrc (o install pergunta antes; aqui nao ha
150
+ // pergunta). gate r1 do aluno-zero: sem ela, quem recusou o atalho ganhava o alias sem saber
151
+ const r = spawn(process.execPath, [opts.updateScript || path.join(__dirname, 'update.js'), '--sem-atalho'], {
152
+ encoding: 'utf8',
153
+ timeout: UPDATE_TIMEOUT_MS,
154
+ maxBuffer: 32 * 1024 * 1024, // a saida estourando 1 MiB matava o filho no meio da troca (gate r1, ENOBUFS)
155
+ env: { ...process.env, HOME: h, USERPROFILE: h, IRON_EDGE_VERSION: pacote, IRON_EDGE_RESUMO: '1' },
156
+ });
157
+ const out = (r && (r.stdout || '') + (r.stderr || '')) || '';
158
+ const m = out.match(/IRON_UPDATE_RESUMO (\{.*\})/);
159
+ if (!r || r.error || r.status !== 0 || !m) {
160
+ const motivo = r && r.error ? (r.error.code || r.error.message) : (out.trim().split('\n').pop() || 'sem detalhe');
161
+ return ' [aviso] nao deu pra atualizar o Iron agora (' + String(motivo).slice(0, 120) + '): seguindo com a ' + antes + '. Pra tentar de novo: npx iron-edge update';
162
+ }
163
+ let res = { trocados: 0, preservados: 0 };
164
+ try { res = JSON.parse(m[1]); } catch (_) { /* conta zero */ }
165
+ return ' [ok] Iron atualizado ' + antes + ' -> ' + pacote + ': ' + res.trocados + ' arquivo(s) trocado(s)'
166
+ + (res.preservados ? ', ' + res.preservados + ' ficaram como estavam (voce mexeu neles)' : '');
167
+ }
106
168
 
107
169
  function keyPath(home) {
108
170
  return path.join(home || os.homedir(), '.claude', 'iron-office-api-key');
@@ -318,6 +380,8 @@ async function main(argv) {
318
380
  step(claude, 'atualizacao do plugin', ['plugin', 'update', PLUGIN], [/already|up.to.date|latest/i]);
319
381
  metaAds(claude);
320
382
  avisoPluginNovo(claude);
383
+ if (argv.includes('--sem-update')) console.log(' [ok] atualizacao do Iron pulada (--sem-update)');
384
+ else console.log(atualizarPacote(undefined, { antes: (l) => console.log(l) }));
321
385
 
322
386
  const safe = argv.includes('--safe');
323
387
  console.log('');
@@ -350,7 +414,7 @@ async function main(argv) {
350
414
  return r.status ?? 1;
351
415
  }
352
416
 
353
- module.exports = { resolveCwd, campoYaml, CONSENT_VERSION, CONSENT_TEXT, consentPath, consentimentoOk, pedirConsentimento, aplicarFlagsFeed, metaAds, META_ADS_MCP, avisoPluginNovo, pluginVersion, buildClaudeArgs, keyPath, readKey, keyFileExists, isValidKey, ping, resolveClaude, CHANNEL, PLUGIN, MARKETPLACE_REPO, KEY_RE };
417
+ module.exports = { atualizarPacote, compararVersao, resolveCwd, campoYaml, CONSENT_VERSION, CONSENT_TEXT, consentPath, consentimentoOk, pedirConsentimento, aplicarFlagsFeed, metaAds, META_ADS_MCP, avisoPluginNovo, pluginVersion, buildClaudeArgs, keyPath, readKey, keyFileExists, isValidKey, ping, resolveClaude, CHANNEL, PLUGIN, MARKETPLACE_REPO, KEY_RE };
354
418
 
355
419
  if (require.main === module) {
356
420
  main(process.argv.slice(2)).then(code => process.exit(code), err => {
@@ -388,9 +388,16 @@ const versaoDesatualizada = Boolean(versaoDoPacote) && versaoRegistrada !== vers
388
388
  if (!plano.trocar.length && !plano.adicionar.length && !plano.restaurar.length && !plano.remover.length && !plano.gerar.length && !plano.preservar.length && !versaoDesatualizada && !metadataReparado) {
389
389
  log(''); log('Nada a fazer: sua instalacao ja esta na versao deste pacote.');
390
390
  log(atalho(false));
391
+ resumo(0);
391
392
  process.exit(0);
392
393
  }
393
394
 
395
+ // Onda 28 rev1: o `ironoffice` roda este update em processo filho e imprime 1 linha so'. Com IRON_EDGE_RESUMO=1
396
+ // a ultima linha da saida diz quantos arquivos trocaram e quantos ficaram porque a pessoa editou.
397
+ function resumo(trocados) {
398
+ if (process.env.IRON_EDGE_RESUMO === '1') log('IRON_UPDATE_RESUMO ' + JSON.stringify({ trocados, preservados: plano.preservar.length }));
399
+ }
400
+
394
401
  // ---------------------------------------------------------------- FASE 1: escrever ao lado
395
402
  log('');
396
403
  log('--- FASE 1: escrevendo ao lado (nada em uso muda ainda) ---');
@@ -523,6 +530,7 @@ log('================================');
523
530
  log(' Atualizado com sucesso');
524
531
  log('================================');
525
532
  log(atalho(false));
533
+ resumo(feitos.length);
526
534
  log('Confira quando quiser: npx iron-edge verify');
527
535
  log('Reabra o Claude Code para carregar o que mudou.');
528
536
  log('');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iron-edge",
3
- "version": "2.12.0",
3
+ "version": "2.13.0",
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",
@@ -51,7 +51,7 @@ Antes de passar um campo novo em `fields`, confira com `ads_get_field_context` (
51
51
 
52
52
  a) **Por peça, 7 dias:** `ads_get_ad_entities` com `level: "ad"`, `time_range` dos 7 dias, `fields: ["name","campaign_name","adset_name","adset_id","effective_status","amount_spent","impressions","clicks","results","updated_time","created_time","creative_id"]`. Siga `pagination.next_cursor` até o fim (repetindo todos os outros parâmetros). **Campo ausente = 0**: peça sem gasto volta sem `amount_spent` e sem `impressions`, não com zero. O **gasto de cada grupo nos 7 dias** é a soma das peças dele (junte por `adset_id`, nunca pelo nome).
53
53
  b) **Por campanha, 7 dias:** a mesma chamada com `level: "campaign"` e `fields: ["name","effective_status","objective","amount_spent","impressions","clicks","results","cost_per_result"]`, até a última página. **Os totais do retrato (`spend`, `impressions`, `clicks`, `results`) são a soma de TODAS as campanhas lidas**, não só das 10 que vão pro retrato.
54
- 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`. Pro rótulo do resultado, `level: "adset"` com `fields: ["name","optimization_goal"]` (7 dias).
54
+ 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: grupos pausados" com esses dois números.
55
55
  d) **Erros:** `ads_get_errors` com `entity_ids: ["<número da conta>"]` (traz os erros das peças dela).
56
56
  e) **Texto das peças:** `ads_get_creatives` com `creative_ids` (os do passo a, em lotes) e `fields: ["body","title"]`.
57
57
 
@@ -80,14 +80,14 @@ Cada alerta leva a peça, a campanha, o número que o sustenta (`detail`, até 1
80
80
  { "v": 1, "at": "<agora, ISO com fuso>", "account_id": "<número da conta>", "account_name": "<nome da conta, até 60>",
81
81
  "currency": "<moeda da conta, 3 letras>", "window_days": 7,
82
82
  "spend": 0, "impressions": 0, "clicks": 0, "results": 0, "result_label": "compras", "cpa": null,
83
- "campaigns": [{ "name": "…", "status": "ACTIVE", "spend": 0, "results": 0 }],
83
+ "campaigns": [{ "name": "…", "status": "ACTIVE", "spend": 0, "results": 0, "adsets_active": 0, "adsets_total": 0 }],
84
84
  "top_ads": [{ "name": "…", "campaign": "…", "spend": 0, "impressions": 0, "results": 0 }],
85
85
  "alerts": [{ "kind": "data_vencida", "ad": "…", "campaign": "…", "since": "<ISO, opcional>", "detail": "…", "action": "…" }],
86
86
  "checked": { "ads": 0, "copy": 0, "art": false },
87
87
  "ramp": [{ "ad": "…", "until": "<ISO>" }] }
88
88
  ```
89
89
 
90
- - `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" e o resto como "pausada". `top_ads`: as 5 peças que mais gastaram. `alerts` e `ramp`: até 10 cada. `cpa` = gasto ÷ resultados (`null` sem resultado). `checked.ads` = peças medidas; `checked.copy` = peças com texto lido.
90
+ - `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: grupos pausados" / "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). `checked.ads` = peças medidas; `checked.copy` = peças com texto lido.
91
91
  - Até 8 kB: nomes longos, encurte. Nome com telefone, e-mail ou `@perfil` chega no site como `[removido]` (o filtro protege o aluno); é esperado.
92
92
  - A ferramenta recusou (`O site recusou o retrato: …`)? Corrija o que ela disse e mande de novo uma vez. Recusou de novo: responda os números no chat e diga que o retrato não foi gravado.
93
93