iron-edge 1.2.0 → 2.0.1

package/agents/xq-cyber.md

@@ -1,7 +1,7 @@
 ---
 name: xq-cyber
 description: Cybersecurity Chief — 15 especialistas em segurança ofensiva e defensiva
-model: claude-opus-4-6
+model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 

package/agents/xq-data.md

@@ -1,7 +1,7 @@
 ---
 name: xq-data
 description: Data Squad Chief — Sean Ellis, Avinash Kaushik e especialistas em analytics, growth e métricas
-model: claude-opus-4-6
+model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 

package/agents/xq-design.md

@@ -1,7 +1,7 @@
 ---
 name: xq-design
 description: Design Squad Chief — especialistas em UX/UI, design systems e experiência do usuário
-model: claude-opus-4-6
+model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 

package/agents/xq-hormozi.md

@@ -1,7 +1,7 @@
 ---
 name: xq-hormozi
-description: Hormozi Squad Chief — 16 agentes com frameworks de Alex Hormozi: Grand Slam Offers, Value Equation, CLOSER, escala
-model: claude-opus-4-6
+description: "Hormozi Squad Chief — 16 agentes com frameworks de Alex Hormozi: Grand Slam Offers, Value Equation, CLOSER, escala"
+model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 

package/agents/xq-movement.md

@@ -1,7 +1,7 @@
 ---
 name: xq-movement
 description: Movement Chief — especialistas em comunidades, movimentos de marca e mobilização de audiência
-model: claude-opus-4-6
+model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 

package/agents/xq-storytelling.md

@@ -1,7 +1,7 @@
 ---
 name: xq-storytelling
 description: Storytelling Chief — Joseph Campbell, Dan Harmon, Oren Klaff, Nancy Duarte para narrativa estratégica
-model: claude-opus-4-6
+model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 

package/agents/xq-traffic.md

@@ -1,7 +1,7 @@
 ---
 name: xq-traffic
 description: Traffic Masters Chief — Kasim Aslam, Pedro Sobral, Molly Pittman, Tom Breeze para tráfego pago
-model: claude-opus-4-6
+model: sonnet
 tools: [Read, Write, Edit, Bash, WebSearch, WebFetch, Glob, Grep]
 ---
 

package/bin/iron-edge.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * iron-edge — instalador e verificador do ecossistema Iron Edge.
+ *
+ * Comandos:
+ *   install [--dry-run] [--source <dir>]  instala o pacote (motor v3: nunca
+ *                                         sobrescreve sem avisar, valida payload,
+ *                                         grava manifesto com hash de tudo)
+ *   verify                                confere a instalacao contra o manifesto:
+ *                                         imprime versao, edicao, commit e os
+ *                                         arquivos que o usuario alterou
+ *
+ * Nao existe 'update' nem 'uninstall' automaticos: atualizar e remover sao
+ * operacoes conduzidas (runbook), com humano no circuito.
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const crypto = require('crypto');
+const { spawnSync } = require('child_process');
+
+const HOME = os.homedir();
+const cmd = process.argv[2];
+const rest = process.argv.slice(3);
+
+function sha256(file) {
+  return crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
+}
+
+if (cmd === 'install') {
+  // o payload e o proprio pacote (npm ou pasta do zip): a raiz acima de bin/
+  const pkgRoot = path.join(__dirname, '..');
+  const args = [path.join(pkgRoot, 'installer', 'install.js'), ...rest];
+  if (!rest.includes('--source')) args.push('--source', pkgRoot);
+  const r = spawnSync(process.execPath, args, { stdio: 'inherit' });
+  process.exit(r.status ?? 1);
+
+} else if (cmd === 'verify') {
+  const manPath = path.join(HOME, '.iron', 'install-manifest.json');
+  if (!fs.existsSync(manPath)) {
+    console.error('verify: nao ha instalacao registrada (~/.iron/install-manifest.json ausente).');
+    console.error('Se o Iron foi instalado por um metodo antigo, reinstale com: iron-edge install');
+    process.exit(1);
+  }
+  const man = JSON.parse(fs.readFileSync(manPath, 'utf8'));
+  const files = man.files || [];
+  let alterados = [], sumidos = [];
+  for (const f of files) {
+    const dest = f.dest || f.path || f;
+    const want = f.sha256 || f.hash;
+    if (!dest || !want) continue;
+    if (!fs.existsSync(dest)) { sumidos.push(dest); continue; }
+    if (sha256(dest) !== want) alterados.push(dest);
+  }
+  console.log(`Iron Edge — verificacao da instalacao`);
+  if (man.label) console.log(`  edicao:  ${man.label}`);
+  if (man.version) console.log(`  versao:  ${man.version}`);
+  const br = path.join(HOME, '.iron', 'BUILD-REPORT.md');
+  if (fs.existsSync(br)) {
+    const m = fs.readFileSync(br, 'utf8').match(/source_commit:\s*([0-9a-f]{7,40})/);
+    if (m) console.log(`  commit da fonte: ${m[1]}`);
+  }
+  if (man.installed_at) console.log(`  instalado em: ${man.installed_at}`);
+  console.log(`  arquivos no manifesto: ${files.length}`);
+  console.log(`  alterados pelo usuario: ${alterados.length}`);
+  for (const a of alterados) console.log(`    ~ ${a}`);
+  console.log(`  ausentes: ${sumidos.length}`);
+  for (const s of sumidos) console.log(`    x ${s}`);
+  process.exit(alterados.length + sumidos.length === 0 ? 0 : 1);
+
+} else {
+  console.log('uso: iron-edge <install|verify> [--dry-run] [--source <dir>]');
+  process.exit(cmd ? 1 : 0);
+}

