23 de novembro de 2026 - 6 min de leitura

Faça do Sentinel o seu: um fork e o seu agente conectado

Seus protocolos, sua marca, suas páginas: como um fork do Sentinel incorpora tudo isso e continua recebendo cada versão, com uma rede GNSS como caso extremo.

Faça do Sentinel o seu: um fork e o seu agente conectado

Toda ferramenta de monitoramento tem uma tela de configurações, e toda tela de configurações é o palpite de outra pessoa sobre o que você vai precisar. Engenheiros de DevOps passam desses palpites rápido. Os serviços que eles operam falam protocolos que nenhum fornecedor entrega, suas páginas de status vão para pessoas que esperam ver a marca delas, e às vezes a página que eles realmente querem é um mapa.

O Sentinel segue outro caminho. Ele quase não tem configurações, de propósito. Quando você precisa de algo que ele não faz, você faz um fork e deixa com a sua cara, e o fork continua recebendo cada versão que lançamos. Sinceramente, hoje em dia não gosto de personalizar as coisas em telas de configuração. É muito melhor conectar seu agente ao repositório e deixar do seu jeito.

Para quem é

Um engenheiro de DevOps, ou um time de plataforma inteiro, com seus próprios protocolos, sua própria marca, sua própria ideia do que uma página de status deve mostrar. Ou alguém que gosta do Sentinel como ele é, mas quer algumas verificações do seu jeito: um caster que só responde com o handshake certo, um catálogo que precisa listar as cenas de hoje, uma fonte de dados com formato próprio.

A versão da semana passada fez do Sentinel algo que você pode enviar a quem depende de você. Este texto é sobre fazer dele algo que só você poderia ter construído, sem manter um produto à parte.

Por que um fork, e por que agora

Fork costumava ser a opção cara. Você copiava uma base de código, mudava em cem lugares, e cada nova versão do original virava uma semana de merge. Configurações existiam justamente para você não precisar fazer isso.

Duas coisas mudaram. Agentes de programação agora leem um repositório, seguem suas regras e fazem uma mudança coerente em uma tarde. E o Sentinel foi reconstruído para que um fork mude valores e adicione arquivos, em vez de editar código compartilhado. Juntas, essas duas coisas tornam o fork a opção barata: você descreve o que quer, o agente escreve no lugar certo, e a próxima versão continua entrando sem conflito.

O que um fork muda, e o que ele deixa em paz

A regra é simples: adicione arquivos, mude valores e mexa o mínimo possível nos arquivos compartilhados. Cada linha alterada num arquivo do original é uma linha que pode dar conflito no próximo merge. O Sentinel dá a um fork lugares próprios para todo o resto.

  • Sua aparência. Cores, fontes e espaçamentos ficam num único arquivo de tokens. Mude os valores e todas as páginas acompanham, no claro e no escuro. O significado dos estados continua o mesmo, então quem lê sua página ainda sabe que um quadrado é Outage.
  • Suas verificações. Um protocolo seu vira um novo membro do kit ctx que os testes usam, ao lado de ctx.http e ctx.s3. Ele recebe o sinal de cancelamento da execução, para parar quando ela estoura o tempo, e o logger da execução; não pode substituir um membro nativo.
  • Suas rotas, ferramentas e rotinas. Um arquivo, apps/api/src/fork/extension.ts, declara o que o fork adiciona: rotas de API (as públicas em /status/), ferramentas MCP e os parágrafos que os agentes leem sobre elas, e rotinas em segundo plano. O original vem com ele vazio e nunca o edita.
  • Sua página. apps/web/fork/status-lead.tsx aparece acima da lista de verificações na página de status pública. O original não mostra nada ali; um fork coloca ali seu mapa, seu banner ou seu resumo.
  • Seus dados e suas tabelas. Arquivos de dados ficam em apps/api/data/, que as duas imagens copiam. Migrações de banco num fork são numeradas de 900 a 999, então as do original nunca colidem com as suas.
// apps/api/src/fork/extension.ts num fork
export const fork: ForkExtension = {
  routes: stationRoutes,                 // GET /status/stations/map, ...
  ctx: (run) => ({ ntrip: ntripFor(run) }), // ctx.ntrip em todo teste
  mcpTools: stationTools,                // o que os agentes podem fazer com as estações
  mcpInstructions: ['Esta instância monitora ...'],
  start: startStationSync,
  stop: stopStationSync,
}

Conecte seu agente

O repositório é escrito primeiro para agentes. O guia de contribuição é um briefing que o agente lê antes de mexer em qualquer coisa: os limites (ele roda em 1 GB de RAM), as dependências proibidas, como escrever uma verificação, onde um fork coloca cada coisa. O guia de fork diz qual arquivo guarda o quê. Um agente a quem você pede "uma verificação de que nosso caster lista todas as estações" sabe onde vai o protocolo, onde vai o teste e o que dizer aos outros agentes sobre ele.

O mesmo vale para operar o resultado. Tudo o que um fork adiciona via MCP aparece na visão que o agente tem da instância, ao lado de tudo o que o original faz. Seu agente aprende o seu protocolo no momento em que ele entra no ar.

Continuar atualizado

Um fork que não recebe atualizações é um beco sem saída. O workflow de release do Sentinel só publica a partir do repositório principal, então num fork ele apenas roda os testes, e o fork gera sua própria imagem com seu próprio workflow. Para atualizar, faça o merge da versão que você quer. O exemplo abaixo traz um workflow Sync upstream que faz isso com um clique: ele incorpora a versão escolhida, roda a checagem de tipos e os testes, e abre um pull request dizendo se passaram. Quando há conflito, normalmente é só nos arquivos de dependências.

O caso extremo: uma rede GNSS nacional

O fork mais extremo que conhecemos monitora as estações em tempo real da RBMC, a rede brasileira de estações de referência GNSS, pelo seu caster NTRIP público. Ele adiciona um protocolo, ctx.ntrip.sourcetable(), que lê a lista de fluxos ativos do caster com um cache compartilhado de um minuto, então 157 verificações de estação custam ao caster uma requisição por minuto. Ele mantém exatamente uma verificação por estação lendo o shapefile oficial de estações da rede, adotando verificações existentes e pausando as de estações desativadas. E abre sua página de status pública com um mapa das estações.

A página de status pública do fork das estações, aberta por um mapa das 157 estações de referência GNSS

Tudo isso vive nos arquivos do próprio fork. Quando lançamos a versão 1.32.0, o fork a incorporou com um merge simples. O que esse mapa mostra agora para os agrimensores fica para a semana que vem.

Seu monitor, do seu jeito

O Sentinel é open source sob a AGPL v3 em github.com/territorial-dev/sentinel, e o fork das estações é público em github.com/paschendale/sentinel-rbmc como exemplo funcionando. Faça seu fork em aberto, use uma licença comercial para manter seu fork fechado, ou peça para a gente construir e operar com você.

O motor de verificações é o mesmo para todo mundo. O que você verifica, como aparece e para onde vai é seu.

Continue lendo