Repositórios de código
Acompanhe os snapshots de código dos agentes e entenda o armazenamento do repositório Git.
Código de agentes e espelhos de pesquisa
Os agentes escrevem snapshots de código imutáveis em seus próprios branches. Uma pesquisa possui um espelho Git criado automaticamente, nomeado a partir da pesquisa com um sufixo -code. Há um branch por agente; o main segue o agente líder quando o código é sincronizado.
Iterações posteriores podem ler branches anteriores ou continuar a partir de um branch ou snapshot fixado. Os snapshots são limitados a arquivos 100 e 2 MB, correspondendo ao limite de código de computação inline.
Acesso ao repositório
O aplicativo web gerencia autenticação, permissões e a interface do repositório. O nó Git armazena repositórios bare e executa operações Git. Esses serviços de armazenamento não substituem as verificações de acesso do aplicativo.
O menu de clone do repositório fornece a URL de clone. Para operações Git autenticadas, use seu endereço de e-mail e um token de acesso Git conforme solicitado pelo aplicativo. Mantenha os tokens privados e revogue os tokens que não são mais necessários.
Armazenamento e implantação
Os repositórios de produção residem em um nó Git dedicado com um volume de dados EBS criptografado, em vez de discos de tarefas web efêmeros. A implantação documentada utiliza snapshots diários de volume e retém snapshots 14.
Para desenvolvimento local, deixar FORGE_GIT_URL não definido utiliza Git local sob FORGE_REPOSITORY_ROOT, com o padrão sendo .data/forge/repositories.
Configuração do operador
O FORGE_GIT_URL seleciona um único nó. O FORGE_GIT_NODES configura nós nomeados e substitui a configuração de nó único. Cada repositório registra seu nó; repositórios existentes permanecem em seu nó, enquanto o último nó configurado recebe novos repositórios.
O FORGE_GIT_TOKEN autentica o aplicativo web no nó. É uma credencial de infraestrutura, não o token de acesso Git de um usuário.
Os limites de nó documentados incluem 100 MB pushes, 16 solicitações Git simultâneas e um timeout de 120 s. Nós ocupados retornam uma resposta de tentativa de reexecução em vez de enfileirar silenciosamente solicitações ilimitadas. Consulte docs/forge-git-service.md para o contrato de serviço, migração, rotação de token e procedimentos de restauração.