feat(senato-votes): emptyHint dinamico con sonda del grafo

[aborruso]

Contesto

Dal report news-agent docs/news-agent/2026-07-15_12-08.md (rilievo P0). L'emptyHint di senato-votes era una stringa statica: su ogni risultato vuoto ripeteva tre blocchi fissi (--ddl-uri, filtri label, buco COVID 10/3–16/4/2020), anche fuori contesto. Cercando la fiducia Milleproroghe (--date-from 2020-02-26 --confidence-vote) l'agente vedeva l'avviso su una finestra che non interseca il 26/2 e il testo su --ddl-uri mai usato → rumore diagnostico che confonde chi legge.

Approccio: osservare, non ricordare

Invece di elencare buchi noti (fragile: sul 26/2 indovinerebbe male), sui risultati vuoti con vincolo di data execute() sonda il grafo al volo e riporta lo stato reale. Meccanismo: result.hint (dinamico) ha già precedenza su emptyHint statico su MCP e CLI — nessuna modifica infrastrutturale.

Sonda = 2 COUNT leggeri (osr:SedutaAssemblea + osr:Votazione) sull'intervallo. Tre esiti:

Osservazione	Hint
sedute=0	nessuna seduta d'Assemblea: probabilmente non si è votato in Aula (o non caricato)
sedute>0, votazioni=0	fingerprint di un buco della fonte — rileva il gap #36 dinamicamente, su qualsiasi data, senza hardcode
votazioni>0	dato pieno, è il filtro (caso 26/2: 21 voti ma nessuna fiducia)

Il caso Milleproroghe cade da solo nella riga giusta senza sapere in anticipo che il 26/2 è un buco — ed è un buco diverso dal COVID (9/4 ha zero voti, 26/2 ne ha 21 ma manca la fiducia): la sonda li separa.

Dettagli

• Gate sonda: dateFrom|dateTo + !ddlUri + offset === 0 (oltre l'ultima pagina la sonda affermerebbe il falso, "N voti ma nessuno matcha").
• emptyHint statico ridotto a fallback neutro: niente più buchi hardcoded → una sola fonte di verità.
• Funzione pura buildSenatoVotesEmptyHint estratta e testata.

Verifica

• tsc pulito, 170/170 test (8 nuovi unitari sui 3 rami sonda + senza-date).
• CLI live su 5 contesti (leg 18/19, singola data e range, offset 0/100):
  • 26/2/2020 --confidence-vote → "21 votazioni… ma nessuna corrisponde ai filtri attivi"
  • 10/3–16/4/2020 → "9 sedute… ma ZERO votazioni… buco della fonte"
  • 15/8/2020 → "non risulta alcuna seduta d'Assemblea"
  • --offset 100 oltre l'ultima pagina → hint statico, nessuna falsa affermazione

Fuori scope

• build:worker + deploy (la modifica è live via MCP solo dopo deploy).
• Eventuale issue di advocacy-dati sul 26/2 (pattern ≠ Gap dataset Senato: votazioni assenti per mar-apr 2020 (leg.18) — nota wiki + emptyHint + segnalazione gestore #36).

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Questo PR migliora la diagnostica del tool senato-votes (CLI + MCP) quando una query restituisce 0 righe, sostituendo l’emptyHint statico e “rumoroso” con un hint dinamico data-driven basato su una sonda leggera del grafo Senato (2 COUNT) sull’intervallo di date richiesto. L’obiettivo è ridurre falsi indizi e distinguere in modo affidabile tra “nessuna seduta”, “sedute senza votazioni” (gap della fonte) e “ci sono votazioni ma i filtri escludono tutto”.

Changes:

• Introdotta una sonda SPARQL (sedute/votazioni) eseguita solo su risultati vuoti con vincolo di data, offset===0 e senza ddlUri, e usata per costruire result.hint.
• Ridotto emptyHint statico a fallback neutro; estratta funzione pura buildSenatoVotesEmptyHint per comporre messaggi coerenti e testabili.
• Aggiunti test unitari mirati per i tre rami della sonda + fallback senza sonda; aggiornato LOG.md.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
src/tools/senato-votes.ts	Aggiunge sonda “COUNT sedute/votazioni” su path vuoto con date e costruzione di result.hint dinamico; riduce emptyHint statico a fallback neutro.
src/tools/senato-votes.test.ts	Introduce test unitari per buildSenatoVotesEmptyHint coprendo rami con/senza sonda.
LOG.md	Registra la modifica in log con contesto e verifica.

[greptile-apps]

Greptile Summary

This PR adds live diagnostics for empty senato-votes results. The main changes are:

• Counts Senate sessions and votes for the requested date range.
• Produces a contextual hint from the observed graph state.
• Falls back to a neutral hint when the optional probe fails.
• Combines both counts into one SPARQL request.
• Adds unit tests and documentation for the three diagnostic states.

Important Files Changed

Filename	Overview
src/tools/senato-votes.ts	Adds the graph probe, contextual empty-result hints, safe probe fallback, and a combined aggregate query.
src/tools/senato-votes.test.ts	Covers the three probe outcomes and the static hint variants.
docs/lod-wiki/senato/vuoto-votazioni-diagnosi.md	Documents how session and vote counts distinguish the three empty-result states.

_{Reviews (3): Last reviewed commit: "fix(senato-votes): sonda resiliente e a ..." | Re-trigger Greptile}