aamf

AAMF (Autonomous Agent Migration Framework) é uma ferramenta open-source em TypeScript/Node.js para traduzir bases de código legadas para outra linguagem ou framework. Ela é projetada como um pipeline de migração determinístico e retomável, em vez de um gerador de código de uma única vez. O README descreve um fluxo de trabalho em nove fases: indexação da base de código fonte, derivação de um grafo de tarefas ordenado por dependência, construção de uma base de conhecimento, planejamento e adjudicação da estratégia de migração, migração iterativa de tarefas, verificação de paridade final, produção de testes E2E e documentação, refatoração opcional para idiomas da linguagem de destino e emissão de relatórios de conclusão. A abordagem central usa um grafo de símbolos e chamadas estilo Lore para decompor o código fonte em tarefas de migração delimitadas. Componentes fortemente conectados são contraídos para que o código mutuamente dependente permaneça em uma unidade, clusters vizinhos são mesclados dentro de limites de tamanho e regiões cíclicas superdimensionadas são divididas em partes gerenciáveis. O grafo de tarefas resultante é determinístico, o que suporta repetições, reexecuções parciais e comportamento de retomada previsível. Os modos de execução incluem validação por tarefa, sincronização de barreira de onda e checkpoints de época de sincronização, permitindo que o repositório de destino permaneça construível e testável durante a migração. AAMF coordena um catálogo de agentes de IA especializados por meio do framework de orquestração CADRE. Os agentes incluem um construtor de conhecimento, planejador de migração, adjudicador, migrador de código, verificador de paridade, escritor de testes, resolvedor de falhas de paridade, verificador de paridade final, criador de testes E2E, escritor de documentação e agentes de refatoração idiomática. O runtime suporta backends de agentes como Copilot e Claude Code, injeta instruções de cenário, gerencia o acesso à base de conhecimento via MCP e registra métricas de invocação, incluindo tempo, uso de tokens, estimativas de custo e nível de roteamento. O framework enfatiza resiliência e observabilidade. Checkpoints são escritos após a conclusão de fases e tarefas, permitindo que migrações interrompidas sejam retomadas a partir de cursores salvos. O trabalho de agente com falha é repetido, erros de infraestrutura são tratados separadamente e falhas não resolvidas podem ser roteadas para um resolvedor de falhas de paridade. Orçamentos de tokens, estimativa de custos, logs de invocação JSONL e resumos agregados fornecem visibilidade operacional. O README também observa um exemplo de projeto portado: uma biblioteca de compressão lz4 traduzida de C para Rust.