Files
agent_framework_oci/ATUALIZACAO_TESTES.md
2026-10-30 22:04:44 -03:00

58 lines
3.4 KiB
Markdown

# Atualização dos testes após mudanças de contrato
Esta revisão mantém os quatro nomes de arquivo e a quantidade de testes. Oito
testes foram atualizados, sem `skip`, `xfail` ou alterações no runtime para
acomodar as expectativas antigas. Os nomes de sete funções foram ajustados para
descrever o comportamento atual. Os comentários nos testes registram o histórico.
## Histórico verificado no Git do pacote original
- `1711575`, 2026-09-07, `bugfix reconciliation extractor`: removeu
`field_evidence_views`, a construção de candidatos estruturais e partes da
reconciliação anterior.
- `82636ec`, 2026-09-08, `bugfix: extractor cases 8 and 16`: consolidou a coleta
de parâmetros no `single_extractor`, com contexto e pré-validação autoritativa.
- `36f9781`, 2026-09-18, `new feature: transaction interruption for same intent replacement`:
também adicionou sanitização e reavaliação ao DLEX_OUT e passou a usar
`sanitized_text` somente quando há um texto substituto.
## O que os testes passam a verificar
| Arquivo | Contrato coberto |
|---|---|
| `tests/test_transactional_tool_flow.py` | Após `NEEDS_PARAMETER`, o fluxo aguarda nova informação; a nova validação ocorre no turno seguinte e a operação não executa antes da confirmação. |
| `tests/test_transaction_parameter_llm_precedence.py` | O reconciliador recebe schema e contexto, aceita o campo resolvido e respeita `preserve` sem sobrescrever o valor conhecido. |
| `tests/test_transaction_explicit_abandonment_and_structural_candidate.py` | Campo indefinido continua pendente; extração contextual bem-sucedida passa pela validação antes da confirmação; `clear` não inventa um valor nem apaga os demais campos. |
| `tests/test_dlex_out_expected_protocol_authorization.py` | Protocolo autorizado não exige substituição do texto; credencial é removida e a resposta é reavaliada; outra violação mantém o bloqueio. |
Os simuladores deixaram de depender de frases específicas do prompt, como
“FOCO PRINCIPAL DA RECONCILIAÇÃO”. Eles devolvem saídas compatíveis com o contrato
da chamada. A identificação semântica por um modelo real não é comprovada por
esses testes unitários: os testes verificam como o framework utiliza suas saídas.
## Verificações realizadas
- 160 testes selecionados aprovados no pacote atualizado, incluindo os 41 testes
de localização e os quatro arquivos desta revisão.
- Os 66 testes dos quatro arquivos também foram executados usando a biblioteca
original do ZIP: todos aprovados. Assim, a atualização dos testes não depende
da alteração de idiomas para passar.
- Contagem mantida por arquivo: 31, 13, 17 e 5 testes, respectivamente.
- Nenhuma chamada a OCI, modelos remotos ou ferramentas reais de negócio.
- Esta revisão não afirma que a suíte completa do repositório foi executada.
## Aplicar ao repositório
O ZIP completo inclui a localização em `pt-BR` e `en` entregue anteriormente e
esta revisão dos testes. Copie o conteúdo da pasta `agent_platform_oci` para a
raiz do repositório, preservando a pasta `.git` que já existe no seu checkout.
Se a localização já estiver aplicada, o ZIP complementar de testes contém apenas
os quatro arquivos atualizados e esta documentação. Não é preciso usar ambos.
Sugestão de mensagem de commit para a revisão dos testes:
```text
test: align transaction and DLEX_OUT tests with current contracts
```