package/docs/2026-08-21-como-pedir-software-ao-iron.md

@@ -0,0 +1,62 @@
+# Como pedir software ao Iron
+
+Você pede um app, um sistema, uma automação ou o conserto de um bug. O `iron-eng` **varre a pasta antes de propor**, diz o que existe e o que falta, e declara o tamanho do pedido. Coisa pequena sai sem papel; coisa grande passa por documento, porque aí documento economiza retrabalho.
+
+Peça em português, nomeando o agente:
+
+```
+"usa o iron-eng: <o que você quer>"
+```
+
+⚠️ **Não é `/iron-eng`.** Barra de comando é para *skill*; `iron-eng` é *agente*, e agente se chama
+pedindo. Uma instalação perfeitamente correta não tem `/iron-eng` — até 24/08/2026 esta página dizia
+que a ausência dele significava pacote não instalado, e isso estava errado. Para conferir de verdade
+se o pacote está inteiro, rode `npx iron-edge verify`.
+
+Falar com o `iron-ceo` também funciona: ele encaminha pedido de software pra cá.
+
+## As três faixas
+
+| Faixa | Quando | Você recebe | Custo |
+|---|---|---|---|
+| **AJUSTE** | mudança pequena no que já roda | a mudança, e nada de papel | minutos |
+| **FEATURE** | acréscimo real no que já roda | uma story de uma página pra aprovar | uma aprovação |
+| **PROJETO** | software novo, ou algo que muda o rumo | brief, requisitos, arquitetura e lista de tarefas | quatro aprovações |
+
+**Sobe pra PROJETO sempre que houver:** login novo · pagamento · dado pessoal que o sistema ainda não tratava · integração externa nova · troca de tecnologia · dado de produção.
+
+```
+"troca o texto do botão pra Nova nota"          → AJUSTE, zero documento
+"adiciona campo de telefone e grava no banco"   → FEATURE, uma story
+"quero um app de tarefas com login"             → PROJETO, os quatro documentos
+```
+
+## O que você faz
+
+**Responde o que ele não pode inventar:** o que dói hoje, quem usa, como saber que funcionou. O que você não souber vira `(a definir)` — ele nunca chuta.
+
+**Aprova.** Em PROJETO, quatro momentos. Aprovada a lista de tarefas, ele trabalha sem interromper — e só para quando **tem** que parar: dependência nova, dado de produção, senha, publicação, ou trabalho que cresceu além do previsto.
+
+**Pede mais controle se quiser:** peça pra ligar `sempre_story` e todo pedido vira story pra aprovar antes.
+
+## O que ele nunca faz sem você
+
+Publicar · mexer em dado de produção · instalar coisa nova · inventar requisito, número ou prazo · guardar senha (ele registra "existe", nunca o valor).
+
+## Como saber se fez direito
+
+- **A última linha começa com `▸`** e diz quem trabalhou de verdade. Se ele fez no lugar de um especialista, essa linha avisa. Sem ela, a resposta está incompleta.
+- **Todo código é auditado por quem não escreveu**, pela skill `gate`, com parecer gravado. Disse que está pronto? Tem parecer.
+- **Documento tem tamanho máximo.** Veio gigante, alguma coisa saiu do lugar — a faixa errada, ou conteúdo de um documento dentro do outro. Pode reclamar.
+
+## Onde ficam as coisas
+
+Documentos em `docs/eng/` do projeto · pareceres em `_auditoria/` · o que ele aprendeu em `~/.iron/memory/squad-engineering/` · o estado do projeto na folha do seu cofre, pela skill `salvar`.
+
+Não quer documento dentro do repositório (é de terceiro, é do trabalho)? Diga: ele guarda fora e pergunta antes.
+
+## Quando não é com ele
+
+Página sem login e sem dado, ou aparência de tela → `iron-design` (ou `lp-cinematico`) · ajustar o Claude Code → `iron-claude` · segurança → `iron-cyber` aponta, o `iron-eng` corrige.
+
+A regra: **tem dado, login ou integração? É software.** Não tem? É peça visual.

