docs(senato): dettaglio nominativo per ogni voto tranne la segreta#53
Merged
Conversation
…a segreta Verifica empirica (leg.19): senato-vote-detail restituisce le righe per-senatore per TUTTE le modalità di osr:tipoVotazione, non solo 'nominale con appello'. L'unica eccezione è il voto SEGRETO, che alla fonte non registra la scelta: torna solo le presenze (Presente non votante, In congedo/missione), mai Favorevole/Contrario. Il segnale 'roll_call_available' non serve come campo nuovo: è derivabile da type !== 'segreta', già esposto da senato-votes. - senato-vote-detail: description col caveat voto segreto (agent-friendly) - wiki votazione-tipo-semantico.md: tabella dettaglio per tipo + nota STR() - skill CLI + MCP: nota voto segreto Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
| Filename | Overview |
|---|---|
| docs/lod-wiki/senato/votazione-tipo-semantico.md | Adds the Senato vote-detail table and the practical rule for merit votes versus presence-only vote types. |
| skills/italian-parliament-cli/SKILL.md | Adds CLI guidance for when senato-vote-detail can answer individual vote-choice questions. |
| skills/italian-parliament-mcp/SKILL.md | Adds MCP workflow guidance for handling secret ballots and quorum checks in Senato vote-detail answers. |
| src/tools/senato-vote-detail.ts | Updates the tool description to warn callers that expressed choices are only recorded for merit votes. |
Reviews (3): Last reviewed commit: "docs(senato): includi Astenuto tra le sc..." | Re-trigger Greptile
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
There was a problem hiding this comment.
Pull request overview
Questo PR aggiorna la documentazione e le descrizioni/skill relative ai voti del Senato per chiarire che senato-vote-detail restituisce righe nominative anche oltre il solo “nominale con appello”, e introduce un caveat esplicito sul caso del voto segreto per ridurre il rischio di confabulazione (nessun sì/no individuale registrato alla fonte).
Changes:
- Aggiornata la
descriptiondisenato-vote-detailcon un avviso sui votitype="segreta". - Estese le skill (MCP + CLI) con una nota operativa su come riportare correttamente i voti segreti.
- Arricchita la pagina LOD wiki sul
tipoVotazionecon tabella e regole pratiche per orchestratori/LLM.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.
| File | Description |
|---|---|
| src/tools/senato-vote-detail.ts | Aggiorna la descrizione del tool con caveat sul voto segreto (riduzione rischio di inferenze errate). |
| skills/italian-parliament-mcp/SKILL.md | Nota operativa (pipeline “who voted how”) per gestire correttamente type=segreta. |
| skills/italian-parliament-cli/SKILL.md | Nota breve nel vademecum CLI per evitare inferenze su votazioni segrete. |
| docs/lod-wiki/senato/votazione-tipo-semantico.md | Documenta semantica di osr:tipoVotazione, tabella per tipo, e regola pratica per LLM/orchestratore. |
…individuale
Greptile (P1) + Copilot: la regola diceva type !== segreta, ma anche
verifica numero legale (conteggio del quorum) registra solo presenze,
mai Favorevole/Contrario — come già indicava la tabella. Verificato:
- controprova 19-410-27: 89 Contrario + 46 Favorevole (voto di merito)
- verifica num. legale 19-334-1: solo presenze, 0 Favorevole/Contrario
Segnale corretto: la scelta individuale c'è per i voti di merito
(elettronica, nominale con appello, controprova), NON per segreta e
verifica numero legale → type non in {segreta, verifica numero legale}.
- allineati tool description, wiki, skill CLI+MCP
- wiki timestamp 2026-07-07 → 2026-07-11 (Copilot)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…tipizzato Copilot (2ª passata): - La scelta espressa include anche Astenuto, non solo Favorevole/Contrario. Su segreta e verifica numero legale mancano tutte e tre (solo presenze). - Nota Virtuoso: aggiunta la forma con literal tipizzato osr:tipoVotazione "elettronica"^^xsd:string come alternativa a STR() (verificato: 7821 con tipizzato vs 0 con literal semplice). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Chiude il punto A della gap analysis (segnale
roll_call_available), ma ribaltando la premessa iniziale grazie a una verifica empirica.Cosa è stato verificato (leg. 19, endpoint live)
Ipotesi di partenza: "il dettaglio per-senatore esiste solo per i voti
nominale con appello". Falsa.senato-vote-detailrestituisce le righe per-senatore per tutte le modalità diosr:tipoVotazione. La differenza vera è cosa contengono:typeelettronicanominale con appellocontroprovaverifica numero legalesegretaPresente non votante/In congedo/missioneProva sul voto segreto
19-155-52: 15Presente non votante+ 21In congedo/missione, zero Favorevole/Contrario. Corretto: il voto segreto registra la presenza, non la scelta.Decisione: niente campo nuovo
Il segnale "posso sapere come ha votato il singolo senatore?" è semplicemente
type !== "segreta", ed è derivabile dal campotypechesenato-votesgià espone. Coerente con la convenzione del progetto (niente flag nuovo se derivabile). Si chiude quindi documentando la regola, non aggiungendo schema.Modifiche
senato-vote-detail—descriptioncon il caveat sul voto segreto (segnale agent-friendly per l'LLM: susegretanon dedurre il sì/no).docs/lod-wiki/senato/votazione-tipo-semantico.md— tabella del dettaglio per tipo + nota VirtuosoSTR()sul literal tipizzato.Nessuna modifica al comportamento runtime.
🤖 Generated with Claude Code