teqo-backup/docs/changelog/2026-09-17-c188.md
Francisco Solla 4b00a8778a feat(C188): relatórios e dossiês sem truncamento mecânico
Dono único de orçamento de texto em reportText.mjs (capList,
excerptDeepDive, joinWithRemainder, summaryText/summarySurfaceText,
summaryListText), reusado por C163 e C186. Contrato summary por item nos
dois arquivos de pesquisa; superfície de resumo nunca corta com "…" e
aponta o aprofundamento; toda lista capada mostra contador; builders com
2 passadas guard-gated (integral → ponteiro → die fail-closed).

Closes #1136
2026-09-17 19:59:02 -03:00

1.7 KiB
Raw Blame History

C188 — Relatórios e dossiês sem truncamento mecânico (2026-09-17): o C163 cortava texto no meio da frase com "…" e o C186 descartava itens de lista em silêncio — informação sumia na última milha. Agora a regra é explícita: superfície de resumo não corta; lista capada sempre mostra contador; o integral fica no aprofundamento; a guarda de fit segue fail-closed. O orçamento de texto ganhou um dono único (scripts/lib/reportText.mjs, reusado por C163 e C186): capList ({items,total,remaining}), excerptDeepDive (o único que pode imprimir "…", só no aprofundamento), joinWithRemainder, summaryText/summarySurfaceText e summaryListText. Contrato novo de pesquisa: cada item aceita summary — curto, completo e auto-contido, redigido pelo researcher para caber no orçamento do resumo (cityReportResearch.mjs, dossieResearch.mjs); sem ele, prefere o answer integral e amplia o orçamento enquanto a guarda permitir. Os builders passam a medir a página de resumo em duas passadas (texto integral → ponteiro para o aprofundamento sem "…" → die fail-closed) e cada superfície capada declara o resto: entregas/ganchos/lacunas/números/ações/itens regionais no dossiê, escopos município×região (region.evidence), "e mais N fatos com fonte" no boletim e "Mostrando X de Y" nas tabelas do C163. As skills relatorio-cidade e dossie-solla-cidade documentam o summary. Débitos do review (2-pass do dossiê, ponteiros de escopo, paridade de helpers) registrados em #1139 (C189). Skills/scripts/testes apenas — sem schema, migration, URL pública, Consent ou LGPD. pnpm gate:fast + knip + cycles + format verdes (347 arquivos / 3638 testes). Issue: #1136.