CASE DE EVIDÊNCIA
Remoção de um SDK Cosmic obsoleto com análise de codebase orientada por evidências
Uma manutenção real no Rocket usou o pack completo de Codebase Intelligence para separar a ownership atual do runtime Payload da compatibilidade histórica com Cosmic e remover com segurança um único caminho legado de escrita.
01
Problema
Determinar se referências a Cosmic ainda representavam uma dependência viva do runtime público após o cutover para Payload e remover apenas o que as evidências do repositório comprovassem obsoleto, sem quebrar migração, fallbacks locais, banco ou UI.
02
Métodos aplicados
- 01Mapeamento de Estrutura de Codebase ExistenteSubstitui suposições arquiteturais por um mapa estrutural delimitado cujas afirmações apontam para evidências concretas em código e configuração.
- 02Investigação Semântica de CodebaseLocaliza o código responsável por um comportamento sem exigir conhecimento prévio de símbolos, nomes de arquivos ou vocabulário do repositório.
- 03Rastreamento de Caminhos de ExecuçãoTorna o fluxo relevante em runtime revisável sem tratar alcançabilidade, correlação ou correspondências textuais como comportamento comprovado.
- 04Análise de Blast Radius de MudançaExpõe risco sustentado por evidências e impacto não resolvido antes da escolha de fatias de implementação ou estratégia de proteção.
- 05Planejamento de Mudanças em Codebase com EvidênciasEntrega a arquitetura, planejamento de engenharia, testes ou debugging um handoff rastreável e sustentado pela codebase antes do desenho do trabalho executável.
Registro de decisões
- 01
Mapear ownership antes de apagar referências legadas
Rastrear Home e Publications pelo Payload e seus fallbacks locais antes de tratar todos os resultados de busca por Cosmic como uma única superfície de dependência.
- 02
Separar compatibilidade de dependência de pacote
Preservar a migração histórica porque ela lê Cosmic com fetch nativo e rejeitar hits de migração e configuração de CDN como prova de que o SDK depreciado ainda era necessário.
- 03
Limitar o blast radius ao writer observado
Remover apenas a dependência cosmicjs, o script npm populate, o writer legado e os registros derivados do lockfile, mantendo loaders, semântica de migração, schema, banco e código visual intactos.
- 04
Provar a fronteira com CI RED→GREEN
Começar com um contrato de regressão que falha com o SDK existente, regenerar o lockfile pelo npm e aceitar o cleanup apenas depois do pipeline canônico do Rocket passar no HEAD final de evidência.
03
Verificação
Trate este relatório como evidência dos métodos e da verificação mostrados aqui. A sobreposição com um pack, sozinha, não prova que o pack foi usado ou validado por completo.
04
Resultado
- 01
O SDK cosmicjs depreciado e o caminho legado de escrita/população do Cosmic foram removidos.
- 02
A migração histórica Cosmic→Payload permanece disponível por fetch nativo.
- 03
Home e Publications públicos continuam Payload-first com seus fallbacks locais preservados.
- 04
O CI final do Rocket passou instalação, drift de tipos do Payload, suíte completa de testes, lint, typecheck e build de produção.
- 05
Os cinco métodos de Codebase Intelligence contribuíram para a decisão, fronteira de blast radius, plano de implementação ou evidência de verificação.