mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 21:03:06 +00:00
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
73 lines
3.8 KiB
Markdown
73 lines
3.8 KiB
Markdown
# Escala/DRY: débitos do C188 (relatórios/dossiês sem truncamento)
|
||
|
||
Status: rascunho
|
||
Atualizado em: 2026-09-17
|
||
Issue: #1139 (C189)
|
||
Priority: P3
|
||
Kind: chore
|
||
Depends: #1136 (C188)
|
||
Appetite: ~0,5–1 dia eng
|
||
Impeccable: A — scripts-only, sem superfície de UI
|
||
|
||
## O débito (colhido no /simplify do C188)
|
||
|
||
Três resíduos de baixo risco no dono de texto/orçamento que o C188 acabou de
|
||
consolidar. Nenhum é bug funcional (a guarda fail-closed continua abortando);
|
||
são paridade e honestidade de mensagem.
|
||
|
||
1. **2-pass do dossiê mede toda página (O1).** `build-dossie-solla-cidade.mjs`
|
||
mede `[data-page]` inteiro; a passada de ponteiro só reescreve o resumo. Uma
|
||
página não-resumo estourada dispara um rebuild de ponteiro inútil e depois
|
||
morre com log que diz "re-renderizando com ponteiro" — mentira de fluxo. O
|
||
C163 mede só `[data-page="summary"]`. Paridade: chavear o gatilho do dossiê em
|
||
`[data-page="resumo"]` e reportar a página ofensora direto no `die`.
|
||
2. **Ponteiros de escopo/região pouco honestos (O3 + R1).** O ponteiro municipal
|
||
das duas listas de escopo manda "ver a tabela de evidências abaixo" — que é
|
||
só regional. E o MD do `era.actions` ainda diz "tabela de respostas da era"
|
||
(superfície que não existe no dossiê; o HTML irmão já diz "arquivo de pesquisa
|
||
da era"). Declarar/alinhar os cortes escopo (5) × evidência (4) e usar a
|
||
mesma copy no HTML e no MD.
|
||
3. **Paridade de helpers e da skill (O5 + S10b).** `moreItemsLabel`/
|
||
`showingLabel` mantêm defaults de singular/plural que todo call site
|
||
sobrescreve (generalidade especulativa). E a skill `relatorio-cidade` lista os
|
||
itens de página 1 que precisam de `summary` e omite `vereadores`, que
|
||
`buildWhoRows` imprime no resumo.
|
||
|
||
## Appetite e rabbit holes
|
||
|
||
- Tocar `build-dossie-solla-cidade.mjs` e `dossieRender.mjs` reusados pelo
|
||
**C187 (#1135)** — coordenar: F1 pousa antes/junto do C187.
|
||
- Rabbit hole: transformar o ajuste de medição em refactor dos dois builders
|
||
(NÃO unificar os loops; só alinhar o gatilho e a mensagem). Não abrir apêndice
|
||
de respostas por era (ver Explicitamente fora).
|
||
- Sem schema, migration, URL pública, Consent/LGPD.
|
||
|
||
## Fases (ROI)
|
||
|
||
1. **F1 (O1)** — 2-pass do dossiê keyed em `[data-page="resumo"]`, com a página
|
||
ofensora na mensagem do `die`.
|
||
2. **F2 (O3+R1)** — ponteiro municipal → "ver as páginas das eras"; alinhar
|
||
escopo 5 × evidência 4 (ou declarar o corte duplo); MD `era.actions` →
|
||
"arquivo de pesquisa da era".
|
||
3. **F3 (O5+S10b)** — singular/plural obrigatórios em `moreItemsLabel`/
|
||
`showingLabel`; incluir `vereadores` na lista de `summary` da página 1 em
|
||
`.agents/skills/relatorio-cidade/SKILL.md`.
|
||
|
||
## Já resolvido no simplify do C188 (não reabrir)
|
||
|
||
- Dono único `summarySurfaceText` (regra summary→answer→ponteiro) substituindo o
|
||
geminado C163/C186; `summaryListText` + tetos de caractere para listas
|
||
não-pesquisa; `region.evidence` + contadores de escopo no HTML e no MD;
|
||
`capList` no `gapCallout`/`emendasIndicators`; comentários OPS120 obsoletos;
|
||
nota do teto de coleta da Câmara no `eraMethod.C`; testes negativos de "…",
|
||
invariante do boletim e caso ponteiro+summary.
|
||
|
||
## Explicitamente fora (defers do triage do C188)
|
||
|
||
- **Apêndice "respostas por era" no dossiê (O2).** `era.numbers`/`era.actions`
|
||
continuam capados com contador, e o integral vive no JSON de pesquisa (não no
|
||
PDF). É decisão de produto/design (layout novo, Impeccable C), fora do appetite
|
||
do C188. **Gatilho:** quando um dossiê real perder um número/ação de era que a
|
||
comunicação precise citar, ou quando o C187 institucional exigir o integral.
|
||
- **`factsTotal` no boletim (O4).** Mantido: é a âncora do invariante
|
||
`highlights + moreItems + factsRemaining === factsTotal` do spec do boletim.
|