Capacidades que rodam no seu computador

São 5 ferramentas do kit. Cada uma tem teste e roda na sua máquina. Abra um cartão para ver o que ela é, por que está no kit (com a medição) e casos de uso com o comando e a prova. O catálogo do que o EGOS já faz está em /federacao/; as ferramentas gratuitas do conector, em /ferramentas/.

filaUma caixa de entrada em disco para cada agente: uma sessão posta um pedido, outra pega e devolve o resultado, sem servidor nenhum.

O que é

Uma caixa de entrada em disco para cada agente: uma sessão posta um pedido, outra pega e devolve o resultado, sem servidor nenhum.

sugerir melhoria

Por que está no kit

É o coração do kit: sem a fila, as outras quatro não têm o que ler, vigiar ou contar. No EGOS ela liga as sessões de IA, o painel e o WhatsApp entre si, e é a ferramenta mais usada das cinco.

  • referências no código do EGOS: 108
  • alarme em produção: o timer egos-fila-sem-leitor está ativo e avisa quando há pedido na fila e ninguém lendo
  • testes: 21 golden tests passando

Medido em 17/10/2026. Contagem de referências ao nome do arquivo no código do EGOS (o núcleo privado onde estes motores nascem e rodam). Referência é menção no código, não é número de execuções. Quem baixa o kit não consegue repetir essa contagem; o que qualquer um repete é o teste de cada ferramenta.

sugerir melhoria

Casos de uso

1. Passar uma tarefa de uma sessão para outra

Você tem uma sessão coordenando e outra que só implementa. A coordenadora precisa entregar um pedido à forja sem copiar e colar.

bun kit/scripts/fila.ts postar forja "ajustar o botao da tela inicial" --corpo "trocar a cor" --de coordenadora

O pedido vira um arquivo JSON na pasta pendentes da forja e o comando mostra o caminho.

Prova: Teste g1 (postar e listar) de fila.test.sh. A saída acima é real, de uma execução em 17/10/2026 numa pasta temporária.

sugerir melhoria
2. Duas sessões disputam o mesmo pedido

Duas janelas estão escutando a forja ao mesmo tempo. Só uma pode ficar com o pedido.

bun kit/scripts/fila.ts pegar forja --sessao a1b2c3d4
bun kit/scripts/fila.ts pegar forja --sessao e5f6a7b8

A primeira recebe o pedido completo e ele passa para em-andamento com o nome da sessão. A segunda recebe a palavra "vazio".

Prova: Teste g3: 20 rodadas de disputa simultânea, exatamente 1 vencedor em 20 de 20.

sugerir melhoria
3. Entregar o resultado e conferir quem está de pé

A forja terminou. Ela devolve o resultado e você quer saber se alguém ainda está escutando a fila.

bun kit/scripts/fila.ts concluir <caminho-do-pedido> --resultado "botao trocado, teste passou"
bun kit/scripts/fila.ts estado

O pedido vai para concluídos com o resultado gravado. O estado resume a fila e acusa quando ninguém está escutando.

Prova: Testes g4 (concluir move e grava o resultado) e g7b (escuta que morreu aparece como órfã ou sem escuta). Saída real de 17/10/2026.

sugerir melhoria
4. Achar o pedido que ninguém terminou

Uma sessão pegou um pedido e sumiu. Horas depois ninguém sabe que ele está parado.

bun kit/scripts/fila.ts estado

Pedido em andamento há mais de 30 minutos (o teto pode ser mudado em EGOS_FILA_TETO_MIN) aparece como ÓRFÃO-SUSPEITO na linha do agente. Dentro do teto, não há alarme falso.

Prova: Testes g9a (acima do teto grita) e g9b (dentro do teto não grita).

sugerir melhoria

Pergunte ao EGOS

Leve a pergunta para a IA que você já usa. O texto vai na própria página que ela abre, sem passar por servidor nosso.

Perguntar no Claude Perguntar no ChatGPT

Código: scripts/fila.ts

orquestra-vivaO motor que lê a fila ao vivo e a serve em uma porta local; a tela que o acompanha foi aposentada no EGOS.

O que é

O motor que lê a fila ao vivo e a serve em uma porta local; a tela que o acompanha foi aposentada no EGOS.

sugerir melhoria

Por que está no kit

O motor segue sendo a ponte entre a fila em disco e qualquer tela que queira mostrá-la. A tela dele deixou de ser o painel do EGOS em 07/10/2026: o painel do EGOS hoje é o EGOS App v2, que lê o mesmo estado. Fica no kit porque o motor é reaproveitável; não o apresente como o painel.

  • referências no código do EGOS: 54
  • situação da tela: aposentada em 07/10/2026; o painel do EGOS é o EGOS App v2
  • testes: 6 golden tests passando

Medido em 17/10/2026. Contagem de referências ao nome do arquivo no código do EGOS (o núcleo privado onde estes motores nascem e rodam). Referência é menção no código, não é número de execuções. Quem baixa o kit não consegue repetir essa contagem; o que qualquer um repete é o teste de cada ferramenta.

sugerir melhoria

Casos de uso

1. Ver o estado da fila no navegador

Você quer olhar o que está pendente e quem está escutando sem digitar comando.

bash kit/scripts/orquestra-viva.sh

Sobe o motor em http://127.0.0.1:4599 (e tenta abrir a janela com o Chrome; sem Chrome, abra o endereço à mão). O caminho /estado devolve a fila em JSON.

Prova: Teste g1: /estado lista o pedido pendente com o título correto. Teste g6: se a fila não existe, /estado responde sem erro 500.

sugerir melhoria
2. Saber se a escuta de um agente está viva

Um agente parece parado. Você quer saber se o processo que escuta ainda existe.

curl http://127.0.0.1:4599/estado

Cada agente vem com o estado da escuta: viva quando o processo existe, órfã quando a presença ficou para trás.

Prova: Teste g2 (escuta viva com o pid do próprio shell) e g3 (presença com pid morto vira órfã).

sugerir melhoria
3. Mandar um PING a um agente

Você quer cutucar a forja para ver se ela responde.

curl -X POST http://127.0.0.1:4599/comando -H 'content-type: application/json' -d '{"acao":"ping","agente":"forja"}'

Um pedido "PING" cai na pasta pendentes da forja. Se o agente não existe, a resposta é 400 e nenhum arquivo é criado.

Prova: Teste g4 (o PING cria o pedido em pendentes) e g5 (agente inexistente: 400 e zero arquivo criado).

sugerir melhoria

Pergunte ao EGOS

Leve a pergunta para a IA que você já usa. O texto vai na própria página que ela abre, sem passar por servidor nosso.

Perguntar no Claude Perguntar no ChatGPT

Código: scripts/orquestra-viva.ts · scripts/orquestra-viva.html · scripts/orquestra-viva.sh

vigia-ambienteUm vigia que dorme, acorda de tempos em tempos, compara o ambiente e só avisa quando algo de fato mudou.

O que é

Um vigia que dorme, acorda de tempos em tempos, compara o ambiente e só avisa quando algo de fato mudou.

sugerir melhoria

Por que está no kit

Uma sessão de IA só enxerga o que busca quando um turno roda: ela não tem ouvido. O vigia é o ouvido, e foi escrito depois de dois alarmes falsos reais (um arquivo re-escrito igual e um carimbo de hora que muda a cada rodada). É a ferramenta menos referenciada das cinco: o uso é pequeno e foi mexida hoje.

  • referências no código do EGOS: 2 (mexida no dia da medição)
  • testes: 7 golden tests passando

Medido em 17/10/2026. Contagem de referências ao nome do arquivo no código do EGOS (o núcleo privado onde estes motores nascem e rodam). Referência é menção no código, não é número de execuções. Quem baixa o kit não consegue repetir essa contagem; o que qualquer um repete é o teste de cada ferramenta.

sugerir melhoria

Casos de uso

1. Ser acordada quando um arquivo muda

Você deixa o ambiente aberto e quer que a sessão só volte a trabalhar quando um arquivo importante mudar.

EGOS_VIGIA_FILES=/caminho/do/arquivo.txt EGOS_VIGIA_INTERVALO=1 EGOS_VIGIA_CICLOS=3 bash kit/scripts/vigia-ambiente.sh

O vigia arma, dorme, e ao ver o hash novo imprime a diferença e termina.

Prova: Teste g1 (arquivo vigiado mudou: detecta). Saída real de 17/10/2026, com o caminho trocado por arquivo.txt.

sugerir melhoria
2. Não acordar por reflexo

Um programa regrava o próprio arquivo de estado a cada minuto com o mesmo conteúdo. Não é novidade e não deve acordar ninguém.

bash kit/scripts/vigia-ambiente.sh

Regravar com conteúdo idêntico, ou mudar só o carimbo de hora do sentinela, passa em silêncio. Sem mudança, o vigia expira dizendo que expirou.

Prova: Testes g7 (regravação idêntica: silêncio), g2 (carimbo do sentinela: silêncio) e g5 (nada mudou: expira dito).

sugerir melhoria
3. Perceber um commit novo ou um arquivo que apareceu

Outra janela commitou, ou um arquivo esperado finalmente chegou.

bash kit/scripts/vigia-ambiente.sh

O avanço do HEAD do git conta como mudança. Um arquivo que estava AUSENTE e passa a existir também.

Prova: Testes g6 (HEAD avançou: detecta) e g4 (AUSENTE e depois existe: detecta). O veredito do sentinela mudando de no-ar para caído também (g3).

sugerir melhoria

Pergunte ao EGOS

Leve a pergunta para a IA que você já usa. O texto vai na própria página que ela abre, sem passar por servidor nosso.

Perguntar no Claude Perguntar no ChatGPT

Código: scripts/vigia-ambiente.sh

orquestra-entrarA porta única de entrada de uma sessão nova: ela diz qual papel vai exercer e recebe o resumo certo para esse papel.

O que é

A porta única de entrada de uma sessão nova: ela diz qual papel vai exercer e recebe o resumo certo para esse papel.

sugerir melhoria

Por que está no kit

Num teste de 30/08/2026 a mesma janela virou novata e forja sem ninguém perceber. Obrigar a escolher o papel na entrada dá a cada sessão um território claro. É um script curto e de uso raro: o último commit dele no EGOS é de 30/08/2026.

  • referências no código do EGOS: 6
  • último commit no EGOS: 30/08/2026
  • testes: 5 golden tests passando

Medido em 17/10/2026. Contagem de referências ao nome do arquivo no código do EGOS (o núcleo privado onde estes motores nascem e rodam). Referência é menção no código, não é número de execuções. Quem baixa o kit não consegue repetir essa contagem; o que qualquer um repete é o teste de cada ferramenta.

sugerir melhoria

Casos de uso

1. Ler o que cada papel faz antes de entrar

Você vai abrir uma sessão de revisão e quer ler o resumo do papel antes, sem criar nada.

bash kit/scripts/orquestra-entrar.sh revisor --so-brief

Imprime o resumo do revisor e termina. Nada é gravado e nenhuma escuta é armada.

Prova: Teste g5 (--so-brief não registra papel). Saída real de 17/10/2026, trecho do resumo.

sugerir melhoria
2. Entrar de verdade e reentrar sem problema

Você abre a janela como forja, trabalha, fecha o turno e volta no turno seguinte.

bash kit/scripts/orquestra-entrar.sh forja

Na primeira vez grava o papel da janela. Entrar de novo no mesmo papel passa direto.

Prova: Testes g1 (entrada limpa grava o papel da janela) e g2 (reentrada no mesmo papel passa).

sugerir melhoria
3. Barrar a janela que tenta virar dois papéis

Uma janela que entrou como forja pede para ser revisora. Sem trava, ela acumularia os dois papéis e ninguém perceberia.

bash kit/scripts/orquestra-entrar.sh revisor

A entrada é recusada com saída 3, a mensagem manda fechar a janela e abrir outra, e a marca do papel anterior fica intacta.

Prova: Teste g3 (troca de papel é barrada: saída 3, marca intacta). Teste g4: marca de janela já fechada é varrida.

sugerir melhoria

Pergunte ao EGOS

Leve a pergunta para a IA que você já usa. O texto vai na própria página que ela abre, sem passar por servidor nosso.

Perguntar no Claude Perguntar no ChatGPT

Código: scripts/orquestra-entrar.sh

cronicaConta em prosa o que a orquestra fez, a partir dos fatos medidos na fila.

O que é

Conta em prosa o que a orquestra fez, a partir dos fatos medidos na fila.

sugerir melhoria

Por que está no kit

Quem trabalha com várias sessões perde o fio do que cada uma entregou. A crônica transforma a fila num relato curto. O teste prova o modo determinístico (FAKE), que é o que aparece abaixo; não prova a qualidade do texto que o modelo real escreve.

  • referências no código do EGOS: 12
  • testes: 15 golden tests passando (todos no modo FAKE ou com o claude simulado)

Medido em 17/10/2026. Contagem de referências ao nome do arquivo no código do EGOS (o núcleo privado onde estes motores nascem e rodam). Referência é menção no código, não é número de execuções. Quem baixa o kit não consegue repetir essa contagem; o que qualquer um repete é o teste de cada ferramenta.

sugerir melhoria

Casos de uso

1. Ver o formato sem gastar nada

Você não tem o Claude Code instalado, ou só quer ver o que a crônica entrega.

EGOS_CRONICA_FAKE=1 bun kit/scripts/cronica.ts gerar

Escreve historia.md com os fatos da fila, sem chamar modelo nenhum. É a mesma saída da imagem do cartão.

Prova: Testes g2 (a história é escrita e cita os agentes) e g2b (historia.json traz os fatos e o tom padrão).

sugerir melhoria
2. Olhar a ficha de fatos antes de narrar

Você quer conferir os números que o modelo vai receber.

bun kit/scripts/cronica.ts coletar

Imprime a ficha em JSON: por agente, pedidos pendentes, em andamento e concluídos, cada um com título, quem pediu, hora e resultado.

Prova: Teste g1: a ficha conta certo (2 agentes, 4 pedidos, latências corretas).

sugerir melhoria
3. Fila vazia ou arquivo estragado

A fila nunca existiu, ou um pedido ficou com o JSON corrompido.

EGOS_CRONICA_FAKE=1 bun kit/scripts/cronica.ts gerar

Fila vazia vira uma história que diz que está vazia, sem inventar. O arquivo corrompido é contado como ilegível e o programa não cai.

Prova: Testes g4a e g4b (fila vazia ou inexistente é dita vazia) e g5 (2 JSON corrompidos contados, sem queda).

sugerir melhoria
4. Escolher o tom da narrativa

Você quer a crônica mais seca, ou mais calorosa.

bun kit/scripts/cronica.ts gerar --tom "seco e objetivo"

O tom passa a valer na hora e fica guardado: a próxima geração sem --tom reaproveita o último. Tom acima de 200 caracteres é recusado.

Prova: Testes g3b (--tom muda o tom guardado), g3c (gerar sem --tom reusa) e g8 (tom acima de 200 caracteres: 400).

sugerir melhoria

Pergunte ao EGOS

Leve a pergunta para a IA que você já usa. O texto vai na própria página que ela abre, sem passar por servidor nosso.

Perguntar no Claude Perguntar no ChatGPT

Código: scripts/cronica.ts

Código, kit completo e o canal de melhoria: github.com/enioxt/cinco. As sugestões viram uma issue pública, então não ponha dado pessoal nelas.