Add normalized CSV read mode for ragged clean inputs

[Gabrymi93]

Sintesi

Questa PR aggiunge una nuova opzione esplicita per il reader CLEAN:

• clean.read.normalize_rows_to_columns: true

Serve per leggere CSV con schema posizionale dichiarato quando alcune righe, file o annualita hanno meno colonne del layout canonico atteso. Il comportamento resta opt-in e non cambia il default del toolkit.

Contesto collegato

Closes #11

Cosa cambia

• aggiunge clean.read.normalize_rows_to_columns come opzione supportata di clean.read
• normalizza le righe CSV piu corte fino al numero di colonne dichiarato in clean.read.columns
• mantiene stabile il mapping posizionale nel clean.sql per fonti multi-file o multi-anno quasi stabili ma non perfettamente uniformi
• aggiorna documentazione e schema config
• aggiunge test mirati sul reader CLEAN

Impatto

Segna solo quello che si applica.

• Documentazione o testi
• Policy GitHub o template
• Codice o automazioni
• Pipeline dati o trasformazioni
• Contenuti o metadati di dataset
• Nessun impatto visibile per chi usa il repository

Verifica

Eseguito:

py -m pytest tests/test_clean_duckdb_read.py -q

Esito:

• 14 passed

Validato anche su un caso reale di dataset pubblico multi-anno con schema posizionale quasi stabile, emerso durante il lavoro su IRPEF comunale.

Controlli

• Questa PR e' nel repository giusto
• Ho collegato issue o discussion quando serve
• Ho verificato l'impatto su documentazione, codice o dati
• Ho aggiornato solo quello che era davvero necessario

Note per chi revisiona

Punti da controllare con attenzione:

• la feature deve restare strettamente opt-in
• ha senso solo insieme a clean.read.columns
• non sostituisce la lettura standard per named columns stabili
• il caso d'uso corretto e: schema posizionale esplicito + righe piu corte del layout atteso