Release do Paperclip · 25 de junho de 2026

Paperclip canary/v2026.625.0-canary.2

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

Paperclip canary/v2026.625.0-canary.2

Resumo

O Paperclip canary/v2026.625.0-canary.2 consolida três canaries voltados a execução sandbox, instalação de plugins, progresso efêmero de runtime e restauração de checkout no host. A linha melhora a visibilidade de etapas ativas do agente e corrige desalinhamento entre conteúdo restaurado e índice Git durante a finalização.

Novidades

  • Paperclip canary/v2026.625.0-canary.2 — Alvo de plugin: a CLI passa a exibir o host de destino na instalação de plugins e adiciona o comando plugin target.
  • Paperclip canary/v2026.625.0-canary.0 — Progresso efêmero de runtime: foi criado um contrato de runtime-progress com evento live heartbeat.run.progress, permitindo mostrar texto curto sobre fases ativas de runs sandbox.
  • Paperclip canary/v2026.625.0-canary.0 — Store local de status: o backend adiciona um store em processo para status de runtime com TTL, limite de mensagem, redação de conteúdo sensível e limpeza em estados terminais.

Melhorias

  • Paperclip canary/v2026.625.0-canary.1 — Índice do checkout no host: a sincronização do workspace Git foi atualizada após restore e export de sandbox, reduzindo leituras falsas de arquivos ausentes ou estado sujo.
  • Paperclip canary/v2026.625.0-canary.1 — Status de finalização: a finalização agora informa se o checkout restaurado no host está limpo ou sujo.
  • Paperclip canary/v2026.625.0-canary.1 — Callbacks de runtime: callbacks de progresso do runtime sandbox foram preservados durante restore e finalização.
  • Paperclip canary/v2026.625.0-canary.0 — Serialização live: callbacks de progresso passam pelo heartbeat execution e pela serialização de runs ativas, reaproveitando o canal websocket existente.
  • Paperclip canary/v2026.625.0-canary.0 — Fases sandbox: runs sandbox-managed passam a emitir atualizações para sincronização, startup do adapter, restore/export e finalização.

Correções

  • Paperclip canary/v2026.625.0-canary.1 — Drift do índice Git: a restauração de sandbox passa a realinhar o índice do host depois de atualizar o conteúdo do checkout, evitando resultado enganoso em ferramentas locais de revisão.
  • Paperclip canary/v2026.625.0-canary.1 — Cobertura de adapter-utils: testes foram adicionados para cobrir correção de drift do índice e sinal limpo/sujo na finalização.
  • Paperclip canary/v2026.625.0-canary.0 — Limpeza terminal: testes cobrem limpeza de status em estados terminais, serialização live e callbacks de progresso em sandbox.

Breaking changes

Não há breaking change declarado na origem. A mudança exige atenção porque o sinal de checkout limpo ou sujo é diagnóstico e não deve ser usado sozinho para aprovar ou reprovar uma execução sandbox.

Ponto de Atenção

  • Paperclip canary/v2026.625.0-canary.2 — Plugin target: valide o novo comando plugin target em hosts diferentes para confirmar que a CLI exibe o destino correto antes de instalar plugins.
  • Paperclip canary/v2026.625.0-canary.1 — Restore de sandbox: confira se o índice Git do host continua alinhado depois de restore/export e se alterações locais reais não são escondidas pela atualização do índice.
  • Paperclip canary/v2026.625.0-canary.0 — Progresso efêmero: o status de runtime desaparece após TTL, limpeza terminal ou reinício do servidor, então clientes precisam continuar funcionando quando não consumirem heartbeat.run.progress.
  • Paperclip canary/v2026.625.0-canary.2 — Teste sugerido: execute uma run sandbox com sync, adapter startup, restore/export e finalização, acompanhando o evento heartbeat.run.progress e comparando git status no host depois do restore.

Notas da versão

A origem registra verificações com vitest, typecheck, build e varredura local de segredos antes do push. Também informa falhas em testes amplos não relacionados, dependentes do comportamento local de branch padrão do Git e do ambiente de descoberta de modelos Claude.

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.