/** * Research-contract validation for the city report (C163). * * The web layer of the report is written by the agent as a JSON file; this * module is the guard: every checklist item either carries a date + URL or * becomes an explicit gap. "Sem fonte, não publica" is enforced here, before * the renderer ever sees the data. */ import { DAY_MS } from '../../src/lib/text.ts' const RESEARCH_NEWS_WINDOW_DAYS = 90 const RESEARCH_CHECKLIST = [ { id: 'prefeito', label: 'Prefeito(a) — nome, partido, federação, situação' }, { id: 'vice', label: 'Vice-prefeito(a) — nome, partido' }, { id: 'relacao_campo', label: 'Relação com o campo (aliado, oposição, neutro)' }, { id: 'vereadores', label: 'Vereadores e dobradas' }, { id: 'disputa_local', label: 'Disputa local' }, { id: 'quem_investe', label: 'Quem mais investe na cidade (bancada e adversários)' }, { id: 'noticias', label: 'Notícias da cidade/região (janela ≤90 dias)' }, { id: 'imprensa_local', label: 'Imprensa e rádio local' }, { id: 'emendas_web', label: 'Emendas — indícios web (município, região ou polo)', }, ] export const RESEARCH_CHECKLIST_IDS = RESEARCH_CHECKLIST.map((item) => item.id) const checklistById = new Map(RESEARCH_CHECKLIST.map((item) => [item.id, item])) const isNonEmptyString = (value) => typeof value === 'string' && value.trim() !== '' const isValidDate = (value) => isNonEmptyString(value) && !Number.isNaN(Date.parse(value)) const inNewsWindow = (publishedAt, reference) => Date.parse(publishedAt) >= reference.getTime() - RESEARCH_NEWS_WINDOW_DAYS * DAY_MS && Date.parse(publishedAt) <= reference.getTime() + DAY_MS /** * Validates/normalizes the agent-written research JSON. * * Structural failures (no slug, no research date) throw — the operator has to * fix the file. Content failures (missing source, stale news, unknown item) * degrade to explicit gaps, which the report prints as such. */ export const normalizeResearchInput = (raw, { now = new Date() } = {}) => { if (!raw || typeof raw !== 'object') { throw new Error('Pesquisa inválida: o arquivo precisa ser um objeto JSON.') } if (!isNonEmptyString(raw.municipalitySlug)) { throw new Error('Pesquisa inválida: falta "municipalitySlug".') } if (!isValidDate(raw.researchedAt)) { throw new Error( 'Pesquisa inválida: falta "researchedAt" (ISO) — a pesquisa precisa ser datada.', ) } const researchedAt = new Date(raw.researchedAt) const reference = now instanceof Date ? now : new Date(now) const gaps = [] const items = [] const seen = new Set() for (const entry of Array.isArray(raw.items) ? raw.items : []) { const id = typeof entry?.id === 'string' ? entry.id : null if (!id || !checklistById.has(id)) { gaps.push({ id: id ?? 'desconhecido', label: id && checklistById.get(id)?.label, reason: 'Item fora do checklist de pesquisa.', }) continue } seen.add(id) const answer = isNonEmptyString(entry.answer) ? entry.answer.trim() : null const sourceUrl = isNonEmptyString(entry.sourceUrl) ? entry.sourceUrl.trim() : null const sourceDate = isValidDate(entry.sourceDate) ? entry.sourceDate : null if (!answer) { gaps.push({ id, label: checklistById.get(id).label, reason: 'Não pesquisado.' }) continue } if (!sourceUrl || !sourceDate) { gaps.push({ id, label: checklistById.get(id).label, reason: 'Sem fonte: cada item exige URL e data.', }) continue } const extraSources = [] for (const extra of Array.isArray(entry.extraSources) ? entry.extraSources : []) { const extraUrl = isNonEmptyString(extra?.url) ? extra.url.trim() : null const extraDate = isValidDate(extra?.date) ? extra.date : null if (!extraUrl || !extraDate) { gaps.push({ id: 'fonte_extra', label: checklistById.get(id).label, reason: 'Fonte adicional sem URL ou data — descartada.', }) continue } extraSources.push({ label: isNonEmptyString(extra.label) ? extra.label.trim() : null, url: extraUrl, date: extraDate, }) } items.push({ id, label: checklistById.get(id).label, answer, details: isNonEmptyString(entry.details) ? entry.details.trim() : null, sourceUrl, sourceDate, extraSources, consultedAt: isValidDate(entry.consultedAt) ? entry.consultedAt : null, }) } for (const entry of Array.isArray(raw.gaps) ? raw.gaps : []) { if (isNonEmptyString(entry?.reason)) { const id = isNonEmptyString(entry.id) ? entry.id : 'lacuna' // A gap declared by the agent already accounts for the checklist item — // otherwise the item would show up twice ("Não pesquisado." + the real gap). if (checklistById.has(id)) seen.add(id) gaps.push({ id, label: isNonEmptyString(entry.label) ? entry.label : null, reason: entry.reason.trim(), }) } } for (const checklistItem of RESEARCH_CHECKLIST) { if (!seen.has(checklistItem.id)) { gaps.push({ id: checklistItem.id, label: checklistItem.label, reason: 'Não pesquisado.' }) } } const news = [] for (const entry of Array.isArray(raw.news) ? raw.news : []) { const title = isNonEmptyString(entry?.title) ? entry.title.trim() : null const url = isNonEmptyString(entry?.url) ? entry.url.trim() : null const publishedAt = isValidDate(entry?.publishedAt) ? entry.publishedAt : null if (!title || !url || !publishedAt) { gaps.push({ id: 'noticia_sem_fonte', reason: 'Notícia sem título, URL ou data — descartada.', }) continue } if (!inNewsWindow(publishedAt, reference)) { gaps.push({ id: 'noticia_fora_da_janela', label: title, reason: `Fora da janela de ${RESEARCH_NEWS_WINDOW_DAYS} dias — descartada.`, }) continue } news.push({ title, outlet: isNonEmptyString(entry.outlet) ? entry.outlet.trim() : null, publishedAt, url, summary: isNonEmptyString(entry.summary) ? entry.summary.trim() : null, }) } const approach = [] for (const entry of Array.isArray(raw.approach) ? raw.approach : []) { const topic = isNonEmptyString(entry?.topic) ? entry.topic.trim() : null const suggestion = isNonEmptyString(entry?.suggestion) ? entry.suggestion.trim() : null const sourceUrl = isNonEmptyString(entry?.sourceUrl) ? entry.sourceUrl.trim() : null const sourceDate = isValidDate(entry?.sourceDate) ? entry.sourceDate : null if (!topic || !suggestion) { gaps.push({ id: 'abordagem_incompleta', label: topic, reason: 'Sugestão sem tema ou texto — descartada.', }) continue } if (!sourceUrl || !sourceDate) { gaps.push({ id: 'abordagem_sem_fonte', label: topic, reason: 'Sugestão sem fonte: URL e data são obrigatórias.', }) continue } approach.push({ persona: isNonEmptyString(entry.persona) ? entry.persona.trim() : null, topic, suggestion, sourceUrl, sourceDate, consultedAt: isValidDate(entry.consultedAt) ? entry.consultedAt : null, }) } const preCandidates = [] for (const entry of Array.isArray(raw.preCandidates) ? raw.preCandidates : []) { const name = isNonEmptyString(entry?.name) ? entry.name.trim() : null const office = isNonEmptyString(entry?.office) ? entry.office.trim() : null const sourceUrl = isNonEmptyString(entry?.sourceUrl) ? entry.sourceUrl.trim() : null const sourceDate = isValidDate(entry?.sourceDate) ? entry.sourceDate : null if (!name || !office) { gaps.push({ id: 'precandidato_incompleto', label: name, reason: 'Pré-candidato sem nome ou cargo — descartado.', }) continue } if (!sourceUrl || !sourceDate) { gaps.push({ id: 'precandidato_sem_fonte', label: name, reason: 'Pré-candidato sem fonte: URL e data são obrigatórias.', }) continue } preCandidates.push({ name, office, party: isNonEmptyString(entry.party) ? entry.party.trim() : null, support: isNonEmptyString(entry.support) ? entry.support.trim() : null, note: isNonEmptyString(entry.note) ? entry.note.trim() : null, sourceUrl, sourceDate, }) } const leaders = [] for (const entry of Array.isArray(raw.leaders) ? raw.leaders : []) { const name = isNonEmptyString(entry?.name) ? entry.name.trim() : null const role = isNonEmptyString(entry?.role) ? entry.role.trim() : null const sourceUrl = isNonEmptyString(entry?.sourceUrl) ? entry.sourceUrl.trim() : null const sourceDate = isValidDate(entry?.sourceDate) ? entry.sourceDate : null if (!name || !role) { gaps.push({ id: 'lideranca_incompleta', label: name, reason: 'Liderança sem nome ou papel — descartada.', }) continue } if (!sourceUrl || !sourceDate) { gaps.push({ id: 'lideranca_sem_fonte', label: name, reason: 'Liderança sem fonte: URL e data são obrigatórias.', }) continue } leaders.push({ name, role, party: isNonEmptyString(entry.party) ? entry.party.trim() : null, period: isNonEmptyString(entry.period) ? entry.period.trim() : null, note: isNonEmptyString(entry.note) ? entry.note.trim() : null, sourceUrl, sourceDate, }) } const sourcedLists = { demography: [], economy: [], transport: [] } for (const key of Object.keys(sourcedLists)) { for (const entry of Array.isArray(raw[key]) ? raw[key] : []) { const topic = isNonEmptyString(entry?.topic) ? entry.topic.trim() : null const detail = isNonEmptyString(entry?.detail) ? entry.detail.trim() : null const sourceUrl = isNonEmptyString(entry?.sourceUrl) ? entry.sourceUrl.trim() : null const sourceDate = isValidDate(entry?.sourceDate) ? entry.sourceDate : null if (!topic || !detail) { gaps.push({ id: `${key}_incompleto`, label: topic, reason: 'Item sem tema ou dado — descartado.', }) continue } if (!sourceUrl || !sourceDate) { gaps.push({ id: `${key}_sem_fonte`, label: topic, reason: 'Item sem fonte: URL e data são obrigatórias.', }) continue } sourcedLists[key].push({ topic, detail, sourceUrl, sourceDate, consultedAt: isValidDate(entry.consultedAt) ? entry.consultedAt : null, }) } } return { municipalitySlug: raw.municipalitySlug.trim(), researchedAt: researchedAt.toISOString(), items, news, approach, preCandidates, leaders, demography: sourcedLists.demography, economy: sourcedLists.economy, transport: sourcedLists.transport, gaps, } } export const researchItemById = (research, id) => research.items.find((item) => item.id === id) ?? null