The /simplify triage produced two live debts, and both are about the same pair of functions the B34+ plan already names in F3, so they landed as F10 of that plan rather than as an escala-dry-pos-b37: the município-side batch actions write one município at a time (findByID + update each — ~870 round trips at the 435 ceiling B37 itself raised, but ~52 at the largest real TI, and no test above a batch of 2), and the two are twins at 2 call sites, one short of the bar. The common trigger is a "select all"/multi-TI affordance or a third batch on that side, and F10 records why the bulk-SQL rewrite is not obviously the answer: it would hand back the scope check that overrideAccess: false gives for free. This delivery also closed B34+ phases outright, which is worth reading in the plan rather than inferring from a diff. F2 is done and its prediction was wrong in a way worth keeping: it stated "o B37 não retira este débito", and B37 read the same evidence the other way — the ~165 measured lines were not deduplicated into useChipRowOverflow, they were deleted when both cells became wrappers of one engine. F9 is done via scopedPortfolioIndex. Half of F3 is done (the three single-id deltas), and the half that stayed out — the set-with-floor form — stayed out because seeing the collapsed code confirmed the plan's own inverted recommendation. F5 and two F6 bullets shrank for the same reason: "written twice across the two surfaces" stopped having two surfaces. Also corrects a comment I got wrong in the previous commit: the batch's sort does not carry the deadlock-avoidance guarantee, since acquireTextAdvisoryLocks sorts its own keys (C8 batched them into one round trip); it only makes the apply order stable.
32 KiB
B34+ — Escala e DRY pós-B34
Fill-in de engenharia com os débitos que sobreviveram ao /simplify do B34 ✓ (chips editáveis de municípios na lista de lideranças). Entrega-mãe: chips-municipios-lista-liderancas.md.
Três achados dos relatórios foram aplicados no próprio fechamento do B34 e não voltam aqui: campos mortos no índice RSC (city/zoneNumber), o parser divergente de FormData em /campanha/assessores, e a mensagem de seleção vazia declarada duas vezes.
Já resolvido no fechamento (medido, não estimado)
O passe de perf localizado que fechou o B34 rendeu, com bancada em tsx sobre o catálogo real (435 entradas, tabela de 25 linhas):
| Caminho | Antes | Depois | Como |
|---|---|---|---|
buildMunicipalityPortfolioChips |
4,2 ms | 0,78 ms | WeakMap por array de índice (portfolioIndexDerivations) + curto-circuito territoryIds.length > remaining.size |
| idem, em re-render (índice quente) | 4,2 ms | 0,043 ms | o WeakMap sobrevive entre renders; um useMemo por linha não sobreviveria |
searchMunicipalityPortfolio, tecla |
4,59 ms | 0,077 ms | query normalizada uma vez + rótulos pré-normalizados (matchesNormalizedAtWordStart) |
Também entraram: sameIdSet no lugar do comparador de chaves ordenadas escrito à mão (3º call site do helper), scrollIntoView restrito a navegação por teclado (o mouse já está onde aponta — era um layout forçado por opção percorrida), e o revalidatePath passou a usar o delta real (changed) em vez de tudo que foi pedido — remover um município que já não estava vinculado não busta mais a rota dele.
Um item do relatório foi rejeitado por medição, e vale registrar porque parecia óbvio: remover o sort: 'name' do loader ("nada depende da ordem do banco") quebrou a lista de sugestões. searchMunicipalityPortfolio percorre o índice na ordem em que ele chega e para no limit, então a ordem alfabética das sugestões era a ordem do ORDER BY — sem ele o usuário passa a receber os 12 primeiros casamentos em ordem física de linha. O e2e do B34 pegou (o teste digita um prefixo e aperta Enter no primeiro item), e o sort voltou com o motivo escrito ao lado.
Fechado no /simplify pós-rebase (a premissa que morreu)
O rebase em main trouxe o B42 ✓ e, com ele, CampaignCellEditOverlay. A leitura inicial foi que a casca não servia porque "ela decide por largura de viewport e o B34 decide por tipo de ponteiro". Isso é falso no código: a casca não decide nada — variant é prop, não há matchMedia nela, e o docstring diz isso com todas as letras. Quem decide por largura é o MunicipalityList, que renderiza duas árvores irmãs; LeadershipListSupportStatusControl, na mesma tabela do B34, fixa variant="popover" porque sabe a sua própria política. O B34 passou a ser a terceira política sobre um container que não tem nenhuma: variant="sheet" fixo, com o pointer-fine:hidden no triggerClassName, e a política de ponteiro continua onde estava, no CSS.
Ganhos que não eram sobre linhas (embora sejam ~25 a menos, ~14 delas cópias verbatim do DrawerHeader/DrawerFooter): o initialFocus={titleRef} da casca — o Drawer do B34 focava o primeiro chip, um link que navega para fora da linha que se está editando, ou o campo de busca numa linha em rascunho, que é exatamente o teclado-virtual-sobre-a-folha que o B42 documentou; o trigger passou a ter aria-haspopup="dialog"/aria-expanded/aria-busy, que todo outro trigger de célula das duas listas já tinha; e a célula entrou no spec table-driven da casca como 5º caso — a metade Drawer do B34 não tinha nenhuma cobertura, porque o e2e roda em ponteiro fino.
A adoção custou um bug real, achado pelo e2e e vale saber antes de adotar a casca em outro lugar: um Drawer sempre montado reporta onOpenChange(false) quando uma dispensa em outro ponto da página varre a pilha de camadas — não só quando ele mesmo fecha. O handler novo (limpar a busca ao fechar a folha, para que o listbox portalizado não apareça num toque depois que a gaveta sai) apagava, sem guarda, o que o ponteiro fino tinha acabado de digitar no input inline. O guard é if (!next && drawerOpen).
Também fechado aqui, e é correção de comportamento, não de estilo: setAdvisorMunicipalitiesBatch revalidava só o último município do lote (lastSlug). Era pré-existente do B19, mas o B34 promoveu o lote ao único caminho de escrita do assessor e pôs um chip de território ao alcance do dedo, então soltar um TI de 30 municípios deixava 29 páginas de detalhe velhas. Agora devolve slugs: string[] e revalida a lista uma vez e cada detalhe que mudou, espelhando revalidateLeadershipMunicipalityPaths.
Duas recomendações do relatório foram fechadas como "não fazer", com motivo: o ramo Popover da casca não serve ao B34 e não deve ser adotado — ele entrega role="dialog" atrás de um PopoverTrigger, e um dialog não pode ser o popup de um combobox ARIA 1.2 (o inline precisa de PopoverAnchor + role="listbox" que nunca toma foco). E o F3 abaixo (colapsar os três next*IdsAfterMembership) continua registrado, mas com a recomendação invertida por uma segunda leitura: um genérico cobrindo "um id" e "um conjunto com piso e teto" precisaria de quatro callbacks para poupar ~20 linhas.
Fechado na revisão de qualidade + performance (o bug que voltou)
O achado que importa: o bug do baseline otimista tinha voltado, escrito de outro jeito. O fechamento anterior corrigiu "aplicar o delta funcionalmente" e registrou isso como resolvido — mas o ?? dentro do updater ainda lia o municipalityIds da render que criou a closure, e o "Desfazer" do toast é justamente o único chamador que sobrevive à sua render. Sequência real, reproduzida em teste: remover um território (toast aparece) → servidor reconcilia, optimistic volta a null → adicionar outro município → apertar Desfazer. O updater cai no ramo do fallback, reconstrói a linha a partir do conjunto de antes do add, e o município adicionado some da tela enquanto continua salvo no servidor. A divergência é permanente, porque o efeito de reconciliação só limpa em igualdade exata. Corrigido com um ref (latestIds) que segue effectiveIds, e o ramo draft o avança de forma síncrona — dois toggles no mesmo tick liam ambos a prop da render em que foram enfileirados, e o segundo descartava o primeiro.
Isso agora tem pino: tests/unit/municipalityPortfolioCell.unit.spec.ts monta a sequência inteira e falha (vermelho verificado) contra a versão com o bug. As duas revisões discordaram aqui — a de performance leu o withDelta funcional e concluiu "sem divergência de closure"; a de qualidade traçou a sequência. Vale registrar qual estava certa, porque a leitura otimista é a intuitiva.
Uma otimização anterior foi desfeita por medição, e ela era minha: o corpo do Drawer estava atrás de drawerOpen como "ganho de alocação". O ganho foi medido e é zero — o portal fechado não emite DOM e a string de 85 classes é acerto de cache do tailwind-merge (2,71 ms frios uma vez por sessão, 0,0001 ms depois) — enquanto o custo é real: base-ui mantém o popup montado durante a transição de saída, então fechar a gaveta animava uma caixa vazia encolhendo. As outras duas células em célula da casa não fazem esse gate. Removido.
Também entraram: matchesNormalizedAtWordStart deixou de fatiar/juntar palavra por palavra — como normalizeSearchPhrase emite exatamente words.join(' '), "começo de palavra" é a posição 0 ou depois de um espaço, então startsWith(q) || includes(' ' + q) diz o mesmo em 0,0011 ms contra 0,0585 ms por 435 rótulos (53×, equivalência verificada em 4.608 pares com apóstrofo, travessão, dígito e vazio); matchesAtWordStart normaliza a query primeiro e sai cedo na vazia, que é como os pickers filtram a lista inteira ao abrir; e buildMunicipalityPortfolioChips passou a copiar o municipalityIds do território ao montar o chip — aquele array é memoizado por índice e compartilhado por toda a tabela, então entregá-lo a um chamador transformava qualquer sort/splice posterior em corrupção da página inteira.
F7 — Cada toggle de chip re-renderiza a página inteira (374 SQL, 229 ms)
setLeadershipMunicipalitiesMembership chama revalidatePath('/campanha/liderancas', 'page') a cada toggle, e a célula grava uma action por toggle. O Next re-executa a página dentro da resposta da action: medido localmente, com 288 lideranças, 374 statements e 228,6 ms (loadLeadershipListPageData 371/183,3 ms + loadStateDeputyOptions 2/4,4 ms + loadMunicipalityPortfolioIndex 1/11,9 ms), mais ~44 kB de payload por toggle. Limpar um chip de território e adicionar três dispara isso quatro vezes — e localhost é piso: gru1↔sa-east-1 soma ~1–3 ms por round trip.
A célula já reconcilia contra o array do servidor e já faz rollback por delta em falha, então o refresh da lista não entrega nada que o usuário veja. Direção recomendada: dispensar o revalidatePath da própria lista no caminho de sucesso (mantendo o dos detalhes de município, que mudam de verdade) e deixar o estado otimista de pé até navegação. Não foi feito agora porque é mudança de comportamento em caminho de escrita e merece a sua própria medição pós-fix.
F8 — O índice de municípios é dado de referência lido sem cache
loadMunicipalityPortfolioIndex custa 12,4 ms medianos (1 SQL) e roda uma vez por request em duas rotas — e de novo em cada re-render disparado pelo F7. ~10 dos 12 ms são o transform por documento do Payload, não a query: pedir só slug no select não muda nada (10,7 ms).
Contra a escada de cache do repo: o degrau 1 (cache()) rende zero — é um único call site por request, dentro de um Promise.all. O degrau 2 (unstable_cache + tag) é o encaixe certo e não está em uso: nome/slug/região de município é geografia read-only semeada por migration, a definição de dado lento entre requests. Uma tag municipality-catalog no allowlist de revalidateRequest.ts tira 12 ms das duas rotas e de todo toggle.
Correção ao F1: a opção (b) "payload mínimo" encolhe o payload RSC de 35.510 B / 7.286 B gzip para 13.610 B / 3.534 B gzip, mas não poupa tempo de servidor nenhum (10,7 ms de qualquer jeito). A decisão registrada é payload-contra-bundle, não um ganho de servidor.
F9 ✓ — O ramo do assessor entrega uma chave nova ao WeakMap por linha
Fechado no /simplify do B37 ✓ (2026-07-28), pela segunda saída — e ela não ficou dentro da célula. searchIndex filtrava municipalityIndex quando há addableIds, produzindo um array novo por linha, e era esse array que virava a chave do WeakMap de derivações: 25 conjuntos (4 Maps cada) em vez de um, mais o build O(435) repetido na primeira busca de cada linha (1,89 ms para as 25 contra 0,076 ms para uma).
O filtro passou a ser scopedPortfolioIndex(index, addableIds) em src/lib/municipalityPortfolio.ts, memoizado num WeakMap aninhado por (index, addableIds) — as duas chaves são estáveis por request (o índice é montado uma vez pelo RSC; o Set de escopo também), então todas as linhas voltam a receber o mesmo array e a memoização de derivações volta a funcionar como escrita. Mora na lib, não na célula, porque a alternativa "WeakMap dentro do componente" seria uma segunda camada de cache ao lado da que já existe no mesmo módulo — e porque a primeira saída (addableIds como opção de searchMunicipalityPortfolio) muda a assinatura de uma função compartilhada para resolver um problema de identidade de array, que é o que um WeakMap já resolve.
F10 — O lote do lado do município escreve município por município (absorvido do B37 ✓)
Entrou por triage do /simplify do B37 ✓ (2026-07-28), como fase desta família e não como item novo, porque a função que a fase discute — setAdvisorMunicipalitiesBatchRecord — já é nomeada no F3 acima.
setStateDeputyMunicipalitiesBatchRecord e setAdvisorMunicipalitiesBatchRecord percorrem a relação invertida (o array mora em municipality.advisors/municipality.stateDeputies), e cada município do lote custa um findByID + um update com overrideAccess: false — a leitura existe porque o acesso por linha e por campo do Payload é o que escopa o assessor, e o update precisa do array inteiro. Os locks não são o problema (o C8 ✓ já os bateu em 1 round trip via unnest); o laço é. No teto do schema (435, elevado pelo próprio B37 para caber um TI inteiro) são ~870 round trips numa transação, cada um pagando ~1–3 ms de gru1↔sa-east-1 — e o int spec mais gordo do caminho usa lote de 2, então o comportamento acima de um punhado de municípios é inferido, não medido.
Não foi corrigido no fechamento porque o teto é inalcançável pelo produto de hoje: o maior lote que a UI oferece é um chip de território, e o maior TI da Bahia tem 26 municípios (Litoral Sul — medido em bahiaTerritories.ts, ~52 round trips). O gatilho é uma afordância de "selecionar tudo" / "aplicar a vários TIs" — quem construir isso mede antes: ou reescreve o laço em SQL bulk sobre a transação do Payload (precedente supporterImportBulk.ts, que já faz payload.db.drizzle em chunks dentro da transação aberta), ou mantém o laço e trava o lote num limite honesto abaixo do universo. Reescrever em bulk custa a checagem de escopo que o overrideAccess: false dá de graça hoje — ela teria de ser reimplementada explicitamente contra getAdvisorMunicipalityIds, que é exatamente o tipo de reimplementação de access que o repo evita, então a medição vem antes da escolha.
Segunda metade, com o mesmo gatilho: as duas actions são gêmeas (2 call sites). Fora o nome do campo, do lock e da mensagem, são a mesma sequência: parse, dedup+sort, transação, reloadStaffActor, locks em bloco, laço de leitura escopada + delta puro + update, coleta de slugs mudados, revalidate por delta. Está abaixo do limiar de 3 do AGENTS.md, e — diferente do F3, onde o algoritmo era idêntico — aqui o que se repete é uma sequência de orquestração cuja extração pediria parametrizar "de que lado da aresta eu escrevo", a fontanaria genérica que o F3 já rejeitou uma vez. Registrado para que um terceiro lote do lado do município não nasça como terceira cópia: quem o escrever extrai withMunicipalitySideRelationBatch({ relation, lockPrefix, computeNext }) primeiro, e fecha esta metade junto com a de cima.
F1 — Regressão de First Load JS nas duas listas (prioritário)
Medido contra main limpo (stash com -u, dois pnpm build completos, números como o Next reporta — minificados, não gzip):
| Rota | main | B34 | Δ |
|---|---|---|---|
/campanha/liderancas |
246 kB | 304 kB | +58 kB |
/campanha/assessores |
253 kB | 295 kB | +42 kB |
Ajuste pós-rebase (medido nas duas pontas, não inferido): adotar CampaignCellEditOverlay mexeu nisto, e para os dois lados. O chunk próprio de cada rota encolheu (assessores 6,58 → 4,05 kB; lideranças 6,89 → 6,46 kB), mas o First Load de assessores subiu 295 → 297 kB, enquanto lideranças ficou em 305 kB. A assimetria tem uma causa só: a casca arrasta CampaignHoverTooltip (o ramo Popover a usa para a tooltip do B23) para uma rota que ainda não tinha nenhum chamador de overlay — lideranças já tinha, pela coluna Status. Não muda a recomendação abaixo; muda a linha de base contra a qual ela será medida.
A decomposição importa e ninguém deve re-derivá-la: /campanha/assessores já importava o catálogo estático da Bahia antes do B34 (via advisorMunicipalityPortfolio.ts, o módulo que virou municipalityPortfolio.ts), então os +42 kB de lá são a célula em si — Drawer, links, o contrato de combobox, a máquina de medição. Os +16 kB restantes em lideranças são o catálogo (municipalityCatalog + bahiaTerritories + bahiaTseZones, ~40 kB min / ~12,9 kB gzip) chegando a uma rota que não o tinha. É exatamente o custo que o B14 ✓ já havia medido e nomeado (importar um serializador de URL no cliente custou 21 kB por um link).
Duas direções, e elas se opõem — escolher, não fazer as duas:
- (a) Catálogo fora do browser. O índice RSC passa a carregar
tseZonese a célula deixa de importarmunicipalityCatalog/bahiaTseZones. Ganha ~12,9 kB gzip de bundle em duas rotas; paga mais payload em todo render e em todo toggle de chip (a action revalida, o RSC re-serializa o índice inteiro). - (b) Payload mínimo. O loader devolve só
{ id, slug }(~13 kB crus contra ~45 kB) e nome/região/cidade saem do catálogo, que já está no bundle. Ganha em toda interação; mantém o bundle como está.
O staff edita muito e navega pouco, o que favorece (b) — o bundle é pago uma vez e fica em cache imutável, o payload é pago a cada toggle. A ressalva registrada é honesta: buildMunicipalityPortfolioChips hoje prefere de propósito o region do banco à resolução por slug do catálogo, "para os chips colaparem mesmo com divergência de alias entre ambientes". Essa justificativa é fraca — municipalityCatalog é snapshot-testado contra o catálogo semeado (tests/fixtures/municipality-catalog.snapshot.json), que é precisamente o guard que transforma divergência em teste vermelho — mas foi uma decisão deliberada, então a troca precisa de uma chamada explícita, não de um corte silencioso.
Parente, não duplicata — o rebase em main trouxe isto à vista: o B33+ já registra que /campanha/municipios embarca ~10 kB gzip do mesmo catálogo, e o gatilho de lá já disparou duas vezes (B41 ✓, B42 ✓) sem ninguém pagar. Os dois são a mesma classe de problema com causas opostas, e a correção não é a mesma: lá o catálogo entra por acidente (um isMunicipalitySlug em municipalityListUrl.ts arrasta o módulo inteiro para três componentes de filtro que só queriam um predicado), e o conserto é mover o predicado para um módulo client-safe; aqui ele entra de propósito, porque a célula precisa mesmo de nome/região/ZE, e o conserto é escolher quem carrega o dado — bundle ou payload. Quem atacar um não fecha o outro; quem atacar os dois deve fazê-lo na mesma passada, porque a medição de First Load JS das três rotas é a mesma bancada.
Um terceiro lance, ortogonal e cumulativo: carregar o Drawer por next/dynamic atrás do primeiro toque. Ele só abre em pointer-coarse, e uma gaveta que já anima pode absorver o import. Recupera parte dos +42 kB que atingem as duas rotas.
F2 ✓ — useChipRowOverflow: o gatilho disparou e a máquina foi copiada
Fechado no B37 ✓ (2026-07-28), e a previsão desta fase estava errada — vale registrar por quê. Estava escrito aqui que "o B37 não retira este débito: B37 pluga uma terceira relação na célula compartilhada sem máquina nova; quem fecha o F2 é quem deletar LeadershipStateDeputyRelationCell". O critique pós-implementação do B37 leu a mesma evidência ao contrário: se as duas células rodam na mesma tabela com a mesma máquina escrita duas vezes e contratos incompatíveis, então o B37 já era o 3º call site — e a resposta foi generalizar na hora em vez de registrar um quarto adiamento. src/components/campaign/shared/RelationChipCell.tsx nasceu como o motor único e as duas células viraram wrappers finos (MunicipalityPortfolioCell 816 → ~180 linhas; LeadershipStateDeputyRelationCell 450 → ~185), então as ~165 linhas que esta fase mediu não foram deduplicadas num hook, foram deletadas — não há mais duas cópias de medição, adoção por sameIdSet, expandToggle nem redutor otimista para extrair. O módulo do qual a cópia sobreviveu continua existindo, mas sem máquina dentro: o que resta nele é domínio (chips com sufixo de partido, FormData, copy).
Não reabrir como "extrair useChipRowOverflow": a medição vive uma vez, dentro do motor, e um hook separado só faria sentido para um terceiro consumidor que não seja uma célula de chips.
Descrição original (histórico): MunicipalityPortfolioCell e LeadershipStateDeputyRelationCell (B31 ✓) carregavam ~105 linhas idênticas de medição de overflow — as constantes, o guard de "não trate o primeiro callback do observer como resize", a invalidação por conteúdo, o filtro lastVisibleTop + 1, o laço de largura da cauda, o expandToggle com tabIndex={measuring ? -1 : undefined} — incluindo um comentário verbatim. As duas células são renderizadas pela mesma tabela.
A duplicação é anterior ao B34 (nasceu entre AdvisorMunicipalityCell e a célula do B31; esta entrega moveu uma das cópias para shared/), mas o AGENTS.md do B34 escreveu que "ele, não o B37, é o gatilho de extração" — e o gatilho disparou. Extrair useChipRowOverflow({ chipsKey, chipAttribute, toggleAttribute, trailingWidth, gapPx, enabled }) para shared/; a única diferença real entre os dois chamadores é o que ocupa o slot final (um botão de lápis com ref contra o min-width calculado do input), que vira o parâmetro.
A releitura pós-rebase alargou o alvo: são ~165 linhas, não ~105, e o nome está errado. Além da medição, os dois arquivos repetem a adoção de props por sameIdSet (~7/~12), o derivado showAll/measuring/clamping (~11/~15), o expandToggle (~32/~20) e o delta otimista com rollback por delta e toast (~39/~48). O que sai é useRelationChipCell — medição mais o redutor otimista —, e as duas metades da medição são idênticas até o + 1 de epsilon no lastVisibleTop. Consequência de planejamento: o B37 não retira este débito. B37 pluga uma terceira relação na célula compartilhada sem máquina nova; quem fecha o F2 é quem deletar LeadershipStateDeputyRelationCell, que é o módulo do qual a cópia sobreviveu.
O /simplify do B32+ ✓ mexeu nesta célula e mudou duas coisas para esta fase (2026-07-28). A região aria-live dela estava dentro do PopoverContent — o bug exato que o B32+ F4 corrigiu nos outros cinco controles, e que aqui deixava a falha e o "Salvando…" mudos justamente depois de fechar, que é quando a gravação acontece — e foi içada para fora do <Popover>, com role="status", já nesta forma: a migração não pode reintroduzi-la dentro do overlay. E o argumento de custo virou: CampaignCellEditOverlay já é usado por seis chamadores, então a parte "trigger + Popover" desta célula deixou de ser trabalho de extração e passou a ser adoção de casca pronta (inclusive o initialFocus e o aria-busy que ela não tem) — o que sobra de verdade nesta fase é a máquina de chips e o redutor otimista. Um detalhe da adoção, medido no B34: a folha do container é um Drawer sempre montado e reporta onOpenChange(false) quando qualquer dismiss varre a pilha de camadas, não só quando ela fecha.
F3 — Um só delta de membership (metade fechada)
A metade dos três deltas de um id foi fechada no /simplify do B37 ✓ (2026-07-28), e a recomendação invertida da segunda leitura se confirmou. nextStateDeputyIdsAfterMunicipalityMembership (nascido no B37) era a terceira cópia byte-a-byte do mesmo algoritmo de um id — os três diferiam só no teto que leem —, então ele vive uma vez em src/lib/relationMembershipDelta.ts (nextIdsAfterMembership(current, id, assigned, { max, message })) e os três nomes de domínio são wrappers de uma linha ligando o seu próprio cap. Os três specs clonados viraram um describe.each, e a cobertura subiu: cada relação agora recebe os casos "pode ir a zero" e "não muta a entrada" que só o clone do B37 tinha, mais a asserção explícita de que cada wrapper recusa no seu teto com a sua mensagem.
nextMunicipalityIdsAfterLeadershipMembership ficou de fora de propósito — é a forma "um conjunto com piso e teto", e a segunda leitura registrada acima (um genérico cobrindo as duas formas precisaria de quatro callbacks para poupar ~20 linhas) continua valendo depois de ver o código colapsado: o helper novo tem 12 linhas e nenhum parâmetro opcional.
Efeito colateral que era um bug latente, e a razão de o pareamento importar: duas das mensagens de teto eram literais crus repetidos em três lugares de src cada (lançada + dois allowlists independentes), e mapCampaignFormActionError casa mensagem lançada contra safeMessages por string exata — reescrever uma delas colapsaria silenciosamente uma recusa real em "tente novamente". Viraram constantes ao lado dos seus caps (LEADERSHIP_STATE_DEPUTIES_CAP_MESSAGE, MUNICIPALITY_ADVISORS_CAP_MESSAGE), seguindo o precedente MUNICIPALITY_STATE_DEPUTIES_CAP_MESSAGE que já existia nos mesmos arquivos. A mensagem de staff da dobradinha tinha a mesma exposição em quatro lugares — e actions/stateDeputy.ts já importava a constante enquanto reescrevia o literal uma linha abaixo — então é STATE_DEPUTY_STAFF_MESSAGE (renomeada: guarda create/update também, não só o lote), e a de conflito que ela divide com a rota de criação também tem nome.
Continua aberto nesta fase: o withLeadershipRelationDelta abaixo (política de escrita por delta sob lock consultivo numa linha de liderança).
Descrição original (histórico): nextMunicipalityIdsAfterLeadershipMembership é o terceiro módulo da família, e a generalização foi verificada exata, não aproximada: chamá-lo com um array de um elemento reproduz a semântica dos dois irmãos (nextStateDeputyIdsAfterMembership, nextAdvisorIdsAfterMembership) — assigned === alreadyAssigned → null equivale a added.length === 0 → null, e o teto checado antes do append equivale ao checado depois para um id. A única capacidade que os irmãos não têm é o piso, que já é opcional na forma. Colapsar em nextRelationMembershipIds(current, changed, assigned, { max, capMessage, min, floorMessage }), com os três nomes como wrappers de uma linha se o vocabulário importar; os três specs unitários viram um.
No mesmo arquivo, setLeadershipMunicipalitiesMembershipRecord e setLeadershipStateDeputyMembershipRecord são ~55 de ~90 linhas iguais e adjacentes, com três comentários copiados palavra por palavra. Um withLeadershipRelationDelta({ leadershipId, relation, lockKey, computeNext }) — local ao arquivo, não genérico entre collections — dono da transação, do lock, da leitura escopada e do early return de no-op, deixando ao chamador a asserção de escopo e a busca de slug. Precedente declarado: runStaffEntityMutation (política no helper, mutação tipada no chamador). São 2 call sites, abaixo do limiar de 3 — mas "escrita por delta sob lock consultivo numa linha de liderança" é uma política que merece nome, que é a outra metade da mesma regra.
Não estender ao lado do assessor: setAdvisorMunicipalitiesBatchRecord percorre a relação inversa (municipality.advisors), com N locks / N leituras / N updates sob bypass admin. Um helper cobrindo os dois teria de ser parametrizado por "de que lado da aresta eu escrevo", que é a fontanaria genérica que o repo já rejeitou uma vez.
F4 — Duas formas de view model para uma célula
leadershipData.ts estreitou certo (municipalityIDs: number[]), mas AdvisorsTable faz row.municipalities.map((m) => m.id) e joga name/slug fora — enquanto municipalitiesByAdvisorIds ainda roda um payload.find inteiro sobre municipality para produzi-los. A mesma decisão tomada de dois jeitos opostos na mesma entrega. Dar ao loader de lista um caminho só-ids (a forma {id,name,slug} continua para assessores/[id], que de fato renderiza os nomes). Se o F1 (b) entrar, cai junto: o cliente resolve tudo pelo catálogo.
F5 — Combobox à mão onde o kit já embrulha um (escopo reduzido pelo B37 ✓)
A metade "duplicada" morreu com o RelationChipCell (B37 ✓, 2026-07-28): os ~20 atributos repetidos entre as duas superfícies e as ~16 linhas de searchInputProps do F6 não existem mais — o input de busca e o listbox são escritos uma vez, no motor. O que resta são as ~90 linhas de teclado/ARIA num único lugar, o que melhora a economia da troca em vez de piorá-la: adotar ui/combobox.tsx passou a ser uma edição, não duas mantidas em sincronia. O argumento abaixo (fit parcial, anchor já previsto, cmdk corretamente fora) continua íntegro.
Descrição original (histórico): eram ~90 linhas de teclado/ARIA mais ~20 de atributos duplicados entre as duas superfícies. A restrição que descartaria a alternativa não se aplica: o cmdk Command está corretamente fora (ele resolve itens consultando [cmdk-item] dentro da própria raiz, e o listbox aqui precisa ser portalizado porque o container de scroll da tabela recorta uma lista em fluxo) — mas ui/combobox.tsx, que embrulha o Combobox do base-ui, já aceita anchor e tem um hook data-chips={!!anchor}, ou seja, foi escrito para exatamente esta forma: input dentro de uma linha de chips, listbox portalizado ancorado na célula. Fit parcial (hits heterogêneos — município/TI/ZE — e a recusa por teto pedem render de item próprio de qualquer jeito), então remove a metade de teclado/ARIA, não o todo.
F6 — Baixos
✓ ePortfolioChipLabel✓ — os dois eram "escrito duas vezes nas duas superfícies", e as duas superfícies passaram a ser uma com osearchInputProps(surface)RelationChipCell(B37 ✓): o rótulo do chip é umrenderChipLabeldo motor e o input de busca é montado uma vez. Nada a extrair.- e2e:
createStaffLeadership({ role, municipalities })eexpectPostResponse(page, fragment)emcampaignE2EFixtures.ts— 3 call sites hoje. relationIds()exportado detests/helpers/campaignFixtures.ts:typeof entry === 'number' ? entry : entry.idestá reescrito em 9 lugares nos int specs, comsrc/utilities/relationship.tsjá exportando o equivalente de produção. Débito anterior; o spec novo é a 9ª instância.loadMunicipalityPortfolioIndexfora da escada de cache: leitura do catálogo inteiro, de campos só-geografia, idêntica para todo ator e toda request, semcache()nemunstable_cache. Uma chamada por request hoje, então o degrau 1 não compra nada — mas o degrau 2 é a resposta da escada. Decidir, não deixar por omissão.- Duas respostas para "quais ids formam o TI T?": resolvido no fechamento (busca e colapso agora leem o mesmo
idsByTerritorydo índice vivo), masmunicipalityIdsForTseZonecontinua sendo o gêmeo de um laço que resolve slugs pelobySlug. Colapsa emmunicipalityIdsForEntries(entries, bySlug)quando alguém tocar o arquivo.
Fora de escopo (verificado, não é duplicação)
runCampaignFormAction está corretamente usado; matchesAtWordStart/normalizeSearchPhrase reusados sem normalizador paralelo; nenhum 4º call site da máquina de auto-save por debounce foi criado (o único setTimeout da célula é um deferral de 120 ms em onBlur, não um save — o débito B32+ segue com seus 3+1 call sites); CampaignListPendingBoundary não se aplica (a célula dispara uma action, não uma navegação); a detecção de ponteiro não ignorou nenhum hook (use-mobile.ts é por largura, e escolher pointer: é a tese do B34); e a extração de campaignHoverTooltip é a correção certa de um bug de RSC real, não duplicação.