2.6 KiB
C158 — Sollinha sugere trechos de falas do acervo para vídeos (2026-09-14): a ponte entre a pergunta de tema no chat e o acervo da Comunicação (C153/C154). A tool read-only findSpeechExcerpts recebe tema (palavras de conteúdo) e intencao (uso/tom/duração, nas palavras do usuário), sanitiza os termos em src/lib/speechExcerpt.ts (normaliza acento, quebra em [^a-z0-9]+ — %/_ nunca chegam ao LIKE —, descarta <3 chars e capa 6), busca candidatos com AND de searchText like %termo% sobre speech.searchText (índice trgm, sort -speechAt, 30) e monta a janela contígua com buildSpeechExcerpt: âncora de maior cobertura + expansão priorizando cobertura sobre o alvo, variantes curta (~20s) e longa (~45s), gap máximo 5s, teto 60s (segmento único maior é mantido inteiro), mínimo 15s — um trecho por discurso, no máximo 3 (até 5). A escolha entre os candidatos é refletida por src/utilities/ai/rerankSpeechExcerpts.ts (server-only, DeepSeek deepseek-flash via generateObject+zod, timeout 6s, nunca lança, valida índices/motivos; lista vazia é decisão "nenhum serve"); sem chave/erro/saída inválida a tool cai na ordem determinística (reordenadoPorIA: false) e nunca inventa fala/minutagem — citação e corte sempre vêm do ASR. Cada sugestão devolve citacao, inicioLabel/fimLabel, motivo (quando houve IA) e url pronta no ponto do acervo (?t=&q= via buildWatchHref, exportado do dono junto de formatSpeechAt/formatSpeechClock; o loader loadSegmentsForSpeeches também foi exportado e reusado). Gate canReadSpeechCatalog fail-closed antes de qualquer query e do reranker (coordinator/candidate/communicator leem; advisor e leader negados), nascendo herdável pelo C159; seção nova no systemPrompt ensina quando usar, o formato (1–3 com citação, corte, justificativa e link) e os guardrails de vazio/negativa. Sem migration, sem Consent, sem UI nova. Provas: 3 unit novos (speechExcerpt, rerankSpeechExcerpts com generateObject mockado, speechExcerptsTool com gate intocado) + int speechExcerpts (Payload real: 5 papéis, acento, janela/URL, dedup, vazio, spy do reranker) + e2e afetado campaignAiTranscribe verde; gate:fast, knip e check:cycles verdes. Nota de execução: o smoke real do generateObject com deepseek-flash não rodou no ambiente local (sem DEEPSEEK_API_KEY); o desenho é fail-safe pelo fallback — validar no primeiro uso em staging/produção (Fase 2 do sollinha-acervo-falas-trechos-impl.md). O gate de produto de 2026-09-14 incorporou o reranking por LLM (antes listado como rabbit hole cortado); embeddings/índice vetorial seguem fora.