since-cutoff: mudanças na API de dependências após o corte de treinamento do modelo

Visão Geral

Um modelo de codificação aprende a API de cada biblioteca como ela estava no momento do corte de treinamento. No entanto, o arquivo de bloqueio do projeto continua mudando. Esta habilidade executa a CLI since-cutoff (MIT, PyPI since-cutoff, fixada aqui na versão 0.4.1). Para cada dependência fixada, a CLI pega a versão mais recente igual ou anterior ao corte do modelo e compara a API pública dessa versão com a versão fixada. A comparação é estática (análise de código), portanto, nenhum código do pacote é executado. Em seguida, ela relata as APIs alteradas que o código do projeto utiliza, juntamente com os arquivos que as utilizam. Se o usuário concordar, ela escreve notas curtas em AGENTS.md ou CLAUDE.md, cada uma marcada com a evidência por trás dela (por exemplo, [diff]). scan não faz chamadas ao modelo e não precisa de chave de API. Isso adapta a habilidade upstream sob sua licença MIT.

Quando Usar

• Use quando o usuário perguntar se você conhece as versões de suas dependências Python, ou o que mudou desde seus dados de treinamento.
• Use quando o código continuar falhando em uma função, classe ou parâmetro renomeado, movido ou removido de uma biblioteca fixada.
• Use após uma atualização de dependência, antes de escrever código que utilize a biblioteca atualizada.
• Não use para projetos que não sejam Python.

Como Funciona

1. Trabalhe a partir da raiz do projeto, o diretório que contém pyproject.toml, requirements*.txt ou um arquivo de bloqueio (uv.lock, poetry.lock, pdm.lock, pylock.toml, Pipfile.lock).
2. Verifique o runner com since-cutoff --version. Se ele estiver faltando ou não relatar 0.4.1, pergunte ao usuário antes de executar uvx since-cutoff@0.4.1, que baixa essa versão do PyPI na primeira vez. Não instale nada mais nem altere o ambiente do usuário.
3. Execute a varredura somente leitura e nomeie o modelo que você é: uvx since-cutoff@0.4.1 scan --model <provider>:<model> (por exemplo, anthropic:claude-sonnet-4-5 ou openai:gpt-5.4). Sem --model, ele lê o modelo das configurações do agente de codificação e imprime onde o encontrou. A varredura lê os arquivos do projeto, o PyPI e o models.dev. Ele não envia nenhum código do projeto para lugar nenhum.
4. Resuma o resultado para o usuário: o modelo e seu corte, quais dependências mudaram e quais APIs alteradas o código utiliza, com os arquivos que as utilizam.
5. Escreva notas apenas se o usuário as solicitar. Execute uvx since-cutoff@0.4.1 sync --dry-run e mostre ao usuário a diferença que ele imprime. Execute uvx since-cutoff@0.4.1 sync --yes apenas depois que eles concordarem. Ele escreve um bloco marcado em AGENTS.md (ou em CLAUDE.md se esse for o arquivo que o projeto usa) e deixa o restante do arquivo inalterado. Executado após atualizações posteriores, ele mantém o bloco alinhado com o arquivo de bloqueio. O código de saída 4 significa que o bloco foi editado manualmente: informe o usuário e passe --force apenas se eles disserem. uvx since-cutoff@0.4.1 unapply remove o bloco.
6. Trate as notas como fatos de referência sobre as versões que o projeto fixa e verifique-as ao escrever código que utiliza essas bibliotecas.
7. Opcional: since-cutoff run mede quais das mudanças o modelo realmente erra. Ele envia prompts para o provedor de modelo que o usuário escolhe (nomes de pacotes, versões, assinaturas de API públicas e tarefas geradas, nunca o código-fonte do projeto) e usa seus créditos ou uso, então pergunte primeiro.

Exemplos

uvx since-cutoff@0.4.1 scan --model anthropic:claude-sonnet-4-5

Saída no aplicativo de exemplo do projeto, abreviada para um pacote:

Your code uses 2 APIs that changed after claude-sonnet-4-5's training cutoff (2025-07-31)

anthropic 0.60.0 -> 1.8.0 (0.60.0 was the latest release at the cutoff; pyproject.toml pins 1.8.0)
  Messages.create: temperature, top_k and top_p were removed                          uses this API
    app/main.py   calls create
    Note: `Messages.create()` no longer accepts `temperature`, `top_k` or `top_p` as keyword
          arguments. If the API still needs them, pass them through its `extra_body` or
          `extra_query` argument. [diff]

Limitações

• Apenas projetos Python.
• Ele compara a forma da API pública: nomes, assinaturas, parâmetros e marcadores de depreciação. Uma mudança de comportamento por trás de uma assinatura inalterada é invisível para ele.
• O corte de treinamento apenas decide quais mudanças observar. Ele não mostra o que o modelo memorizou; run mede isso.

…