Remogram 0.1.0-beta.5: agentes de forja que realmente podem usar
Dê aos agentes o mesmo pequeno conjunto de fatos confiáveis sobre o forge em cada host, para que eles gastem tokens no trabalho em vez de se recuperar de suposições erradas.
Agentes que trabalham em repositórios reais enfrentam a mesma barreira repetidamente. CLIs do forge despejam enormes JSON. O texto da interface web não é seguro para máquinas. "Basta executar gh" falha assim que você muda para Gitea ou GitLab. Os humanos sentem isso como resumos errados e bloqueios perdidos. Os agentes sentem isso como instruções conflitantes e prontidão de mesclagem inventada.
Remogram 0.1.0-beta.5 é construído em torno de um trabalho simples: dê a um agente o mesmo pequeno conjunto de fatos confiáveis, toda vez, em qualquer forge suportado, para que ele possa decidir o que fazer a seguir sem improvisar a partir de prosa.
Remogram foi desenvolvido por e para Topogram. Você não precisa do Topogram para usá-lo. Instale: github.com/attebury/remogram.
npm install -g @remogram/cli@beta @remogram/mcp@beta
O problema que estávamos resolvendo
Um agente revisando ou implementando uma mudança geralmente precisa de respostas como:
- Quem sou eu neste forge, e este token pode escrever?
- Quais regras de branch se aplicam?
- Quais arquivos este PR realmente tocou?
- O que os revisores disseram, como dados em vez de HTML?
- O que mudou no forge desde a última vez que olhamos?
- As verificações são reais, estão faltando ou falharam? A planejamento de mesclagem está bloqueada por razões que a limpeza do git esconde?
- Se eu precisar postar um status ou abrir um PR, posso fazê-lo através do mesmo modelo de pacote que uso para ler?
Antes da beta.5, o Remogram ajudava com o estado do PR e verificações. Após a beta.5, essas perguntas têm comandos de primeira classe com o mesmo envelope no Gitea, GitHub e GitLab, tanto na CLI quanto no MCP.
O que ficou mais fácil para os agentes (e os humanos por trás deles)
Menos adivinhações sobre identidade e permissões
whoami responde "quem é este token?" e "o forge acha que posso escrever?" em um pacote. Os agentes param de inferir autenticação a partir de mensagens de erro durante a tarefa.
branch protection responde "quais contextos ou regras importam para este branch?" sem precisar raspar páginas de configurações.
Benefício: menos cadeias de ferramentas sem saída e menos loops de "tente mesclar e veja o que acontece".
Revisão com evidências, não sensações
cr files retorna caminhos alterados do forge (limitados, truncados honestamente), para que um agente saiba o que o PR toca, não o que um branch local contém.
cr comments retorna threads de revisão como registros estruturados. Títulos e corpos permanecem semânticamente não confiáveis; campos de envelope e enums são o que você controla.
Benefício: classificações de revisão se vinculam ao que mudou e o que foi dito, não a uma paráfrase do título do PR.
Memória do forge desde o último tick
forge changes --since … fornece uma fatia de eventos de ciclo de vida com limite de tempo: aberturas, fechamentos, mesclagens, movimentos de cabeça, conclusões de verificação observadas.
Benefício: roteamento estilo observador e "o que aconteceu enquanto eu estava implementando?" param de depender do histórico de chat ou da narrativa manual de git fetch.
Agentes de prontidão para mesclagem podem falhar fechados
merge plan já expôs bloqueadores além de mergeability: clean. A beta.5 vincula isso ao cr files: passe --allowed-path globs e obtenha path_scope_violation ou changed_paths_unavailable como bloqueadores normalizados, não a memória do autor da habilidade sobre o layout do repositório.
Benefício: revisão/mesclagem autônoma pode parar no escopo da mesma forma que para em verificações falhadas, com um campo em JSON em vez de um ensaio.
Escritas que se comportam como leituras
Os agentes não devem fazer uma distinção especial entre "comandos de leitura" e "de repente usar curl".
-
cr open(Gitea, opt-in) abre ou reutiliza uma solicitação de mudança;reused_existingquando o forge já tem uma. -
status set(todos os três provedores de API, opt-in) publica status de commit com a mesma disciplina de idempotência: limites de varredura,idempotency_scan_incompletequando a prova é impossível,reused_existingquando nada novo é necessário.
Ambos requerem write_commands explícitos em .remogram.json. Caso contrário, você recebe write_not_configured: use forge/CI em seu sistema. pr checks ainda informa o que foi incluído.
Benefício: os agentes obtêm um contrato único para "tentei agir no forge" em vez de um pacote para leituras e um mundo de shell separado e não documentado para gravações.
Segurança que respeita como os agentes copiam a saída
Tokens ghs_ do GitHub são redigidos em caminhos de normalização para que blobs do forge não se tornem segredos acidentais em logs ou no próximo prompt.
Benefício: menos risco de um agente tratar a saída da ferramenta como segura para repetir.
Uma superfície, não uma caça ao tesouro
A beta.5 completa um conjunto de ferramentas coerente para agentes:
