Release do Paperclip · 16 de julho de 2026

Paperclip canary/v2026.716.0-canary.8

Detalhamento editorial da versão, com mudanças publicadas e referência oficial para consulta técnica.

Paperclip canary/v2026.716.0-canary.8

Resumo

O Paperclip canary/v2026.716.0-canary.8 reúne nove publicações canary com mudanças no reinício do servidor, na observação de recuperações, nas rotas com prefixo e no adaptador local do Codex. A série preserva processos ativos durante reinícios controlados e evita encerrar verificações que ainda produzem saída.

Novidades

  • Paperclip canary/v2026.716.0-canary.8 — Reinício controlado: scripts/request-hot-restart.ts grava um marcador de uso único sob PAPERCLIP_HOME, permitindo que o novo servidor adote processos locais ainda ativos.
  • Paperclip canary/v2026.716.0-canary.8 — Relatório de recuperação: GET /companies/:companyId/recovery-observability apresenta taxas semanais, causas, alertas por limite e o destino das ações de recuperação.
  • Paperclip canary/v2026.716.0-canary.8 — Prova de versão: o endpoint de saúde inclui serverVersion junto do campo version já existente.

Melhorias

  • Paperclip canary/v2026.716.0-canary.8 — Adoção de processos: o servidor registra processos adotados, finalizados ou perdidos em hot-restart-report.json e preserva o estado dos processos aceitos após a inicialização.
  • Paperclip canary/v2026.716.0-canary.8 — Diagnóstico do Codex: o monitor registra a quantidade de trechos e bytes recebidos, além dos eventos JSONL interpretados.
  • Paperclip canary/v2026.716.0-canary.8 — Janela de recuperação: consultas do relatório ficam limitadas a 104 semanas para evitar alocação excessiva.

Correções

  • Paperclip canary/v2026.716.0-canary.8 — Rotas com prefixo: Export, Import, Org Chart e Cloud Upstream preservam o prefixo da empresa, inclusive na visualização de arquivos exportados.
  • Paperclip canary/v2026.716.0-canary.8 — Watchdog do Codex: qualquer saída não vazia em stdout ou stderr renova o monitor de inatividade, mesmo quando o texto não forma um evento JSONL.
  • Paperclip canary/v2026.716.0-canary.8 — Estado após reinício: processos locais adotados deixam de ser classificados como process_lost durante a limpeza de execuções órfãs.

Breaking changes

A origem pública não declara quebra de compatibilidade. O reinício controlado depende de metadados de PID e PGID, além de um gerenciador de serviço que mantenha os processos filhos ativos durante a troca do servidor.

Ponto de Atenção

  • Paperclip canary/v2026.716.0-canary.8 — Marcador de reinício: um PID incorreto aciona a drenagem normal em vez da adoção de processos.
  • Paperclip canary/v2026.716.0-canary.8 — Relatório histórico: a classificação pode mudar quando a atribuição atual da issue diverge do estado observado no período original.
  • Paperclip canary/v2026.716.0-canary.8 — Teste sugerido: inicie um processo local longo, grave o marcador, reinicie paperclip.service e confira hot-restart-report.json, o endpoint de saúde e a continuidade da execução.

Notas da versão

  • Paperclip canary/v2026.716.0-canary.8 — Verificações publicadas: a origem informa cem testes para recuperação de processos, dez testes para o relatório e testes específicos de rotas e inatividade do adaptador Codex.
  • Paperclip canary/v2026.716.0-canary.8 — Série mesclada: a captura reúne canary.0 até canary.8, todas publicadas em 16 de julho.
Voltar para o changelog do Paperclip

Área pública disponível

Participe da comunidade no Discord

Entre pelo convite oficial, apresente-se à comunidade e acompanhe os avisos e projetos compartilhados entre os encontros.