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_policyeactivity_gate_scope, com os padrõesalwaysecompanypara 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_activitye 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_activityno 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.