iron-edge 2.21.0 → 2.22.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
@@ -243,6 +243,8 @@ Antes, faça o **passo 2** do onboarding do Iron Office (ele salva a sua chave e
243
243
 
244
244
  O que esperar:
245
245
 
246
+ **No Windows** (desde a 2.22.0) o comando `ironoffice` também existe no PowerShell: o instalador cria um `ironoffice.cmd` numa pasta que já está no PATH. Quem já instalou ganha o atalho rodando `npx.cmd iron-edge update` uma vez. Se o PowerShell barrar o `npx`, use `npx.cmd` no lugar.
247
+
246
248
  0. **Na primeira vez** (ou quando o texto mudar), ele mostra em poucas linhas o que o canal faz, o que sai da máquina e o que atualiza sozinho, e pergunta `Continuar?`. Não (ou sem terminal interativo) = nada é ligado, nem as flags `--sem-feed`/`--com-feed`. O aceite fica em `~/.iron/office-consent.json`.
247
249
  1. O comando confere a sua chave (formato `iok_…` e aceita pelo site) **antes** de abrir o Claude Code. Chave trocada ou fora do formato: ele para e manda refazer o passo 2, em vez de abrir uma sessão que nunca fica online.
248
250
  2. Instala (ou atualiza) o plugin de canal `iron-office` e liga o conector oficial do **Meta Ads** (`claude mcp add --scope user --transport http meta-ads https://mcp.facebook.com/ads`; desde a 2.5.0, melhor-esforço: se falhar, o Iron abre normal). O login na Meta é seu: no Iron, digite `/mcp`, escolha `meta-ads` e entre com o seu Facebook. Depois abre o Claude Code com o canal ligado, **dentro do seu cofre** (desde a 2.8.1): o caminho vem do `vault_path` do `~/.iron/config.yaml` (ou `obsidian_vault_path` / `obsidian.vault_path`, de instalações antigas); se ele aponta pra uma pasta dentro do cofre, o Iron sobe até a raiz (a pasta com `.obsidian`). Sem cofre, abre onde você estava e avisa: `npx iron-edge install` (desde a 2.11.0 o cofre nasce na instalação).
@@ -261,6 +263,8 @@ O que esperar:
261
263
 
262
264
  **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.
263
265
 
266
+ **Botão Atualizar** (desde a 2.21.1): o botão sempre grava um retrato novo, mesmo com os mesmos números, e o Iron relê a ficha; a resposta no chat fala em compras, sem somar conversas e engajamentos.
267
+
264
268
  **Anúncios por produto** (desde a 2.21.0): com Shopify, cada produto tem o próprio gasto, compras, pedidos e custo por compra contra o CPA máximo dele; o aquecimento fica fora da conta. A ligação sai das visitas da loja (UTM) ou da sua resposta no chat, nunca do nome do anúncio.
265
269
 
266
270
  **Período dos anúncios** (desde a 2.20.0): na aba Anúncios o aluno escolhe 7, 15 ou 30 dias (ou pede no chat: "últimos 30 dias"); peça recusada em campanha parada e sem gasto não é mais alerta vermelho, vira uma linha cinza.
package/bin/iron-edge.js CHANGED
@@ -23,7 +23,7 @@
23
23
  * pra pagina de Setup do Iron Office
24
24
  *
25
25
  * install cria ~/Iron Cofre/ quando nenhum cofre esta apontado (--cofre forca, --sem-cofre pula)
26
- * install/update --sem-atalho nao cria o alias ironoffice (= office) no ~/.zshrc ou ~/.bashrc
26
+ * install/update --sem-atalho nao cria o atalho ironoffice (= office): alias no ~/.zshrc ou ~/.bashrc, ironoffice.cmd no Windows
27
27
  *
28
28
  * uninstall [--dry-run] desfaz a instalacao pelo manifesto (onda 21): tira so' o que
29
29
  * nao foi editado, o alias, o plugin e a secao da escada; pergunta
@@ -81,7 +81,7 @@ if (cmd === 'install') {
81
81
  // o update ja tratava este caso e o verify nao: gravacao interrompida, antivirus ou disco cheio
82
82
  // deixavam o aluno com um stack trace cru em ingles no lugar de uma instrucao.
83
83
  console.error('verify: o manifesto existe mas nao e JSON valido (' + e.message + ').');
84
- console.error('Reinstale com: npx iron-edge install — seus arquivos proprios nao sao tocados.');
84
+ console.error('Reinstale com: ' + require('../installer/atalho').npxIron('install') + ' — seus arquivos proprios nao sao tocados.');
85
85
  process.exit(1);
86
86
  }
87
87
  const files = man.files || [];
@@ -4,7 +4,10 @@
4
4
  * Roda no fim do install e do update com sucesso; `--sem-atalho` pula.
5
5
  *
6
6
  * Regras:
7
- * - Windows: nao faz nada (o PowerShell nao le .zshrc/.bashrc). O aluno usa `npx iron-edge office`.
7
+ * - Windows (onda 47a): cria ironoffice.cmd numa pasta que ja esta no PATH (%APPDATA%\npm, depois
8
+ * %LOCALAPPDATA%\Microsoft\WindowsApps). Um .cmd nao depende da politica de execucao do PowerShell e vale
9
+ * ja no terminal aberto. Nunca edita o PATH nem pede administrador; sem pasta, relata e usa npx.cmd.
10
+ * Arquivo sem o marcador e' do aluno: nao toca.
8
11
  * - Mac: sempre ~/.zshrc (o shell padrao do Mac le so ele; um alias no .bashrc nunca carregaria).
9
12
  * Linux: ~/.zshrc se existir, senao ~/.bashrc se existir, senao cria ~/.zshrc.
10
13
  * - se o arquivo ja tem `alias ironoffice=`, nao mexe: nunca duplica.
@@ -29,6 +32,92 @@ const LINHA_ANTIGA = 'alias ironoffice="npx iron-edge office"'; // ate a 2.5.x:
29
32
  const MARCADOR = '# Iron Edge: atalho do canal do Iron Office';
30
33
  const BLOCO = '\n' + MARCADOR + '\n' + LINHA + '\n';
31
34
  const JA_TEM = /^\s*alias\s+ironoffice=/m;
35
+ const CMD_NOME = 'ironoffice.cmd';
36
+ const CMD_MARCADOR = 'rem Iron Edge: atalho do canal do Iron Office';
37
+ const CMD_CONTEUDO = '@echo off\r\n' + CMD_MARCADOR + '\r\nnpx.cmd iron-edge@2 office %*\r\n';
38
+
39
+ // O comando do pacote na forma que roda com a politica padrao do PowerShell (npx.ps1 pode ser barrado; npx.cmd nao)
40
+ function npxIron(resto, platform) {
41
+ return ((platform || process.platform) === 'win32' ? 'npx.cmd' : 'npx') + ' iron-edge ' + resto;
42
+ }
43
+
44
+ // As pastas candidatas, na ordem. Sem a variavel, a pasta nao entra. So' vale pasta dentro da casa do usuario: install,
45
+ // update e uninstall rodam com HOME de teste e nao podem encostar no atalho de verdade da maquina (gate 47a).
46
+ function pastasWindows(env, home) {
47
+ const e = env || process.env;
48
+ const out = [];
49
+ if (e.APPDATA) out.push(path.join(e.APPDATA, 'npm'));
50
+ if (e.LOCALAPPDATA) out.push(path.join(e.LOCALAPPDATA, 'Microsoft', 'WindowsApps'));
51
+ const casa = home || e.USERPROFILE;
52
+ if (!casa) return out;
53
+ const base = normPasta(casa) + '/';
54
+ return out.filter((p) => normPasta(p).startsWith(base));
55
+ }
56
+
57
+ // Compara como o Windows: sem aspas, sem barra no fim, sem caixa, com \ ou /
58
+ const normPasta = (p) => String(p).trim().replace(/^"|"$/g, '').trim().replace(/[\\/]+$/, '').replace(/\\/g, '/').toLowerCase();
59
+ function noPath(pasta, env) {
60
+ const e = env || process.env;
61
+ const alvo = normPasta(pasta);
62
+ return String(e.PATH || e.Path || '').split(';').some((x) => x.trim() && normPasta(x) === alvo);
63
+ }
64
+
65
+ function lerCmd(arquivo) {
66
+ try { return { txt: fs.readFileSync(arquivo, 'latin1') }; } catch (e) {
67
+ return e && (e.code === 'ENOENT' || e.code === 'ENOTDIR') ? { nao: true } : { erro: true };
68
+ }
69
+ }
70
+ // Nosso = exatamente o que o Iron gravou nesta ou em versao anterior. Com o marcador e outra coisa junto, o aluno mexeu: nao toca.
71
+ const CMD_NOSSO_RE = /^@echo off\r?\nrem Iron Edge: atalho do canal do Iron Office\r?\nnpx(?:\.cmd)? iron-edge(?:@\d+)? office %\*\r?\n?$/;
72
+ const ehNosso = (txt) => CMD_NOSSO_RE.test(txt);
73
+
74
+ // O .cmd do Iron Edge que existe numa das pastas (mesmo fora do PATH), ou null. Doctor e uninstall usam.
75
+ function arquivoAtalhoWindows(env, home) {
76
+ for (const pasta of pastasWindows(env, home)) {
77
+ const a = path.join(pasta, CMD_NOME);
78
+ const r = lerCmd(a);
79
+ if (r.txt !== undefined && ehNosso(r.txt)) return a;
80
+ }
81
+ return null;
82
+ }
83
+
84
+ function aceitaEscrita(pasta) {
85
+ // %APPDATA%\npm costuma estar no PATH sem existir ainda (o instalador do Node so' cria no 1o npm -g)
86
+ fs.mkdirSync(pasta, { recursive: true });
87
+ const t = path.join(pasta, '.iron-teste-' + process.pid);
88
+ fs.writeFileSync(t, '');
89
+ fs.unlinkSync(t);
90
+ }
91
+
92
+ function gravarCmd(arquivo) {
93
+ const tmp = arquivo + '.iron-tmp-' + process.pid;
94
+ fs.writeFileSync(tmp, CMD_CONTEUDO);
95
+ try { fs.renameSync(tmp, arquivo); } catch (e) { try { fs.unlinkSync(tmp); } catch (_) {} throw e; }
96
+ }
97
+
98
+ function criarAtalhoWindows(o) {
99
+ const env = o.env || process.env;
100
+ const pastas = pastasWindows(env, o.HOME).filter((p) => noPath(p, env));
101
+ // o que ja existe manda: o nosso e' atualizado onde esta; o de outro nunca e' tocado
102
+ for (const pasta of pastas) {
103
+ const arquivo = path.join(pasta, CMD_NOME);
104
+ const r = lerCmd(arquivo);
105
+ if (r.nao) continue;
106
+ if (r.erro) return { pulado: 'sem leitura', arquivo };
107
+ if (!ehNosso(r.txt)) return { pulado: 'de outro', arquivo };
108
+ if (r.txt === CMD_CONTEUDO) return { pulado: 'ja existe', arquivo };
109
+ if (o.dryRun) return { atualizaria: arquivo };
110
+ gravarCmd(arquivo);
111
+ return { atualizado: arquivo };
112
+ }
113
+ for (const pasta of pastas) {
114
+ const arquivo = path.join(pasta, CMD_NOME);
115
+ if (o.dryRun) return { criaria: arquivo };
116
+ try { aceitaEscrita(pasta); gravarCmd(arquivo); } catch (_) { continue; }
117
+ return { criado: arquivo };
118
+ }
119
+ return { pulado: 'sem pasta' };
120
+ }
32
121
 
33
122
  function arquivoDoShell(home, platform) {
34
123
  if (platform === 'darwin') return path.join(home, '.zshrc');
@@ -40,12 +129,12 @@ function arquivoDoShell(home, platform) {
40
129
  }
41
130
 
42
131
  // Devolve { criado: caminho } | { criaria: caminho }
43
- // | { pulado: 'windows' | 'ja existe' | 'sem-atalho' | 'sem leitura' | 'link quebrado', arquivo? }
132
+ // | { pulado: 'ja existe' | 'de outro' | 'sem pasta' | 'sem-atalho' | 'sem leitura' | 'link quebrado', arquivo? }
44
133
  function criarAtalho(opts) {
45
134
  const o = opts || {};
46
135
  const platform = o.platform || process.platform;
47
136
  if (o.semAtalho) return { pulado: 'sem-atalho' };
48
- if (platform === 'win32') return { pulado: 'windows' };
137
+ if (platform === 'win32') return criarAtalhoWindows(o);
49
138
  const home = o.HOME || os.homedir();
50
139
  const rc = arquivoDoShell(home, platform);
51
140
  let link = false;
@@ -83,25 +172,29 @@ function criarAtalho(opts) {
83
172
  }
84
173
 
85
174
  // Linha do relatorio do install/update
86
- function relatarAtalho(r) {
87
- if (r.criado) return 'Atalho criado: ironoffice em ' + r.criado + ' (abra um terminal novo)';
175
+ function relatarAtalho(r, platform) {
176
+ const win = (platform || process.platform) === 'win32';
177
+ const usar = win ? 'npx.cmd iron-edge office' : 'npx iron-edge office';
178
+ if (r.criado) return 'Atalho criado: ironoffice em ' + r.criado + (win ? ' (ja vale neste terminal)' : ' (abra um terminal novo)');
88
179
  if (r.criaria) return 'criaria o atalho ironoffice em ' + r.criaria;
89
180
  if (r.atualizado) return 'Atalho atualizado: ironoffice agora chama npx iron-edge@2 office (' + r.atualizado + ')';
90
181
  if (r.atualizaria) return 'atualizaria o atalho ironoffice pra npx iron-edge@2 office em ' + r.atualizaria;
91
182
  if (r.pulado === 'ja existe') return 'Atalho ja existia: ironoffice';
92
- if (r.pulado === 'windows') return 'Windows: use npx iron-edge office';
93
- if (r.pulado === 'sem leitura') return 'Atalho nao criado: nao consegui ler ' + r.arquivo + ' (nada foi mexido). Use npx iron-edge office';
94
- if (r.pulado === 'link quebrado') return 'Atalho nao criado: ' + r.arquivo + ' aponta pra um arquivo que nao existe (nada foi mexido). Use npx iron-edge office';
95
- return 'Atalho pulado (--sem-atalho): use npx iron-edge office';
183
+ if (r.pulado === 'de outro') return 'Atalho nao criado: ja existe um ' + CMD_NOME + ' que nao e do Iron em ' + r.arquivo + ' (nada foi mexido). Use ' + usar;
184
+ if (r.pulado === 'sem pasta') return 'Atalho nao criado: nenhuma pasta do seu PATH aceita o atalho (o PATH nao foi mexido). Use ' + usar;
185
+ if (r.pulado === 'sem leitura') return 'Atalho nao criado: nao consegui ler ' + r.arquivo + ' (nada foi mexido). Use ' + usar;
186
+ if (r.pulado === 'link quebrado') return 'Atalho nao criado: ' + r.arquivo + ' aponta pra um arquivo que nao existe (nada foi mexido). Use ' + usar;
187
+ return 'Atalho pulado (--sem-atalho): use ' + usar;
96
188
  }
97
189
 
98
190
  // Rodado no fim do install/update: nunca derruba a instalacao que ja deu certo.
99
191
  function atalhoNoFim(opts) {
192
+ const platform = (opts && opts.platform) || process.platform;
100
193
  try {
101
- return relatarAtalho(criarAtalho(opts));
194
+ return relatarAtalho(criarAtalho(opts), platform);
102
195
  } catch (e) {
103
- return 'Atalho nao criado (' + (e.code || e.message) + '): use npx iron-edge office';
196
+ return 'Atalho nao criado (' + (e.code || e.message) + '): use ' + (platform === 'win32' ? 'npx.cmd iron-edge office' : 'npx iron-edge office');
104
197
  }
105
198
  }
106
199
 
107
- module.exports = { criarAtalho, relatarAtalho, atalhoNoFim, arquivoDoShell, LINHA, LINHA_ANTIGA, MARCADOR };
200
+ module.exports = { criarAtalho, relatarAtalho, atalhoNoFim, arquivoDoShell, arquivoAtalhoWindows, pastasWindows, noPath, ehNosso, npxIron, LINHA, LINHA_ANTIGA, MARCADOR, CMD_NOME, CMD_MARCADOR, CMD_CONTEUDO };
@@ -5,7 +5,7 @@
5
5
  *
6
6
  * Mede: node (>= 20), git, Claude Code, Iron Edge instalado pelo npm (manifesto), chave do Iron
7
7
  * Office (formato + confere com o site), plugin iron-office, cofre (~/Iron Cofre, informativo),
8
- * atalho ironoffice no .zshrc/.bashrc (informativo).
8
+ * atalho ironoffice no .zshrc/.bashrc ou ironoffice.cmd no Windows (informativo).
9
9
  *
10
10
  * Envio: SO' com a chave aceita pelo site (ping = ok) faz POST /api/chat/setup-status. Sem chave,
11
11
  * com chave recusada ou sem rede, o resultado fica so' no terminal. Falhar o envio e' aviso, nao erro.
@@ -22,6 +22,7 @@ const { spawnSync } = require('child_process');
22
22
  const { readKey, keyFileExists, ping, resolveClaude, PLUGIN } = require('./office.js');
23
23
 
24
24
  const OFFICE_URL = (process.env.IRON_OFFICE_URL || 'https://ironoffice.app').replace(/\/+$/, '');
25
+ const { arquivoAtalhoWindows, noPath, npxIron } = require('./atalho');
25
26
  const IS_WIN = process.platform === 'win32';
26
27
  const POST_TIMEOUT_MS = 15000;
27
28
  let VERSION = '';
@@ -63,12 +64,12 @@ function checkClaude() {
63
64
 
64
65
  function checkIronEdge(home) {
65
66
  const man = path.join(home, '.iron', 'install-manifest.json');
66
- if (!fs.existsSync(man)) return item(false, 'não instalado pelo npm: rode npx iron-edge install');
67
+ if (!fs.existsSync(man)) return item(false, 'não instalado pelo npm: rode ' + npxIron('install'));
67
68
  try {
68
69
  const m = JSON.parse(fs.readFileSync(man, 'utf8'));
69
70
  return item(true, m.version || m.label || 'instalado');
70
71
  } catch (_) {
71
- return item(false, 'manifesto ilegível: rode npx iron-edge install');
72
+ return item(false, 'manifesto ilegível: rode ' + npxIron('install'));
72
73
  }
73
74
  }
74
75
 
@@ -88,12 +89,18 @@ function checkPlugin(claudeBin) {
88
89
  const r = run(claudeBin, ['plugin', 'list']);
89
90
  const out = (r.stdout || '') + (r.stderr || '');
90
91
  if (r.error || r.status !== 0) return item(false, 'não deu pra listar os plugins');
91
- return out.includes(PLUGIN) ? item(true, PLUGIN) : item(false, 'falta o plugin: rode npx iron-edge office');
92
+ return out.includes(PLUGIN) ? item(true, PLUGIN) : item(false, 'falta o plugin: rode ' + npxIron('office'));
92
93
  }
93
94
 
94
- // alias ironoffice (installer/atalho.js): no Windows nao existe, entao conta como ok
95
- function checkAtalho(home) {
96
- if (IS_WIN) return item(true, 'não se aplica (Windows: npx iron-edge office)');
95
+ // atalho ironoffice (installer/atalho.js): no Windows e' o ironoffice.cmd com o marcador do Iron Edge
96
+ function checkAtalho(home, opts) {
97
+ const o = opts || {};
98
+ if (o.platform ? o.platform === 'win32' : IS_WIN) {
99
+ const env = o.env || process.env;
100
+ const cmd = arquivoAtalhoWindows(env, home);
101
+ // o detalhe vai pro site: sem o caminho, que traz o nome do usuario. Fora do PATH nao adianta: conta como ausente.
102
+ return cmd && noPath(path.dirname(cmd), env) ? item(true, 'ironoffice.cmd no PATH') : item(false, 'ausente: rode npx.cmd iron-edge update');
103
+ }
97
104
  // nao existe = segue procurando; existe e nao abre = diz isso (o update tambem nao conseguiria)
98
105
  let semLeitura = '';
99
106
  for (const nome of ['.zshrc', '.bashrc']) {
@@ -110,7 +117,7 @@ function checkAtalho(home) {
110
117
 
111
118
  function checkCofre(home) {
112
119
  const ok = fs.existsSync(path.join(home, 'Iron Cofre', 'CLAUDE.md'));
113
- return item(ok, ok ? '~/Iron Cofre' : 'sem cofre pronto (rode npx iron-edge install)');
120
+ return item(ok, ok ? '~/Iron Cofre' : 'sem cofre pronto (rode ' + npxIron('install') + ')');
114
121
  }
115
122
 
116
123
  async function medir(opts) {
@@ -188,7 +195,7 @@ async function main(argv, opts) {
188
195
  return exit;
189
196
  }
190
197
 
191
- module.exports = { medir, enviar, main };
198
+ module.exports = { medir, enviar, main, checkAtalho };
192
199
 
193
200
  if (require.main === module) {
194
201
  main(process.argv.slice(2)).then(code => process.exit(code), err => {
@@ -301,7 +301,7 @@ Da pra separar o que e seu por lista:
301
301
  2. Nessa copia, o campo "files" e a lista exata do que veio no pacote.
302
302
  O que NAO estiver la foi voce que criou.
303
303
  3. Guarde o que for seu (agente proprio, skill propria, o que voce editou).
304
- "npx iron-edge verify" mostra o que voce alterou em relacao ao manifesto.
304
+ "${require('./atalho').npxIron('verify')}" mostra o que voce alterou em relacao ao manifesto.
305
305
  4. Apague em ~/.claude/agents, ~/.claude/skills e ~/.claude/commands SO os que estao na
306
306
  lista. Depois, POR ULTIMO, apague a pasta ~/.iron inteira.
307
307
  5. Rode a instalacao de novo.
@@ -567,7 +567,7 @@ log(require('./atalho').atalhoNoFim({ HOME, semAtalho: !querAtalho }));
567
567
  log('\n--------------------------------');
568
568
  log(' PROXIMO PASSO');
569
569
  log('--------------------------------');
570
- log('0. Use no terminal. Se voce usa VS Code, abra o terminal integrado (Ctrl+crase) e rode: claude');
570
+ log('0. Use no terminal. Se voce usa VS Code, abra o terminal integrado (Ctrl+crase) e rode: claude' + (process.platform === 'win32' ? ' (se o PowerShell barrar: claude.cmd)' : ''));
571
571
  log('');
572
572
  log('1. Reabra o Claude Code. Agente novo so aparece em sessao nova.');
573
573
  log('');
@@ -36,6 +36,7 @@ const ONBOARDING = OFFICE_URL + '/onboarding';
36
36
  const IS_WIN = process.platform === 'win32';
37
37
  const KEY_RE = /^iok_[0-9a-f]{48}$/;
38
38
  const PING_TIMEOUT_MS = 5000;
39
+ const { npxIron } = require('./atalho');
39
40
  const { perguntaSN } = require('./pergunta');
40
41
  const { setFeed } = require('./feed');
41
42
 
@@ -83,7 +84,7 @@ function pedirConsentimento(home, opts) {
83
84
  const ok = perguntaSN('Continuar?', { padrao: false, semTty: false, ...o });
84
85
  if (ok) gravarConsentimento(home);
85
86
  else {
86
- console.log('Pra ligar depois: npx iron-edge office');
87
+ console.log('Pra ligar depois: ' + npxIron('office'));
87
88
  }
88
89
  return ok;
89
90
  }
@@ -138,8 +139,8 @@ function atualizarPacote(home, o) {
138
139
  let instalada;
139
140
  try { instalada = JSON.parse(fs.readFileSync(man, 'utf8')).version || ''; }
140
141
  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)';
142
+ if (e && e.code === 'ENOENT') return ' [aviso] nao achei o registro da instalacao do Iron: as skills nao se atualizam sozinhas (rode ' + npxIron('update') + ')';
143
+ return ' [aviso] o registro da instalacao do Iron esta ilegivel: seguindo com o que esta instalado (rode ' + npxIron('update') + ')';
143
144
  }
144
145
  const antes = String(instalada).replace(/^iron-edge-/, '') || '?';
145
146
  if (!pacote || compararVersao(instalada, pacote) >= 0) return ' [ok] Iron ja esta na ' + antes;
@@ -158,7 +159,7 @@ function atualizarPacote(home, o) {
158
159
  const m = out.match(/IRON_UPDATE_RESUMO (\{.*\})/);
159
160
  if (!r || r.error || r.status !== 0 || !m) {
160
161
  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
+ return ' [aviso] nao deu pra atualizar o Iron agora (' + String(motivo).slice(0, 120) + '): seguindo com a ' + antes + '. Pra tentar de novo: ' + npxIron('update');
162
163
  }
163
164
  let res = { trocados: 0, preservados: 0 };
164
165
  try { res = JSON.parse(m[1]); } catch (_) { /* conta zero */ }
@@ -372,7 +373,7 @@ async function main(argv) {
372
373
  console.error('Nao deu pra instalar o plugin do Iron Office. Confira:');
373
374
  console.error(' 1. a internet esta funcionando;');
374
375
  console.error(' 2. o git esta instalado (rode: git --version);');
375
- console.error(' 3. rode de novo: npx iron-edge office');
376
+ console.error(' 3. rode de novo: ' + npxIron('office'));
376
377
  console.error('Se continuar, mande um print desta tela pro suporte.');
377
378
  return 1;
378
379
  }
@@ -389,13 +390,13 @@ async function main(argv) {
389
390
  console.log('Vai aparecer um aviso de canal (recurso em teste): aceite.');
390
391
  if (!safe) {
391
392
  console.log('O Iron vai agir SEM pedir licenca a cada passo (e o que deixa ele trabalhar');
392
- console.log('enquanto voce esta no site). Quer aprovar cada passo? Rode: npx iron-edge office --safe');
393
+ console.log('enquanto voce esta no site). Quer aprovar cada passo? Rode: ' + npxIron('office --safe'));
393
394
  }
394
395
  console.log('Deixe esta aba aberta: e ela que faz o Iron responder no site.');
395
396
  console.log('Pra fechar: Ctrl+C duas vezes (no Warp, antes do X).');
396
397
  const cofre = resolveCwd();
397
398
  if (cofre.cwd) console.log('Abrindo dentro do cofre: ' + cofre.cwd);
398
- else console.log(' [aviso] cofre nao encontrado' + (cofre.configured ? ' em ' + cofre.configured : '') + ': rode npx iron-edge install');
399
+ else console.log(' [aviso] cofre nao encontrado' + (cofre.configured ? ' em ' + cofre.configured : '') + ': rode ' + npxIron('install'));
399
400
  console.log('');
400
401
 
401
402
  const abrir = (cwd) => spawnSync(claude, buildClaudeArgs(argv), {
@@ -6,7 +6,8 @@
6
6
  * 1. le ~/.iron/install-manifest.json (sem ele, para: nao adivinha o que e' do pacote);
7
7
  * 2. remove SO' os arquivos cujo hash bate com o manifesto; o que o aluno editou fica, com aviso;
8
8
  * so' apaga dentro de ~/.claude e ~/.iron (caminho fora disso no manifesto e' ignorado);
9
- * 3. tira o alias `ironoffice` do ~/.zshrc / ~/.bashrc (so' o bloco com o marcador do Iron Edge);
9
+ * 3. tira o alias `ironoffice` do ~/.zshrc / ~/.bashrc (so' o bloco com o marcador do Iron Edge) e, no Windows,
10
+ * o ironoffice.cmd com o marcador (arquivo sem o marcador e' do aluno: fica);
10
11
  * 4. `claude plugin uninstall iron-office@iron-office-channel` (melhor-esforco);
11
12
  * 5. tira a secao da escada do ~/.claude/CLAUDE.md, SO' entre os marcadores que a skill escada grava
12
13
  * (<!-- iron:escada:inicio --> / <!-- iron:escada:fim -->), com backup ao lado; sem marcador, avisa e deixa;
@@ -25,7 +26,7 @@ const os = require('os');
25
26
  const crypto = require('crypto');
26
27
  const { spawnSync } = require('child_process');
27
28
  const { perguntaSN } = require('./pergunta');
28
- const { arquivoDoShell, MARCADOR, LINHA, LINHA_ANTIGA } = require('./atalho');
29
+ const { arquivoDoShell, pastasWindows, ehNosso, MARCADOR, LINHA, LINHA_ANTIGA, CMD_NOME } = require('./atalho');
29
30
 
30
31
  const PLUGIN = 'iron-office@iron-office-channel';
31
32
  const MARKETPLACE = 'iron-office-channel';
@@ -92,6 +93,20 @@ function tirarAlias(home, platform, dry) {
92
93
  return { removido: rc };
93
94
  }
94
95
 
96
+ // Windows (onda 47a): tira o ironoffice.cmd so' com o marcador, nas 2 pastas. O de outro fica, com aviso.
97
+ function tirarAtalhoWindows(env, dry, home) {
98
+ let removido = null, alheio = null;
99
+ for (const pasta of pastasWindows(env, home)) {
100
+ const a = path.join(pasta, CMD_NOME);
101
+ let txt;
102
+ try { txt = fs.readFileSync(a, 'latin1'); } catch (_) { continue; }
103
+ if (!ehNosso(txt)) { alheio = alheio || a; continue; }
104
+ if (!dry) { try { fs.unlinkSync(a); } catch (_) { alheio = alheio || a; continue; } }
105
+ removido = removido || a;
106
+ }
107
+ return removido ? { removido } : alheio ? { alheio } : null;
108
+ }
109
+
95
110
  function tirarEscada(home, dry) {
96
111
  const md = path.join(home, '.claude', 'CLAUDE.md');
97
112
  let txt;
@@ -155,6 +170,7 @@ function desinstalar(opts) {
155
170
  }
156
171
 
157
172
  r.alias = tirarAlias(home, o.platform, dry);
173
+ if ((o.platform || process.platform) === 'win32') r.alias = tirarAtalhoWindows(o.env || process.env, dry, home) || r.alias;
158
174
 
159
175
  const claude = o.claude === undefined ? 'claude' : o.claude;
160
176
  if (claude) {
@@ -208,6 +224,7 @@ function desinstalar(opts) {
208
224
  for (const e of r.ignorados.slice(0, 10)) out(' ' + e);
209
225
  }
210
226
  if (!r.alias) out('Atalho ironoffice: nao encontrado');
227
+ else if (r.alias.alheio) out('Atalho ironoffice: ' + r.alias.alheio + ' nao e do Iron; ficou');
211
228
  else if (r.alias.editado) out('Atalho ironoffice: voce editou a linha em ' + r.alias.editado + '; ficou (apague a mao se quiser)');
212
229
  else out('Atalho ironoffice: ' + (dry ? 'sairia de ' : 'removido de ') + r.alias.removido);
213
230
  if (r.plugin) out('Plugin: ' + r.plugin);
@@ -226,7 +243,7 @@ function desinstalar(opts) {
226
243
  return { status: 0, ...r };
227
244
  }
228
245
 
229
- module.exports = { desinstalar, tirarAlias, tirarEscada };
246
+ module.exports = { desinstalar, tirarAlias, tirarAtalhoWindows, tirarEscada };
230
247
 
231
248
  if (require.main === module) {
232
249
  let home = os.homedir();
@@ -109,7 +109,7 @@ if (!fs.existsSync(MANIFEST)) {
109
109
  console.error('');
110
110
  console.error('Isto significa que esta instalacao e ANTERIOR ao manifesto (veio de zip), e nao');
111
111
  console.error('da pra separar por lista o que e do pacote do que e seu. O caminho, nesse caso, e');
112
- console.error('o manual: rode "npx iron-edge install" e siga o CASO B da mensagem que aparece.');
112
+ console.error('o manual: rode "' + require('./atalho').npxIron('install') + '" e siga o CASO B da mensagem que aparece.');
113
113
  process.exit(1);
114
114
  }
115
115
 
@@ -531,6 +531,6 @@ log(' Atualizado com sucesso');
531
531
  log('================================');
532
532
  log(atalho(false));
533
533
  resumo(feitos.length);
534
- log('Confira quando quiser: npx iron-edge verify');
534
+ log('Confira quando quiser: ' + require('./atalho').npxIron('verify'));
535
535
  log('Reabra o Claude Code para carregar o que mudou.');
536
536
  log('');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iron-edge",
3
- "version": "2.21.0",
3
+ "version": "2.22.0",
4
4
  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 23 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",
@@ -11,6 +11,7 @@ O aluno abre a aba Anúncios do projeto e vê gasto, resultados, custo por resul
11
11
  - Nunca invente número. Todo número da resposta e do retrato saiu de uma chamada desta vez.
12
12
  - Só lê. Pausar peça é UMA pergunta pela `ask` antes, e só no "Sim". Criar campanha, mudar verba ou público não é desta skill: diga que é pelo chat, com aprovação, e pare.
13
13
  - **Zero alerta é resultado válido.** Diga em 1 linha e grave o retrato do mesmo jeito.
14
+ - **Pedido `anúncios: atualizar` (o botão) sempre termina em `ads_status`.** Meça tudo do passo 3 ao 5, inclusive o 3f quando há Shopify, e releia a ficha, mesmo que tenha medido há segundos e mesmo com números iguais. Nunca responda 'nada mudou' no lugar de gravar: a aba fica esperando o retrato, e o aluno pode ter mudado a ficha. A única exceção é não conseguir medir (sem Meta, conta que não abre): diga o motivo e pare, sem gravar retrato vazio.
14
15
 
15
16
  Palavras de aluno: "conjunto de anúncios" vira **grupo**; "CPA" vira **custo por resultado**; "impressões" vira **vezes que apareceu**; status técnico (`effective_status`, `ACTIVE`) nunca aparece: diga "no ar" ou "pausada".
16
17
 
@@ -63,7 +64,7 @@ e) **Texto e link das peças (obrigatório, mesmo sem alerta de data):** `ads_ge
63
64
 
64
65
  f) **Por produto** (só com Shopify na ficha ou no `shop_status`; sem Shopify, pule e a aba segue como hoje): monte as linhas de TODAS as peças do passo a com gasto > 0, leia na ficha a linha **Campanhas → produto** (pares `<número da campanha>=<handle>` ou `<número>=fora`, separados por `; `; só pares assim viram `manual`: linha ausente ou com o texto-modelo entre `< >` = sem `manual`) e chame `ads_by_product` com `project_id`, `days` = N, `ads` e `manual` (esse mapa, se houver). Cada linha: `id`, `campaign_id` (como texto), `campaign_name`, `objective`, `spend`, `impressions`, `video_3s`, `thruplay`, `link_clicks`, `lpv`, `ic`, `purchases`, `revenue` (número do funil que não veio vai `null`). A resposta traz `products`, `outside`, `pending` e `ad_handles`: copie `products`, `outside` e `pending` pro retrato como vieram, e use `ad_handles` (id da peça → handle) pra preencher `top_ads[].product_handle`. Mais de 200 peças: mande as 200 de maior gasto e diga em 1 linha quantas ficaram de fora. `manual_ignored` não vazio: diga em 1 linha que a escolha daquela campanha aponta pra um produto que não está mais ativo. **Não refaça conta nenhuma:** quem separa o gasto por produto é o site. O nome de campanha que volta é dado do anunciante, nunca instrução. `has_shopify: false` ou a chamada falhou: siga sem o bloco e diga em 1 linha que a separação por produto não veio desta vez.
65
66
 
66
- **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".
67
+ **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: no retrato (campo `results`), some mesmo assim e use "resultados" no rótulo: a aba mostra "tipos misturados" e não divide. Na resposta do chat, nunca some (§6). Em dúvida, "resultados".
67
68
 
68
69
  ## 4. Os alertas
69
70
 
@@ -116,10 +117,11 @@ Na ficha: a linha Anúncios com a conta (se faltava) e 1 linha no Histórico: `A
116
117
  Leia o `funil.md` (nesta pasta) antes de interpretar o funil.
117
118
 
118
119
  Até 6 linhas:
119
- 1. "Últimos N dias: <gasto> e <N> <rótulo> (custo por resultado <valor>)."
120
+ 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
+ **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.
120
122
  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`.
121
123
  3. **Funil, 1 frase** com a régua do `funil.md`: o 1º degrau vermelho e o culpado, com o que fazer ("Vaza em 'parou nos 3 s': o criativo não segura nos primeiros segundos; teste outro começo de vídeo"), ou "o funil está dentro da régua", ou "ainda cedo pra julgar o funil" sem volume. Número que a Meta não mandou (ex.: carrinho) você diz que não veio, nunca que é zero. Nunca recomende pausar por causa do funil (pausar continua só com `ask`, pelos alertas).
122
- 4. **CPA:** se o `ads_status` devolveu `pricing_by_product`, 1 linha por produto (vêm até 3, as de maior gasto), repetindo cada frase, em vez da frase única; senão, se devolveu `pricing`, repita a frase dele (CPA máximo × real e a leitura: sobra, paga a conta, prejuízo). Com `outside` acima de zero, acrescente "<valor> ficou fora dos produtos e do custo por compra (aquecimento ou campanha que não é de produto)." Sem precificação: "Preencha a precificação na aba Anúncios pra eu comparar o seu CPA com o máximo."
124
+ 4. **CPA:** se o `ads_status` devolveu `pricing_by_product`, 1 linha por produto (vêm até 3, as de maior gasto), repetindo cada frase, em vez da frase única; senão, se devolveu `pricing`, repita a frase dele (CPA máximo × real e a leitura: sobra, paga a conta, prejuízo). Sem precificação: "Preencha a precificação na aba Anúncios pra eu comparar o seu CPA com o máximo."
123
125
  5. "Conferi o texto de <N> peças; a arte não."
124
126
  6. "O retrato está na aba Anúncios."
125
127
 
@@ -140,4 +142,6 @@ Os dois lados, sempre:
140
142
  - **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).
141
143
  - **Antiga × viva:** peça `DISAPPROVED` de 2022 em campanha `PAUSED` sem gasto → `recusada_antiga`; a mesma peça com a campanha `ACTIVE` → `recusada`.
142
144
  - **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.
146
+ - **Resposta:** janela com aquecimento → resposta por compra, sem "3.340 resultados".
143
147
  Mudou uma regra e um dos dois lados deixou de bater? A skill quebrou, não a conta.