Release do Paperclip · 12 de julho de 2026

Paperclip canary/v2026.712.0-canary.0

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

Paperclip canary/v2026.712.0-canary.0

Resumo

O Paperclip canary/v2026.712.0-canary.0 adiciona um controle de atividade às rotinas agendadas, permitindo ignorar execuções quando nenhuma ação externa ocorreu desde o último disparo útil. A mudança preserva o comportamento atual por padrão e registra cada execução ignorada no histórico da rotina.

Novidades

  • Paperclip canary/v2026.712.0-canary.0 — Controle de atividade: as rotinas recebem os campos activity_gate_policy e activity_gate_scope, com os padrões always e company para manter a compatibilidade das configurações existentes.
  • Paperclip canary/v2026.712.0-canary.0 — Avaliação por empresa ou projeto: o predicado evaluateActivityGate() procura ações externas dentro da empresa e também aceita limitação por projeto.
  • Paperclip canary/v2026.712.0-canary.0 — Histórico de execução ignorada: uma rotina sem atividade externa gera uma linha com o motivo no_external_activity e diagnósticos da janela avaliada.

Melhorias

  • Paperclip canary/v2026.712.0-canary.0 — Proveniência de atividade: a avaliação desconsidera execuções da própria rotina, registros administrativos do scheduler e ações que apenas leem informações.
  • Paperclip canary/v2026.712.0-canary.0 — Janela de avaliação: uma execução ignorada não avança a referência temporal, então uma ação externa posterior ainda pode liberar o próximo disparo agendado.
  • Paperclip canary/v2026.712.0-canary.0 — Caminhos sem controle: disparos por webhook, API e ação manual continuam executando diretamente, enquanto schedules de catch-up fazem uma avaliação por tick do scheduler.

Correções

A origem não separa correções de defeitos nesta versão canary. A mudança se concentra no comportamento do scheduler e inclui testes para migração, proveniência, limitação por projeto, janela sem atividade e bypass por webhook.

Breaking changes

Nenhuma quebra de compatibilidade foi marcada na origem. Os valores padrão mantêm as rotinas existentes em execução contínua, e a configuração pública dos novos campos ficou reservada para uma atualização posterior.

Ponto de Atenção

  • Paperclip canary/v2026.712.0-canary.0 — Migração do banco: confira a criação das duas colunas obrigatórias e os valores padrão em uma base com rotinas existentes.
  • Paperclip canary/v2026.712.0-canary.0 — Escopo por projeto: valide ações ligadas ao projeto selecionado e ações de outro projeto para confirmar a separação aplicada pelo scheduler.
  • Paperclip canary/v2026.712.0-canary.0 — Teste sugerido: execute uma rotina agendada sem atividade externa, confirme no_external_activity no histórico e depois registre uma ação externa para verificar o disparo seguinte.

Notas da versão

  • Paperclip canary/v2026.712.0-canary.0 — Verificação da origem: o fornecedor informa typecheck do banco e do servidor, além de 51 testes aprovados em routines-service.test.ts.
  • Paperclip canary/v2026.712.0-canary.0 — Canal canary: a versão introduz a base do controle de atividade, mas ainda não expõe validação nem documentação pública para configurar os novos campos.
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.