O Maguyva oferece suporte a TypeScript com parsing de AST e extração de símbolos, permitindo que agentes de IA rastreiem interfaces, implementações, pacotes compartilhados e código de aplicação rico em JSX em monorepos.
TypeScript é a linguagem em que muitas equipes esperam que a refatoração assistida por IA finalmente pareça segura. O sistema de tipos ajuda, mas não elimina o problema real: pacotes compartilhados, DTOs, clients gerados, componentes React, testes e código de aplicação, todos puxando os mesmos nomes em um repositório grande.
Para TypeScript, o padrão é mais alto do que “entende a sintaxe”. O agente precisa seguir o contrato da definição até a implementação e até o raio de impacto antes de editar um tipo, hook ou client compartilhado.
O Maguyva extrai classes, métodos, interfaces e type aliases em .ts, .mts, .cts e nas variantes comuns de arquivo TypeScript relacionadas a testes e stories. Prefixos de membro são normalizados, mas identificadores qualificados por classe são preservados, o que ajuda quando um repositório tem tanto um nome de helper isolado quanto um método com escopo de classe com o mesmo segmento final.
JSX é tratado como um sinal estrutural real, e não como marcação avulsa, e as expectativas de símbolo ignoram explicitamente boa parte dos caminhos de teste, story e configuração. Isso importa em monorepos porque, do contrário, o agente gastaria tempo demais redescobrindo scaffolding em vez da superfície de implementação real.
Três padrões iniciais geralmente bastam:
find_symbol quando você já souber o nome da interface, type alias, hook ou service.dependency_search antes de mudar tipos ou clients compartilhados que podem se ramificar por vários pacotes.structural_search quando você precisar de um formato de código, não de uma correspondência de palavra-chave, por exemplo, padrões repetidos de componente ou método.Para perguntas conceituais como “seguir o caminho de envio do checkout”, get_task_context costuma ser um primeiro salto melhor do que uma busca bruta.
Esta página é mais forte para monorepos web e de plataforma em que TypeScript é a camada de coordenação de vários pacotes. Se o seu repositório ainda inclui bastante JS mais antigo, leia o guia de JavaScript. Se a sua pergunta é realmente “o agente consegue manter juntos o código de aplicação e o contexto de infraestrutura?”, combine isso com Terraform.
Melhor encaixe
Fluxos de trabalho de agente
Detalhes do engine
Pontos de entrada MCP úteis
find_symbol
Comece por aqui quando souber a interface compartilhada, alias de tipo, hook ou serviço que quer inspecionar.
dependency_search
Use antes de alterar um DTO ou client compartilhado para ter um raio de impacto realista entre pacotes.
structural_search
Use busca no nível de AST quando precisar de um padrão, não de uma correspondência de string, por exemplo formas repetidas de componente ou método.
Guias relacionados
Útil quando um repositório mistura CommonJS, ESM, scripts de tarefas, testes e código de aplicação mais antigo.
Extensões
.cjs, .js, .mjs, .spec.js, +2 mais
Útil quando o código de infraestrutura faz parte do contexto do repositório e não é algo que o agente deveria simplesmente ignorar.
Extensões
.tf, .tfvars