Skip to content

fix: alinhar contrato de integração com provider de streaming - #53

Merged
PedroAugusto08 merged 2 commits into
mainfrom
fix/issue-33-integration-contract
Sep 14, 2026
Merged

PedroAugusto08 merged 2 commits into
mainfrom
fix/issue-33-integration-contract

Conversation

@PedroAugusto08

Copy link
Copy Markdown
Collaborator

Resumo

Finaliza o escopo atual da Issue #33, alinhando o contrato de integração com a arquitetura real do projeto.

Alterações

  • Corrige VoxelGridProvider.get_top_solid_block() no modo dinâmico usado com WorldManager.neighbor_at.
  • Mantém compatibilidade com o provider baseado em chunks estáticos.
  • Adiciona teste de regressão usando WorldManager real.
  • Valida coordenadas negativas e comportamento após unload de chunks.
  • Atualiza INTEGRATION_SPEC.md e READMEs relacionados.
  • Remove CameraStateProvider e HighlightBridge como requisitos obrigatórios, pois a arquitetura atual realiza essa integração diretamente no loop principal.
  • Documenta que chunks ausentes retornam AIR.
  • Documenta a distinção entre bloco ocupado e superfície tática válida.

Limitação atual

O WorldManager atual trabalha apenas com chunk_y = 0, cobrindo o intervalo global Y de 0 a 15.

get_top_solid_block() respeita essa arquitetura atual sem provocar geração de chunks nem aguardar o worker.

Caso streaming vertical seja introduzido futuramente, o contrato deverá ser estendido para expor explicitamente as faixas verticais carregadas.

Validação

  • pytest -q: 413 passed, 3 skipped
  • git diff --check: passou
  • testes de integração atualizados
  • nenhuma alteração no pipeline gráfico, raycasting, grid, highlight, câmera ou geração procedural

Closes #33

@PedroAugusto08
PedroAugusto08 merged commit cff5833 into main Sep 14, 2026
1 check passed
@PedroAugusto08
PedroAugusto08 deleted the fix/issue-33-integration-contract branch September 14, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Equipe B] [Integração] Implementar Módulo de Integração com Motor A (VoxelGridProvider + Bridge)

1 participant