iron-edge 2.3.2 → 2.4.1

package/README.md

@@ -213,6 +213,32 @@ npx iron-edge verify
 
 ---
 
+## Iron Office
+
+Converse com o Iron pelo dashboard ([iron-office.vercel.app](https://iron-office.vercel.app)) e veja os agentes trabalhando no feed e no mapa 3D.
+
+```bash
+npx iron-edge office
+```
+
+Antes, faça o **passo 4** do onboarding do Iron Office (ele salva a sua chave em `~/.claude/iron-office-api-key`).
+
+O que esperar:
+
+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 4, em vez de abrir uma sessão que nunca fica online.
+2. Instala (ou atualiza) o plugin de canal `iron-office` e abre o Claude Code com ele ligado.
+3. O Claude Code mostra um **aviso de tela cheia**: canais ainda são recurso em teste. Aceite.
+4. Abra a página **Iron** do dashboard. Em até 1 minuto aparece "Iron online". Escreva ali e o Iron responde ali.
+5. **Deixe essa aba do terminal aberta.** É ela que faz o Iron responder no site.
+
+Por padrão a sessão do `office` roda **sem pedir licença** a cada ferramenta (é o que deixa o Iron trabalhar enquanto você está só no site). `npx iron-edge office --safe` abre pedindo licença a cada ferramenta. Qualquer outro argumento vai direto pro `claude`.
+
+Mensagem escrita no site com o terminal fechado espera até 15 minutos; depois disso expira e o chat avisa pra mandar de novo (ordem velha não é executada sem você ver).
+
+O plugin também manda a atividade das sessões pro seu painel: veja o que sai em "Sobre o que sai da sua máquina", mais abaixo.
+
+---
+
 ## Requisitos
 
 - **Node.js** 18 ou superior
@@ -230,12 +256,14 @@ O Iron Edge instala uma equipe de agentes especializados diretamente no Claude C
 
 Seus dados ficam locais em `~/.iron/`. Sobre o que sai da sua máquina, com precisão:
 
-- **Para o Iron Office** (`iron-office.vercel.app`, servidor deste projeto) vão dados de apenas **2 agentes**: `iron-auditor` e `iron-shopify`. E só se você criar a chave em `~/.claude/iron-office-api-key`. Confira você mesmo: `grep -rln "iron-office" ~/.claude/agents/`.
+- **Para o Iron Office** (`iron-office.vercel.app`, servidor deste projeto), e só se você criar a chave em `~/.claude/iron-office-api-key`:
+  - dados de apenas **2 agentes**, `iron-auditor` e `iron-shopify`. Confira: `grep -rln "iron-office" ~/.claude/agents/`;
+  - **se você rodou `npx iron-edge office`**, o plugin `iron-office` fica instalado e manda a atividade de **toda sessão** do Claude Code pro seu painel (feed e mapa 3D): nome da ferramenta, caminho do arquivo (nunca o conteúdo), os primeiros 200 caracteres de cada comando de terminal e a descrição dele, buscas, o domínio dos endereços visitados, nome e descrição dos agentes, a pasta e o identificador da sessão. A resposta das ferramentas nunca sai. Padrões conhecidos de segredo nesses campos (chaves de Stripe, Shopify, Meta, GitHub, OpenAI, Supabase e AWS, `Bearer`, `ALGO_KEY=`, `--password`, `-u usuario:senha`…) são apagados antes do envio; é uma lista de padrões, não garantia. Lista completa no README do plugin (github.com/filipecoff21-code/iron-office-channel). Desligar: `claude plugin disable iron-office@iron-office-channel`. Conferir se está ligado: `claude plugin list`.
 - **Para a internet aberta**, através das ferramentas do próprio Claude Code (`WebSearch` / `WebFetch`), vão as buscas de **41 dos 44 agentes** — é como o `iron-research` pesquisa mercado e o `iron-spy` lê a biblioteca de anúncios. Isso passa pelo Claude Code, com a visibilidade e a aprovação que ele te dá; não é canal deste pacote. Confira: `grep -rln "WebSearch\|WebFetch" ~/.claude/agents/`.
 - **A skill `clone-site`** baixa a URL que você mandar clonar. É o trabalho dela.
 
 
-Sendo exato sobre a força dessa garantia, porque ela não é um sandbox: cada bloco que chama o Iron Office começa com uma guarda (`[ -z "$IRON_KEY" ] && exit 0`) e a regra R20 do lint impede que qualquer bloco novo entre sem ela. Mas esses arquivos são **instruções lidas por um modelo**, não um binário fechado: um agente que execute só a linha do `curl`, isolada da guarda, não é barrado por nada aqui. Se o que você quer é garantia dura, a que existe é não criar o arquivo de chave — sem ele, não há para onde enviar, e todo bloco para na guarda.
+Sendo exato sobre a força dessa garantia, porque ela não é um sandbox: cada bloco que chama o Iron Office começa com uma guarda (`[ -z "$IRON_KEY" ] && exit 0`) e a regra R20 do lint impede que qualquer bloco novo entre sem ela. Mas esses arquivos são **instruções lidas por um modelo**, não um binário fechado: um agente que execute só a linha do `curl`, isolada da guarda, não é barrado por nada aqui. Se o que você quer é garantia dura, a que existe é não criar o arquivo de chave — sem ele, não há para onde enviar, e todo bloco para na guarda (o plugin `iron-office` também: sem a chave, ele não envia nada).
 
 ---
 

package/bin/iron-edge.js

@@ -14,6 +14,9 @@
  *                                         arquivos cujo hash bate com o manifesto — os que
  *                                         ninguem alterou — e preserva o resto
  *
+ *   office  [--safe]                      liga o Iron Office: instala o plugin de canal e abre o
+ *                                         Claude Code conversando com o chat do dashboard
+ *
  * Nao existe 'uninstall' automatico: remover continua sendo operacao conduzida, com o
  * manifesto na mao (o README descreve o procedimento).
  */
@@ -147,7 +150,12 @@ if (cmd === 'install') {
   // Reprovam so' divergencia sem registro e arquivo sumido.
   process.exit(alterados.length + sumidos.length === 0 ? 0 : 1);
 
+} else if (cmd === 'office') {
+  // liga o chat do dashboard (iron-office.vercel.app/chat) na sessao do Claude Code
+  const r = spawnSync(process.execPath, [path.join(__dirname, '..', 'installer', 'office.js'), ...rest], { stdio: 'inherit' });
+  process.exit(r.status ?? 1);
+
 } else {
-  console.log('uso: iron-edge <install|update|verify> [--dry-run] [--source <dir>]');
-  process.exit(cmd ? 1 : 0);
+  console.log('uso: iron-edge <install|update|verify|office> [--dry-run] [--source <dir>] [--safe]');
+  process.exit(cmd && cmd !== '--help' && cmd !== '-h' ? 1 : 0);
 }

package/installer/office.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+/**
+ * office.js — `npx iron-edge office`: liga o Iron Office (chat do dashboard) no Claude Code.
+ *
+ * Passos: (1) confere a chave do Iron Office (formato + confere com o site), (2) confere o
+ * Claude Code, (3) instala ou atualiza o plugin de canal `iron-office` pelo marketplace do
+ * GitHub, (4) abre o Claude Code com o canal ligado. O aluno deixa essa aba aberta: e' ela que
+ * faz o Iron responder no site.
+ *
+ * Flags: --safe tira o `--permission-mode bypassPermissions` (o Claude pede licenca a cada
+ * ferramenta). Qualquer outro argumento vai direto pro `claude`.
+ *
+ * Saida so' em ASCII, como o resto do instalador: console do Windows antigo mostra lixo em
+ * acento e simbolo. O `claude` recebe IRON_OFFICE_CHANNEL=1 no ambiente: e' o que diz ao
+ * servidor do plugin que ESTA sessao e' o canal (uma aba comum do Claude Code nao puxa o chat).
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawnSync } = require('child_process');
+
+const MARKETPLACE_REPO = 'filipecoff21-code/iron-office-channel';
+const PLUGIN = 'iron-office@iron-office-channel';
+const CHANNEL = 'plugin:' + PLUGIN;
+const OFFICE_URL = (process.env.IRON_OFFICE_URL || 'https://iron-office.vercel.app').replace(/\/+$/, '');
+const ONBOARDING = OFFICE_URL + '/onboarding';
+const IS_WIN = process.platform === 'win32';
+const KEY_RE = /^iok_[0-9a-f]{48}$/;
+const PING_TIMEOUT_MS = 5000;
+
+function keyPath(home) {
+  return path.join(home || os.homedir(), '.claude', 'iron-office-api-key');
+}
+
+function isValidKey(key) {
+  return typeof key === 'string' && KEY_RE.test(key);
+}
+
+// Le o arquivo da chave e devolve so' uma chave no formato certo; qualquer outra coisa vira ''.
+// O `echo` do passo 4 no Windows pode gravar UTF-16 com BOM: normaliza antes de decidir.
+function readKey(home) {
+  try {
+    const buf = fs.readFileSync(keyPath(home));
+    const utf16 = buf.length >= 2 && buf[0] === 0xff && buf[1] === 0xfe;
+    const key = buf.toString(utf16 ? 'utf16le' : 'utf8').replace(/[\u0000]/g, '').trim();
+    return isValidKey(key) ? key : '';
+  } catch (_) { return ''; }
+}
+
+function keyFileExists(home) {
+  try { return fs.statSync(keyPath(home)).isFile(); } catch (_) { return false; }
+}
+
+// Confere a chave com o site antes de abrir o Claude.
+// Devolve 'ok' (aceita), 'rejected' (401: a chave foi trocada) ou 'offline' (sem rede / erro).
+async function ping(key, baseUrl) {
+  const url = (baseUrl || OFFICE_URL).replace(/\/+$/, '') + '/api/api-key/ping';
+  if (typeof fetch !== 'function') return 'offline';
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), PING_TIMEOUT_MS);
+  try {
+    const r = await fetch(url, { headers: { 'x-api-key': key }, signal: ctl.signal });
+    if (r.status === 200) return 'ok';
+    if (r.status === 401) return 'rejected';
+    return 'offline';
+  } catch (_) {
+    return 'offline';
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// Argumentos do `claude` que abre a sessao com o canal. Separado pra ser testado sem rede.
+function buildClaudeArgs(argv) {
+  const safe = argv.includes('--safe');
+  const extra = argv.filter(a => a !== '--safe');
+  const args = ['--dangerously-load-development-channels', CHANNEL];
+  if (!safe) args.push('--permission-mode', 'bypassPermissions');
+  return args.concat(extra);
+}
+
+function run(bin, args, opts) {
+  return spawnSync(bin, args, { encoding: 'utf8', shell: IS_WIN, ...opts });
+}
+
+// No Windows o `claude` instalado pelo npm e' um `claude.cmd`; com shell ele costuma resolver,
+// mas ha PATH em que so' o nome com extensao funciona.
+function resolveClaude() {
+  const candidates = IS_WIN ? ['claude', 'claude.cmd'] : ['claude'];
+  for (const bin of candidates) {
+    const r = run(bin, ['--version']);
+    if (!r.error && r.status === 0) return bin;
+  }
+  return null;
+}
+
+function step(claude, label, args, okPatterns) {
+  const r = run(claude, args);
+  const out = ((r.stdout || '') + (r.stderr || '')).trim();
+  if (r.status === 0) { console.log('  [ok] ' + label); return true; }
+  if (okPatterns.some(p => p.test(out))) { console.log('  [ok] ' + label + ' (ja estava)'); return true; }
+  console.log('  [falhou] ' + label + ': ' + (out.split('\n').pop() || 'sem detalhe'));
+  return false;
+}
+
+async function main(argv) {
+  const key = readKey();
+  if (!key) {
+    if (keyFileExists()) {
+      console.error('A chave em ' + keyPath() + ' esta invalida (nao tem o formato iok_...).');
+      console.error('Refaca o passo 4 em ' + ONBOARDING);
+    } else {
+      console.error('Falta a chave do Iron Office. Faca o passo 4 em ' + ONBOARDING);
+    }
+    return 1;
+  }
+
+  const claude = resolveClaude();
+  if (!claude) {
+    console.error('Instale o Claude Code primeiro: https://claude.com/claude-code');
+    return 1;
+  }
+
+  console.log('Iron Office - preparando o canal');
+  const verdict = await ping(key);
+  if (verdict === 'rejected') {
+    console.error('  [falhou] chave recusada pelo Iron Office: ela foi trocada. Refaca o passo 4 em ' + ONBOARDING);
+    return 1;
+  }
+  if (verdict === 'ok') console.log('  [ok] chave aceita pelo Iron Office');
+  else console.log('  [aviso] nao deu pra conferir a chave com o site (sem rede?). Seguindo com a chave local.');
+
+  const okMarket = step(claude, 'marketplace ' + MARKETPLACE_REPO, ['plugin', 'marketplace', 'add', MARKETPLACE_REPO], [/already/i]);
+  const okPlugin = okMarket && step(claude, 'plugin ' + PLUGIN, ['plugin', 'install', PLUGIN, '--scope', 'user'], [/already/i]);
+  if (!okMarket || !okPlugin) {
+    console.error('');
+    console.error('Nao deu pra instalar o plugin do Iron Office. Confira:');
+    console.error('  1. a internet esta funcionando;');
+    console.error('  2. o git esta instalado (rode: git --version);');
+    console.error('  3. rode de novo: npx iron-edge office');
+    console.error('Se continuar, mande um print desta tela pro suporte.');
+    return 1;
+  }
+  // atualizar e' melhor-esforco: sem internet no meio, segue com a versao ja instalada
+  step(claude, 'atualizacao do plugin', ['plugin', 'update', PLUGIN], [/already|up.to.date|latest/i]);
+
+  const safe = argv.includes('--safe');
+  console.log('');
+  console.log('Abrindo o Claude Code com o Iron Office ligado.');
+  console.log('Vai aparecer um aviso de canal (recurso em teste): aceite.');
+  if (!safe) {
+    console.log('O Iron vai agir SEM pedir licenca a cada passo (e o que deixa ele trabalhar');
+    console.log('enquanto voce esta no site). Quer aprovar cada passo? Rode: npx iron-edge office --safe');
+  }
+  console.log('Deixe esta aba aberta: e ela que faz o Iron responder no site.');
+  console.log('');
+
+  const r = spawnSync(claude, buildClaudeArgs(argv), {
+    stdio: 'inherit',
+    shell: IS_WIN,
+    env: { ...process.env, IRON_OFFICE_CHANNEL: '1' },
+  });
+  return r.status ?? 1;
+}
+
+module.exports = { buildClaudeArgs, keyPath, readKey, isValidKey, ping, CHANNEL, PLUGIN, MARKETPLACE_REPO, KEY_RE };
+
+if (require.main === module) {
+  main(process.argv.slice(2)).then(code => process.exit(code), err => {
+    console.error('Erro inesperado: ' + (err && err.message ? err.message : err));
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "iron-edge",
-  "version": "2.3.2",
-  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 14 skills, com quality gate, memoria e instalador que nunca sobrescreve.",
+  "version": "2.4.1",
+  "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 14 skills, com quality gate, memoria, instalador que nunca sobrescreve e o comando office (chat do Iron Office no dashboard; confere a chave com o site antes de abrir o Claude).",
   "keywords": [
     "claude",
     "claude-code",
@@ -32,7 +32,7 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "node scripts/lint.js && node scripts/test-verify.js && node scripts/test-update.js",
+    "test": "node scripts/lint.js && node scripts/test-verify.js && node scripts/test-update.js && node scripts/test-office.js",
     "test:matriz": "node scripts/test-matriz-update.js"
   },
   "devDependencies": {