package/docs/2026-08-21-skill-gate-fonte-unica.md

@@ -0,0 +1,70 @@
+# A skill `gate` tem uma fonte só: este repositório
+
+**Data:** 2026-08-21 · **Status:** vigente
+
+## O problema que isto resolve
+
+Até 21/08/2026 existiam **duas** skills chamadas `gate` na máquina de desenvolvimento, com réguas diferentes: a deste repositório (`skills/gate/`, faixas `VAI SAIR`/`LOCAL`, painéis de código) e uma cópia instalada em `~/.claude/skills/gate/` (faixas `CLIENTE-FINAL`/`INTERNO`, painéis de peça visual). Cada uma recebeu correções que a outra não tinha. Quem instalava o pacote recebia um gate que não auditava arte; quem desenvolvia o pacote rodava um gate que não auditava código.
+
+Duas réguas com o mesmo nome valem menos que uma só.
+
+## A regra, em uma linha
+
+**`skills/gate/` neste repositório é a única fonte.** Corrigiu aqui = corrigiu em todo lugar.
+
+## Como cada máquina recebe a skill
+
+| Máquina | Como recebe | Por quê |
+|---|---|---|
+| **Desenvolvimento** (quem edita este repositório) | `~/.claude/skills/gate` é um **symlink** para `<repo>/skills/gate` | Divergência fica fisicamente impossível: editar a skill e usar a skill são o mesmo arquivo. O instalador **não** roda nesta máquina — o symlink faz o papel |
+| **De quem instala o pacote** | O instalador **copia** a pasta `skills/gate/` inteira (SKILL.md + preflight.py + `hooks/`) para `~/.claude/skills/gate/`, registrada no manifesto com hash | O payload não pode conter symlink: o instalador aborta se encontrar um (`installer/install.js`, função `walk`). Cópia com hash é o que permite verificar integridade e migrar por versão |
+
+A skill entra em **todas** as edições: `gate` faz parte da camada de MÉTODO em `scripts/build-edition.js`, junto com `salvar`, `anotar`, `escada`, `conectar-mcp` e `faxina`.
+
+## Como montar o symlink numa máquina de desenvolvimento
+
+```bash
+# 1. guardar o que já estava instalado, FORA do repositório
+mkdir -p ~/.claude/skills/_historico
+mv ~/.claude/skills/gate ~/.claude/skills/_historico/gate-AAAA-MM-DD-pre-unificacao
+
+# 2. apontar para o repositório
+ln -s <caminho-do-repo>/skills/gate ~/.claude/skills/gate
+
+# 3. conferir (os três, nesta ordem)
+ls -l ~/.claude/skills/gate          # tem que mostrar a seta ->
+head -3 ~/.claude/skills/gate/SKILL.md
+ls -l ~/.claude/skills/gate/         # SKILL.md, preflight.py e hooks/ aparecem
+```
+
+A cópia de segurança vai **fora** do repositório de propósito: ela carrega nome de pessoa e caminho de máquina, e as regras R7/R8 do `scripts/lint.js` proíbem isso dentro do pacote.
+
+## ⚠️⚠️ Trocar de branch troca a skill ATIVA
+
+O symlink aponta para o **working tree**, não para um commit. Então, na máquina de desenvolvimento, **`git checkout` de outra branch troca a régua que o gate usa naquele instante** — sem aviso nenhum, porque o symlink continua íntegro e a skill continua carregando; só que com outro conteúdo.
+
+Medido em 22/08/2026, no merge para a `main`: com a `main` ainda sem o merge, um `checkout main` deixou a skill ativa na versão de **189 linhas, sem `hooks/` e sem os painéis visuais**. Bastou concluir o merge para voltar às 318.
+
+**Como conviver com isso:**
+- Não fique em branch antiga com trabalho de gate em andamento. Se precisar visitar uma, faça o que tem que fazer e volte.
+- **Depois de qualquer `checkout`, `merge`, `rebase` ou `stash` no repositório, confira a régua antes de auditar:** `wc -l ~/.claude/skills/gate/SKILL.md` e `ls ~/.claude/skills/gate/hooks/`.
+- Um parecer emitido sob a régua errada não se distingue de um emitido sob a certa — por isso o campo `fonte:` do parecer existe, e por isso ele pede o `git rev-parse --short HEAD`.
+
+É o preço do symlink, e ele é menor que o preço de duas skills divergindo. Mas é preço, e está escrito aqui para ninguém descobrir sozinho.
+
+## ⚠️ O que quebra o symlink
+
+**Mover ou renomear a pasta do repositório quebra o symlink em silêncio** — o `~/.claude/skills/gate` continua existindo como link, apontando para o nada, e a skill simplesmente para de disparar sem mensagem de erro.
+
+Se a pasta do repositório mudar de lugar, refaça o passo 2 acima apontando para o caminho novo. E confira com `ls -l ~/.claude/skills/gate`: link quebrado aparece com o alvo inexistente.
+
+Duas consequências relacionadas:
+- **Nunca colocar o repositório dentro de pasta sincronizada** (iCloud Drive, Dropbox, OneDrive): a sincronização corrompe `.git` e pode mover a pasta sem avisar.
+- **Backup do repositório é backup da skill.** Perder o repositório é perder a régua que a máquina usa todo dia, não só o pacote.
+
+## O que continua fora do repositório, e por quê
+
+- **`~/.claude/gate/ledger.csv`** — é histórico da máquina, não do pacote. Formato e caminho não mudaram: `data,peca,tipo,faixa,rodada,bloqueadores,importantes,veredito,bypass`.
+Só isso. **Os hooks NÃO ficam de fora**: `gate-dirty.sh` e `gate-stop.sh` viajam dentro da skill, em `skills/gate/hooks/`, e caem em `~/.claude/skills/gate/hooks/` nas duas máquinas — pelo symlink na de desenvolvimento, pela cópia do instalador na de quem instala. Continuam **desativados** por padrão (só passam a valer se alguém os registrar no `settings.json`), falham abertos sem Python, e não rodam em Windows corporativo com política gerenciada. A seção 10 da SKILL.md traz o caminho, o JSON de ativação e o que é bloqueio real contra o que é instrução de prompt.
+
+⚠️ **Isto já esteve errado neste documento.** A primeira versão dizia que os hooks moravam em `~/.claude/hooks/`, fora do repositório — era verdade quando este arquivo foi escrito e deixou de ser na mesma sessão, quando o gate apontou que a skill prometia scripts que só existiam na máquina de quem a escreveu. Se você mudar de novo onde eles moram, **este arquivo e a seção 10 da SKILL.md mudam juntos**, por `grep`, não de memória.

