Release do Paperclip · 07 de julho de 2026

Paperclip canary/v2026.707.0-canary.7

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

paperclip canary/v2026.707.0-canary.7

Resumo

O Paperclip canary/v2026.707.0-canary.7 agrega oito canaries publicados em 2026-07-06 e 2026-07-07. A sequência amplia diagnósticos de issues, bloqueios, wake events, subárvores, validação de workspace e segurança de migrations, além de trazer um ajuste de protocolo para o OpenClaw Gateway.

Novidades

  • paperclip canary/v2026.707.0-canary.7 — Diagnóstico de subárvore: o endpoint GET /api/issues/:id/diagnostics/subtree retorna uma travessia limitada da árvore abaixo de uma issue, com flags de truncamento por profundidade, nós, blockers e wakes.
  • paperclip canary/v2026.707.0-canary.7 — Diagnóstico de wakes: o endpoint GET /api/issues/:id/diagnostics/wakes expõe wake requests e eventos de defer ou suppression em uma janela limitada de 14 dias e 50 linhas.
  • paperclip canary/v2026.707.0-canary.7 — Diagnóstico de blockers: o endpoint GET /api/issues/:id/diagnostics/blockers mostra readiness por blocker e um resumo do bloqueio visível para o caller.
  • paperclip canary/v2026.707.0-canary.7 — Segurança de migrations: o pacote packages/db ganha um checker estático para padrões perigosos em migrations, integrado ao gate check:migrations.
  • paperclip canary/v2026.707.0-canary.7 — Recovery card: a origem principal informa diagnóstico de divergência no recovery card e reexecução isolada com um clique, mas o corpo detalhado dessa entrada não foi publicado no pacote bruto.

Melhorias

  • paperclip canary/v2026.707.0-canary.7 — Projeções sanitizadas: os diagnósticos removem payloads brutos, erros brutos, detalhes de atividade e campos de trigger antes de responder.
  • paperclip canary/v2026.707.0-canary.7 — Autorização por nó: os diagnósticos de subárvore e blocker filtram cada nó pela permissão de leitura, omitindo itens não autorizados da resposta.
  • paperclip canary/v2026.707.0-canary.7 — Tipos compartilhados: respostas e tipos de blocker, wake e subtree diagnostics foram exportados em @paperclipai/shared.
  • paperclip canary/v2026.707.0-canary.7 — Documentação de API: as referências em skills/paperclip/references/api-reference.md foram atualizadas para os novos endpoints.

Correções

  • paperclip canary/v2026.707.0-canary.7 — Contenção de branch: testes com Postgres embutido cobrem divergência de branch em realização de git worktree, restauração de workspace persistido e finalização de heartbeat.
  • paperclip canary/v2026.707.0-canary.7 — Workspace sem projeto: o heartbeat falha cedo com workspace_validation_failed quando uma issue sem projeto tenta usar git_worktree sobre agent_home.
  • paperclip canary/v2026.707.0-canary.7 — Base não git: a validação bloqueia diretórios base que não são checkouts git antes das operações de worktree.
  • paperclip canary/v2026.707.0-canary.7 — OpenClaw Gateway: o adapter sobe PROTOCOL_VERSION para 4 para alinhar com o gateway.

Breaking changes

Nenhuma quebra de compatibilidade foi reportada como mudança pública. A sequência altera validações de workspace e gates de migration, então ambientes que dependem de git worktree, heartbeat e checks de banco precisam validar o fluxo completo antes de adotar a canary.

Ponto de Atenção

  • paperclip canary/v2026.707.0-canary.7 — Endpoints de diagnóstico: revise chamadas com usuários de baixa confiança, blockers ocultos e acesso entre empresas para confirmar que as respostas continuam omitindo o que o caller não pode ler.
  • paperclip canary/v2026.707.0-canary.7 — Workspace git: teste issue sem projeto, base não git, workspace isolado, operator branch e finalização de heartbeat para conferir workspace_validation_failed e campos de evidência.
  • paperclip canary/v2026.707.0-canary.7 — Migration safety: rode pnpm run check:migrations em packages/db com uma migration de teste antes de confiar no gate para novas alterações de banco.
  • paperclip canary/v2026.707.0-canary.7 — Teste sugerido: execute as suítes issue-blocker-diagnostics-routes, issue-wake-diagnostics-routes, issue-subtree-diagnostics-routes, heartbeat-workspace-branch-containment e heartbeat-workspace-session em staging.

Notas da versão

  • paperclip canary/v2026.707.0-canary.7 — Canaries mesclados: a origem agrega canary.0 a canary.7, com conteúdo detalhado em canary.0, canary.2, canary.3, canary.4, canary.5 e canary.6.
  • paperclip canary/v2026.707.0-canary.7 — Origem parcial: canary.1 e canary.7 trazem apenas título curto no pacote bruto, então este registro não inventa detalhes além do que a origem afirma.
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.