[S2-03] Publicar eventos e manter o índice sincronizado, idempotente e sem itens arquivados

[Giomoret]

O que foi feito

Implementada a indexação automática de itens concluídos e decisões salvas, consolidando as tarefas S2-03 e S2-04.

• Publicação de eventos na mesma transação da alteração.
• Atualização dos trechos e embeddings sem duplicação.
• Preservação de projeto, nível, status e tecnologias.
• Retirada do índice ao arquivar a origem ou seus ancestrais.
• Consulta dos estados e falhas, com reprocessamento seguro.
• Proteção contra respostas atrasadas e isolamento entre projetos.
• OpenAPI, documentação e testes de integração no CI atualizados.

Validação

• Após integrar a main em 19/10: 337 testes gerais aprovados, zero falhas e 37 condicionais ignorados; verificação de tipos aprovada.
• Nas rodadas de 14/10: 32 testes específicos aprovados com PostgreSQL e IA reais, 3.200 operações combinadas verificadas e compilação aprovada.
• Cenários de concorrência, falhas, reprocessamento, permissões, transferência entre projetos e migração com dados existentes.

Os testes de banco e IA não foram repetidos nesta publicação porque o Docker estava fechado. A validação de PostgreSQL foi incluída no CI do PR.

Para executar

Aplicar a migração 019 com npm run migrate no backend e reiniciar o serviço. A migração publica os eventos das origens existentes e limpa trechos inelegíveis; a fila refaz a indexação em segundo plano.

Referências

S2-03 · consolida S2-04
PBI-02.2.2 · PBI-02.2.3