package/installer/install-mac.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+#
+# Iron Edge — Instalador (wrapper Mac/Linux)
+# Wrapper fino: confere o Node e chama o install.js (a lógica de verdade).
+#
+# Uso:
+#   ./install-mac.sh            instala
+#   ./install-mac.sh --dry-run  só mostra o plano, não copia nada
+#
+
+set -euo pipefail
+
+# diretório deste script (resolve mesmo se chamado de outro lugar)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+INSTALLER="$SCRIPT_DIR/install.js"
+
+echo "================================"
+echo "  Iron Edge — Instalador (Mac)"
+echo "================================"
+
+# 1. Node existe?
+if ! command -v node >/dev/null 2>&1; then
+  echo ""
+  echo "[ERRO] Node.js não encontrado."
+  echo "O Iron Edge precisa do Node.js para instalar."
+  echo "Instale o Node (versão 18 ou superior) em https://nodejs.org e rode de novo."
+  exit 1
+fi
+
+# 2. versão mínima do Node (>= 18, por causa de fs.realpathSync.native e cp)
+NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]')"
+if [ "$NODE_MAJOR" -lt 18 ]; then
+  echo ""
+  echo "[ERRO] Node.js $(node -v) é muito antigo."
+  echo "O Iron Edge precisa do Node 18 ou superior. Atualize e rode de novo."
+  exit 1
+fi
+
+# 3. o install.js está aqui do lado?
+if [ ! -f "$INSTALLER" ]; then
+  echo ""
+  echo "[ERRO] não achei install.js em $SCRIPT_DIR"
+  echo "Rode este script de dentro da pasta descompactada do Iron Edge."
+  exit 1
+fi
+
+echo "Node $(node -v) OK."
+echo ""
+
+# 4. chamar o cérebro, repassando os argumentos (ex: --dry-run)
+#    --source aponta pra esta pasta (onde o wrapper e o payload estão)
+node "$INSTALLER" --source "$SCRIPT_DIR" "$@"

