chore(upstream): sincronizar correções do upstream (v1.18.33) — avaliação de impacto e critérios #250

1. Contexto e Objetivo

Foi realizada a revisão detalhada do repositório upstream oficial (anomalyco/opencode na branch dev, versão v1.18.33, commit 725e4ba4b8) em comparação com o nosso fork (alltomatos/opencode).

O objetivo desta issue é definir a avaliação de impacto, os critérios de adoção e o plano de importação das alterações upstream, preservando a integridade das customizações do nosso fork (tais como OmniRoute/Combos, Media Studio, AGY Auth/Token Auto-refresh, MCP Mail, agendador de rotinas e Desktop Platform Bridge).

2. Critérios de Adoção para o Fork

3. Avaliação de Impacto das Modificações

🔒 Segurança & Observabilidade

• Redação de Credenciais em Debug (fix(opencode): #50956)
  • Arquivo: packages/opencode/src/cli/cmd/debug/redact.ts, packages/opencode/src/cli/cmd/debug/config.ts
  • Impacto no Fork: Positivo Alto. Impede que chaves de API e segredos sejam expostos em texto claro em saídas de log e comandos de diagnóstico. Risco de regressão zero.

🛠️ Core e Resolução de Sistema

• Quebra de Dependência Cíclica no Filesystem (fix(core): #50439)
  • Arquivo: packages/core/src/filesystem/search.ts
  • Impacto no Fork: Positivo Alto. Elimina warnings e potenciais erros de inicialização durante o bundling de dependências do core.
• Resolução de Entrypoint npm no Node (fix(core): #50413)
  • Arquivo: packages/core/src/npm.ts
  • Impacto no Fork: Positivo Médio. Melhora a resolução de plugins e dependências externas instaladas localmente.
• Abridor de Browser Unificado (refactor(core): #51414)
  • Arquivo: packages/core/src/open.ts
  • Impacto no Fork: Positivo Médio. Padroniza chamadas de abertura de links entre CLI, TUI e MCP.

🤖 Provedores LLM, MCP e Ferramentas

• Falhas de Inicialização de Browser MCP (fix(opencode): #51538)
  • Arquivo: packages/opencode/src/mcp/browser.ts
  • Impacto no Fork: Positivo Alto. Trata graciosamente o encerramento inesperado do processo do browser em vez de lançar exceções não tratadas no servidor.
• Timeouts no Cloudflare AI Gateway (fix(opencode): #51549)
  • Arquivo: packages/opencode/src/provider/provider.ts
  • Impacto no Fork: Positivo Médio / Risco Médio. Garante que timeouts configurados sejam aplicados em requisições gateway. Requer atenção no merge com o roteamento de Combos do fork.
• Ajuste na Lógica de Thinking do Gemini (fix(gemini): #50841)
  • Arquivo: packages/opencode/src/provider/transform.ts
  • Impacto no Fork: Positivo Médio / Risco Médio. Corrige comportamentos padrão do modo thinking. Requer validação junto às sanitizações de esquemas JSON que implementamos para o Gemini.
• Modelos GPT-6 com Codex (feat(openai): #50704)
  • Arquivo: packages/opencode/src/plugin/openai/codex.ts
  • Impacto no Fork: Positivo Baixo. Permite uso de novos identificadores no plugin Codex.
• Reporte de Uso de Tokens Together AI (fix(opencode): #50264)
  • Arquivo: packages/opencode/src/provider/provider.ts
  • Impacto no Fork: Positivo Baixo. Melhora a precisão métrica de streaming.

4. Matriz de Conflitos e Riscos com o Fork

5. Próximos Passos (Plano de Execução)

1. Criar branch de trabalho (ex.: sync-upstream-v1-18-33).
2. Portar modificações de segurança (redact.ts) e core (search.ts, npm.ts, open.ts).
3. Portar correções de MCP browser e provedores (transform.ts, provider.ts).
4. Executar suíte de validação:
   • bun typecheck em packages/core e packages/opencode
   • bun test em packages/core e packages/opencode
5. Submeter PR para a branch dev do fork.