fix: tolerar BOM em arquivos JSON lidos do projeto (v1.2.25)

Crash na instalação quando o `.reversa/state.json` do projeto tinha BOM
UTF-8 (bytes EF BB BF no início). Origem típica: edição em Notepad ou
Out-File legado do PowerShell em sessões anteriores. JSON.parse do Node
não tolera BOM e quebrava o install com SyntaxError.

Adiciona helper `lib/utils/json-safe.js` com `readJsonSafe()` que strip
BOM antes de parsear. Aplica em todos os 10 sites que liam state.json e
files-manifest.json (install, update, status, add-engine, add-agent,
export-diagrams, validator, manifest, writer.saveCreatedFiles e
install.getVersion). Saídas via JSON.stringify continuam UTF-8 sem BOM,
então o próximo rewrite normaliza o arquivo automaticamente.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

feat: Designer em duas fases (topologia + arquitetura) e docs de engi…

…nes (v1.2.24)

Designer agora opera em duas fases com pausa humana entre elas. Fase 1 detecta a
topologia do legado, sempre propõe uma alternativa moderna e produz
topology_decision.md (preservar | modernizar | híbrido). Fase 2 só roda após
aprovação. Implementa a diretriz de não aplicar topologia moderna em silêncio.

Mudanças complementares:
- state.json sobe para schemaVersion 2: currentAgent vira objeto com phase,
  status e topologyApproved (fonte única de verdade da aprovação).
- migrate orquestra checkpoint intra-agente, com retomada robusta de pausa
  pendente entre sessões.
- handoff.md eleva topology_decision.md a leitura obrigatória junto com
  paradigm_decision.md.
- docs/engines.md e docs/engines.es.md alinhados com docs/engines.pt.md:
  Cline, Roo Code, GitHub Copilot, Aider e Amazon Q Developer (já suportados
  no installer).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

v1.2.19: pausa preventiva entre etapas

v1.2.18: organização das specs por feature folders

feat: adiciona agents-help e reconstructor como padrão na instalação …

…(v1.2.12)

- reversa-agents-help adicionado aos opcionais com checked: true
- reversa-reconstructor corrigido de checked: false para checked: true
- atualiza nav do mkdocs.yml com traduções pt/es e página agents-help

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>