package/installer/install-windows.ps1

@@ -0,0 +1,65 @@
+# Iron Edge - Instalador (wrapper Windows / PowerShell)
+# Wrapper fino: confere o Node e chama o install.js (a logica de verdade).
+#
+# Uso:
+#   .\install-windows.ps1            instala
+#   .\install-windows.ps1 -DryRun    so mostra o plano, nao copia nada
+#
+# Se o Windows bloquear por Execution Policy, rode:
+#   powershell -ExecutionPolicy Bypass -File .\install-windows.ps1
+
+param(
+    [switch]$DryRun
+)
+
+$ErrorActionPreference = "Stop"
+
+# pasta deste script (Codex: usar $PSScriptRoot)
+$ScriptDir = $PSScriptRoot
+$Installer = Join-Path $ScriptDir "install.js"
+
+Write-Host "================================"
+Write-Host "  Iron Edge - Instalador (Windows)"
+Write-Host "================================"
+
+# 1. Node existe? (Codex: usar Get-Command node)
+$nodeCmd = Get-Command node -ErrorAction SilentlyContinue
+if ($null -eq $nodeCmd) {
+    Write-Host ""
+    Write-Host "[ERRO] Node.js nao encontrado." -ForegroundColor Red
+    Write-Host "O Iron Edge precisa do Node.js para instalar."
+    Write-Host "Instale o Node (versao 18 ou superior) em https://nodejs.org e rode de novo."
+    exit 1
+}
+
+# 2. versao minima do Node (>= 18)
+$nodeMajor = [int](node -p "process.versions.node.split('.')[0]")
+if ($nodeMajor -lt 18) {
+    $nodeVer = node -v
+    Write-Host ""
+    Write-Host "[ERRO] Node.js $nodeVer e muito antigo." -ForegroundColor Red
+    Write-Host "O Iron Edge precisa do Node 18 ou superior. Atualize e rode de novo."
+    exit 1
+}
+
+# 3. o install.js esta aqui do lado?
+if (-not (Test-Path -LiteralPath $Installer)) {
+    Write-Host ""
+    Write-Host "[ERRO] nao achei install.js em $ScriptDir" -ForegroundColor Red
+    Write-Host "Rode este script de dentro da pasta descompactada do Iron Edge."
+    exit 1
+}
+
+$nodeVer = node -v
+Write-Host "Node $nodeVer OK."
+Write-Host ""
+
+# 4. chamar o cerebro, com caminhos entre aspas (Codex)
+#    --source aponta pra esta pasta (onde o wrapper e o payload estao)
+if ($DryRun) {
+    node "$Installer" --source "$ScriptDir" --dry-run
+} else {
+    node "$Installer" --source "$ScriptDir"
+}
+
+exit $LASTEXITCODE