[Garakis]

O que este PR faz

Integra na main, de uma vez e já sem conflitos, três entregas da Sprint 2 que estavam em branches separadas:

• S2-03 s2-03-sincronizacao-indice (mesmo conteúdo do [S2-03] Publicar eventos e manter o índice sincronizado, idempotente e sem itens arquivados #48): eventos de indexação idempotentes.
• S2-08 s2-08-busca-acervo: interface de busca no acervo e leitura de trechos do documento.
• S2-09 + S2-10 s2-10-modos-especificacao: harness versionado por modo e copiloto (questionador e padronizador). A branch s2-10 já contém os commits da s2-09-harness-versionado.

Cada branch entrava limpa na main sozinha, mas conflitavam entre si. Os conflitos foram todos de soma (cada branch acrescentou algo no mesmo ponto), e a resolução manteve os dois lados em todos eles:

Arquivo	Resolução
backend/src/app.ts	mantidos os imports e app.use de indexingRouter, documentTextRouter e dos routers do harness
backend/package.json	mantidos os scripts test:integration:indexing, search, knowledge, harness, copilot e test:smoke:harness:local
docs/api/openapi.yaml	mantidas as rotas index-events, excerpts, admin/ai-harness e ai/requests, e os schemas IndexEvent, HarnessConfig e HarnessRevision
.github/workflows/ci.yml	mantidos os dois passos novos: testes de indexação (PostgreSQL) e validação do harness

Nenhuma linha de lógica foi alterada na resolução.

Ponto de atenção

Ficam duas migrations com número 019: 019_ai_harness.sql (S2-09) e 019_entity_index_events.sql (S2-03). Elas não dependem uma da outra, o runner registra o nome completo e a main já tem outros números repetidos (004, 005, 007...), então mantive os nomes originais. Se o grupo preferir, dá para renomear uma delas para 020 antes do merge.

Validação local

• Backend: npm run build ok; npm test com 347 testes passando, 0 falhas (inclui o teste que confere o OpenAPI contra as rotas reais).
• Frontend: npm run build ok; vitest com 278 testes passando.
• ai-service: 14 testes novos do harness passando. Há 5 falhas em test_analyzer e test_safety_limits, que acontecem igual na main quando rodadas no macOS (no CI, em Linux, elas passam).

Depois do merge

• O [S2-03] Publicar eventos e manter o índice sincronizado, idempotente e sem itens arquivados #48 pode ser mesclado antes ou depois deste: o conteúdo é o mesmo e não gera conflito.
• As branches s2-03-sincronizacao-indice, s2-08-busca-acervo, s2-09-harness-versionado e s2-10-modos-especificacao podem ser apagadas.

🤖 Generated with Claude Code