iron-edge 2.4.4 → 2.4.6

package/README.md

@@ -168,12 +168,18 @@ Instalada junto. Depois de `npx iron-edge install`, os dois arquivos abaixo est
 # Conferir a instalação: o que é seu, o que está diferente sem registro, o que sumiu
 npx iron-edge verify
 
-# Medir a máquina (Node, git, Claude Code, Iron Edge, chave, plugin, cofre). Com a chave do
+# Medir a máquina (Node, git, Claude Code, Iron Edge, chave, plugin, cofre, atalho). Com a chave do
 # Iron Office aceita, o resultado acende o checklist da página de Setup do site.
 npx iron-edge doctor
 
 # Instalar já criando um cofre vazio em ~/Iron Cofre (pronto pro Obsidian, nunca sobrescreve)
 npx iron-edge install --cofre
+
+# Ligar o Iron Office: depois do install (ou update), no Mac/Linux, o comando curto é
+ironoffice            # = npx iron-edge office (abra um terminal novo na primeira vez)
+
+# Instalar sem criar o atalho ironoffice no ~/.zshrc (ou ~/.bashrc)
+npx iron-edge install --sem-atalho
 ```
 
 **Atualizar é um comando. Remover é operação conduzida.**

package/bin/iron-edge.js

@@ -18,10 +18,11 @@
  *                                         Claude Code conversando com o chat do dashboard
  *
  *   doctor  [--json]                      mede a maquina (Node, git, Claude Code, Iron Edge, chave,
- *                                         plugin, cofre) e, com a chave aceita, manda o resultado
+ *                                         plugin, cofre, atalho) e, com a chave aceita, manda o resultado
  *                                         pra pagina de Setup do Iron Office
  *
  *   install --cofre                       alem do install, cria ~/Iron Cofre/ (cofre vazio pro Obsidian)
+ *   install/update --sem-atalho           nao cria o alias ironoffice (= office) no ~/.zshrc ou ~/.bashrc
  *
  * Nao existe 'uninstall' automatico: remover continua sendo operacao conduzida, com o
  * manifesto na mao (o README descreve o procedimento).

package/installer/atalho.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * atalho.js — cria o comando curto `ironoffice` (= `npx iron-edge office`) no shell do aluno.
+ * Roda no fim do install e do update com sucesso; `--sem-atalho` pula.
+ *
+ * Regras:
+ *  - Windows: nao faz nada (o PowerShell nao le .zshrc/.bashrc). O aluno usa `npx iron-edge office`.
+ *  - Mac: sempre ~/.zshrc (o shell padrao do Mac le so ele; um alias no .bashrc nunca carregaria).
+ *    Linux: ~/.zshrc se existir, senao ~/.bashrc se existir, senao cria ~/.zshrc.
+ *  - se o arquivo ja tem `alias ironoffice=`, nao mexe: nunca duplica.
+ *  - so' ACRESCENTA no fim. Nunca remove nem edita linha existente: o arquivo e' do aluno.
+ *  - escrita atomica: grava ao lado e renomeia por cima. Se o .zshrc e' um link (dotfiles),
+ *    escreve no arquivo de verdade e o link continua link. Link quebrado: nao mexe.
+ *  - os bytes do aluno ficam intactos: le e grava em Buffer (um .zshrc em Latin-1 nao e' recodificado).
+ *  - arquivo que existe e nao da pra ler (permissao, pasta no lugar): nao escreve nada. So' "nao existe"
+ *    (ENOENT) vale como arquivo novo. Antes, qualquer erro de leitura virava "vazio" e o rename
+ *    apagava o .zshrc do aluno (gate da onda 9).
+ *  - dryRun so' diz o que faria.
+ *
+ * Saida so' em ASCII, como o resto do instalador.
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const LINHA = 'alias ironoffice="npx iron-edge office"';
+const BLOCO = '\n# Iron Edge: atalho do canal do Iron Office\n' + LINHA + '\n';
+const JA_TEM = /^\s*alias\s+ironoffice=/m;
+
+function arquivoDoShell(home, platform) {
+  if (platform === 'darwin') return path.join(home, '.zshrc');
+  for (const nome of ['.zshrc', '.bashrc']) {
+    const p = path.join(home, nome);
+    if (fs.existsSync(p)) return p;
+  }
+  return path.join(home, '.zshrc');
+}
+
+// Devolve { criado: caminho } | { criaria: caminho }
+//   | { pulado: 'windows' | 'ja existe' | 'sem-atalho' | 'sem leitura' | 'link quebrado', arquivo? }
+function criarAtalho(opts) {
+  const o = opts || {};
+  const platform = o.platform || process.platform;
+  if (o.semAtalho) return { pulado: 'sem-atalho' };
+  if (platform === 'win32') return { pulado: 'windows' };
+  const home = o.HOME || os.homedir();
+  const rc = arquivoDoShell(home, platform);
+  let link = false;
+  try { link = fs.lstatSync(rc).isSymbolicLink(); } catch (_) { /* nao existe */ }
+  let real = rc;
+  if (link) {
+    try { real = fs.realpathSync.native(rc); } catch (_) { return { pulado: 'link quebrado', arquivo: rc }; }
+  }
+  let atual = Buffer.alloc(0);
+  try { atual = fs.readFileSync(real); } catch (e) {
+    if (!e || e.code !== 'ENOENT') return { pulado: 'sem leitura', arquivo: rc };
+  }
+  // latin1 mapeia byte a byte: acha o alias (ASCII) em qualquer codificacao sem estourar
+  if (JA_TEM.test(atual.toString('latin1'))) return { pulado: 'ja existe', arquivo: rc };
+  if (o.dryRun) return { criaria: rc };
+  let modo = 0o644;
+  try { modo = fs.statSync(real).mode & 0o777; } catch (_) {}
+  const tmp = real + '.iron-tmp-' + process.pid;
+  fs.writeFileSync(tmp, Buffer.concat([atual, Buffer.from(BLOCO)]), { mode: modo });
+  try { fs.renameSync(tmp, real); } catch (e) { try { fs.unlinkSync(tmp); } catch (_) {} throw e; }
+  return { criado: rc };
+}
+
+// Linha do relatorio do install/update
+function relatarAtalho(r) {
+  if (r.criado) return 'Atalho criado: ironoffice em ' + r.criado + ' (abra um terminal novo)';
+  if (r.criaria) return 'criaria o atalho ironoffice em ' + r.criaria;
+  if (r.pulado === 'ja existe') return 'Atalho ja existia: ironoffice';
+  if (r.pulado === 'windows') return 'Windows: use npx iron-edge office';
+  if (r.pulado === 'sem leitura') return 'Atalho nao criado: nao consegui ler ' + r.arquivo + ' (nada foi mexido). Use npx iron-edge office';
+  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';
+  return 'Atalho pulado (--sem-atalho): use npx iron-edge office';
+}
+
+// Rodado no fim do install/update: nunca derruba a instalacao que ja deu certo.
+function atalhoNoFim(opts) {
+  try {
+    return relatarAtalho(criarAtalho(opts));
+  } catch (e) {
+    return 'Atalho nao criado (' + (e.code || e.message) + '): use npx iron-edge office';
+  }
+}
+
+module.exports = { criarAtalho, relatarAtalho, atalhoNoFim, LINHA };

package/installer/doctor.js

@@ -4,7 +4,8 @@
  * pra a pagina de Setup acender cada passo sozinha (o site nao enxerga a maquina).
  *
  * Mede: node (>= 20), git, Claude Code, Iron Edge instalado pelo npm (manifesto), chave do Iron
- * Office (formato + confere com o site), plugin iron-office, cofre (~/Iron Cofre, informativo).
+ * Office (formato + confere com o site), plugin iron-office, cofre (~/Iron Cofre, informativo),
+ * atalho ironoffice no .zshrc/.bashrc (informativo).
  *
  * Envio: SO' com a chave aceita pelo site (ping = ok) faz POST /api/chat/setup-status. Sem chave,
  * com chave recusada ou sem rede, o resultado fica so' no terminal. Falhar o envio e' aviso, nao erro.
@@ -90,6 +91,23 @@ function checkPlugin(claudeBin) {
   return out.includes(PLUGIN) ? item(true, PLUGIN) : item(false, 'falta o plugin: rode npx iron-edge office');
 }
 
+// alias ironoffice (installer/atalho.js): no Windows nao existe, entao conta como ok
+function checkAtalho(home) {
+  if (IS_WIN) return item(true, 'não se aplica (Windows: npx iron-edge office)');
+  // nao existe = segue procurando; existe e nao abre = diz isso (o update tambem nao conseguiria)
+  let semLeitura = '';
+  for (const nome of ['.zshrc', '.bashrc']) {
+    let txt = '';
+    try { txt = fs.readFileSync(path.join(home, nome), 'latin1'); } catch (e) {
+      if (!semLeitura && e && e.code !== 'ENOENT') semLeitura = nome;
+      continue;
+    }
+    if (/^\s*alias\s+ironoffice=/m.test(txt)) return item(true, 'ironoffice em ~/' + nome);
+  }
+  if (semLeitura) return item(false, 'não consegui ler ~/' + semLeitura);
+  return item(false, 'ausente: rode npx iron-edge update');
+}
+
 function checkCofre(home) {
   const ok = fs.existsSync(path.join(home, 'Iron Cofre', 'CLAUDE.md'));
   return item(ok, ok ? '~/Iron Cofre' : 'sem cofre pronto (opcional: npx iron-edge install --cofre)');
@@ -111,6 +129,7 @@ async function medir(opts) {
       key: key.check,
       plugin: checkPlugin(claude.bin),
       cofre: checkCofre(home),
+      atalho: checkAtalho(home),
     },
     ran_at: new Date().toISOString(),
   };
@@ -138,7 +157,7 @@ async function enviar(result, key, baseUrl) {
   }
 }
 
-const ROTULO = { node: 'Node', git: 'git', claude: 'Claude Code', iron_edge: 'Iron Edge', key: 'chave', plugin: 'plugin', cofre: 'cofre' };
+const ROTULO = { node: 'Node', git: 'git', claude: 'Claude Code', iron_edge: 'Iron Edge', key: 'chave', plugin: 'plugin', cofre: 'cofre', atalho: 'atalho' };
 const OBRIGATORIOS = ['node', 'git', 'claude', 'iron_edge'];
 
 async function main(argv, opts) {
@@ -153,7 +172,7 @@ async function main(argv, opts) {
   }
   console.log('Iron Edge doctor ' + result.doctor);
   for (const [k, c] of Object.entries(result.checks)) {
-    console.log('  ' + (c.ok ? '[ok]    ' : (k === 'cofre' ? '[info]  ' : '[falta] ')) + ROTULO[k] + ': ' + ascii(c.detail));
+    console.log('  ' + (c.ok ? '[ok]    ' : (k === 'cofre' || k === 'atalho' ? '[info]  ' : '[falta] ')) + ROTULO[k] + ': ' + ascii(c.detail));
   }
   console.log('');
   if (!key && !readKey(o.home || homeDir())) {

package/installer/install.js

@@ -16,7 +16,7 @@
  *  - Manifesto com SHA-256 (gerados marcados generated:true).
  *  - shopify.yaml nasce desativado. config em branco (sem PII).
  *
- * Uso: node install.js [--dry-run] [--source <dir>] [--cofre]
+ * Uso: node install.js [--dry-run] [--source <dir>] [--cofre] [--sem-atalho]
  */
 
 'use strict';
@@ -42,6 +42,7 @@ function abort(msg) {
 const args = process.argv.slice(2);
 const DRY_RUN = args.includes('--dry-run');
 const COFRE = args.includes('--cofre'); // cria ~/Iron Cofre/ no fim (installer/cofre.js)
+const SEM_ATALHO = args.includes('--sem-atalho'); // nao cria o alias ironoffice (installer/atalho.js)
 const srcIdx = args.indexOf('--source');
 let SOURCE = srcIdx >= 0 && args[srcIdx + 1] ? path.resolve(args[srcIdx + 1]) : __dirname;
 // Opera sobre o caminho FISICO: ancestral symlink herdado da maquina (perfil
@@ -337,6 +338,8 @@ if (DRY_RUN) {
   log('\n--- arquivos que SERAO gerados ---');
   for (const g of GENERATED) log('  ' + g.dest);
   if (COFRE) require('./cofre').criarCofre({ home: HOME, dryRun: true });
+  log('\n--- atalho ---');
+  log('  ' + require('./atalho').atalhoNoFim({ HOME, dryRun: true, semAtalho: SEM_ATALHO }));
   log('\nDRY-RUN concluido. Nada foi copiado.');
   process.exit(0);
 }
@@ -552,6 +555,7 @@ log(`Agentes : ${AGENTS_DEST}`);
 log(`Skills  : ${SKILLS_DEST}`);
 log(`Nucleo  : ${IRON_DIR}`);
 log(`Manifesto: ${manifestPath}`);
+log(require('./atalho').atalhoNoFim({ HOME, semAtalho: SEM_ATALHO }));
 log('\n--------------------------------');
 log('  PROXIMO PASSO');
 log('--------------------------------');

package/installer/office.js

@@ -37,7 +37,7 @@ function isValidKey(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.
+// O `echo` do passo 2 no Windows pode gravar UTF-16 com BOM: normaliza antes de decidir.
 function readKey(home) {
   try {
     const buf = fs.readFileSync(keyPath(home));
@@ -94,6 +94,32 @@ function resolveClaude() {
   return null;
 }
 
+// Versao do plugin instalado, lida do `claude plugin list` ("Version: x.y.z" logo abaixo do nome).
+// Timeout de 5 s: um `claude plugin list` travado nao pode segurar a abertura do canal (estourou = sem aviso).
+function pluginVersion(claude) {
+  const r = run(claude, ['plugin', 'list'], { timeout: 5000 });
+  if (r.error) return '';
+  const out = (r.stdout || '') + (r.stderr || '');
+  const i = out.indexOf(PLUGIN);
+  if (i < 0) return '';
+  const m = out.slice(i).match(/Version:\s*([0-9][\w.-]*)/);
+  return m ? m[1] : '';
+}
+
+// Plugin mudou desde a ultima abertura do canal: sessoes do Claude abertas antes rodam o hook velho,
+// que o painel nao aceita mais (onda 10). Avisa uma vez por versao; guarda a ultima em ~/.iron.
+// Primeira abertura (sem registro anterior): grava calado, porque quem acabou de instalar nao tem sessao velha.
+function avisoPluginNovo(claude, home) {
+  const atual = pluginVersion(claude);
+  if (!atual) return;
+  const arq = path.join(home || os.homedir(), '.iron', 'office-plugin-version');
+  let anterior = '';
+  try { anterior = fs.readFileSync(arq, 'utf8').trim(); } catch (_) { /* primeira vez */ }
+  if (anterior === atual) return;
+  if (anterior) console.log('  [aviso] Plugin atualizado: sessoes do Claude abertas antes disso nao aparecem mais no painel; abra o canal de novo.');
+  try { fs.mkdirSync(path.dirname(arq), { recursive: true }); fs.writeFileSync(arq, atual + '\n'); } catch (_) { /* aviso de novo na proxima */ }
+}
+
 function step(claude, label, args, okPatterns) {
   const r = run(claude, args);
   const out = ((r.stdout || '') + (r.stderr || '')).trim();
@@ -108,9 +134,9 @@ async function main(argv) {
   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);
+      console.error('Refaca o passo 2 (Ligar o Iron) em ' + ONBOARDING);
     } else {
-      console.error('Falta a chave do Iron Office. Faca o passo 4 em ' + ONBOARDING);
+      console.error('Falta a chave do Iron Office. Faca o passo 2 (Ligar o Iron) em ' + ONBOARDING);
     }
     return 1;
   }
@@ -124,7 +150,7 @@ async function main(argv) {
   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);
+    console.error('  [falhou] chave recusada pelo Iron Office: ela foi trocada. Refaca o passo 2 (Ligar o Iron) em ' + ONBOARDING);
     return 1;
   }
   if (verdict === 'ok') console.log('  [ok] chave aceita pelo Iron Office');
@@ -143,6 +169,7 @@ async function main(argv) {
   }
   // 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]);
+  avisoPluginNovo(claude);
 
   const safe = argv.includes('--safe');
   console.log('');
@@ -163,7 +190,7 @@ async function main(argv) {
   return r.status ?? 1;
 }
 
-module.exports = { buildClaudeArgs, keyPath, readKey, keyFileExists, isValidKey, ping, resolveClaude, CHANNEL, PLUGIN, MARKETPLACE_REPO, KEY_RE };
+module.exports = { avisoPluginNovo, pluginVersion, buildClaudeArgs, keyPath, readKey, keyFileExists, isValidKey, ping, resolveClaude, CHANNEL, PLUGIN, MARKETPLACE_REPO, KEY_RE };
 
 if (require.main === module) {
   main(process.argv.slice(2)).then(code => process.exit(code), err => {

package/installer/update.js

@@ -28,6 +28,8 @@ const MANIFEST = path.join(IRON_DIR, 'install-manifest.json');
 
 const args = process.argv.slice(2);
 const DRY = args.includes('--dry-run');
+const SEM_ATALHO = args.includes('--sem-atalho'); // nao cria o alias ironoffice (installer/atalho.js)
+const atalho = (dryRun) => require('./atalho').atalhoNoFim({ HOME, dryRun, semAtalho: SEM_ATALHO });
 const srcIdx = args.indexOf('--source');
 const SOURCE = srcIdx >= 0 && args[srcIdx + 1] ? path.resolve(args[srcIdx + 1]) : path.join(__dirname, '..');
 
@@ -292,7 +294,7 @@ log('');
 relatarConfig();
 
 
-if (DRY) { log(''); log('--dry-run: nada foi escrito.'); process.exit(0); }
+if (DRY) { log(''); log(atalho(true)); log('--dry-run: nada foi escrito.'); process.exit(0); }
 
 // Permissao da pasta de segredos, TAMBEM no update. O chmod entrou no install no ciclo 2 e o
 // gate mediu a lacuna: quem ja tinha o Iron instalado seguia com `secrets/` em 755, porque o
@@ -385,6 +387,7 @@ const versaoDoPacote = process.env.IRON_EDGE_VERSION ? 'iron-edge-' + process.en
 const versaoDesatualizada = Boolean(versaoDoPacote) && versaoRegistrada !== versaoDoPacote;
 if (!plano.trocar.length && !plano.adicionar.length && !plano.restaurar.length && !plano.remover.length && !plano.gerar.length && !plano.preservar.length && !versaoDesatualizada && !metadataReparado) {
   log(''); log('Nada a fazer: sua instalacao ja esta na versao deste pacote.');
+  log(atalho(false));
   process.exit(0);
 }
 
@@ -519,6 +522,7 @@ log('');
 log('================================');
 log('  Atualizado com sucesso');
 log('================================');
+log(atalho(false));
 log('Confira quando quiser: npx iron-edge verify');
 log('Reabra o Claude Code para carregar o que mudou.');
 log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iron-edge",
-  "version": "2.4.4",
+  "version": "2.4.6",
   "description": "Ecossistema de agentes para Claude Code: 44 agentes de topo, 18 squads e 14 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).",
   "keywords": [
     "claude",
@@ -32,7 +32,7 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "node scripts/lint.js && node scripts/test-verify.js && node scripts/test-update.js && node scripts/test-office.js && node scripts/test-cofre.js",
+    "test": "node scripts/lint.js && node scripts/test-verify.js && node scripts/test-update.js && node scripts/test-office.js && node scripts/test-cofre.js && node scripts/test-atalho.js",
     "test:matriz": "node scripts/test-matriz-update.js"
   },
   "devDependencies": {