LOG
- Release v0.3.0:
whichcerca anche nelle colonne dei report, nuova funzioneopensituas.which()nella libreria, skillsituas-explorercorretta sui dati reali, sezione Agent quickstart nel README. whichcerca anche nelle colonne dei report: indicesrc/opensituas/which_index.json(nome + etichetta delle colonne di 77 report, 35 KB) incluso nel pacchetto e rigenerato conscripts/build_which_index.py, passo aggiunto adocs/release.mde alla skillrelease. Prima cercava solo nei titoli: «popolazione e superficie dei comuni» proponeva 129, 307, 50 invece di 74, e due esempi documentati sbagliavano («popolazione» senza risultati, «province cessate» senza il 112).- Ricerca in
_which.py: parole vuote italiane ignorate, radice comune (soppresse/soppressi), sinonimi minimi (cessati, fusioni, montagna, abitanti, estensione), titolo 3 punti e colonne 1, a parità prima i report comunali. La ricerca non usa la rete; il catalogo si carica come percatalog(cache, gateway, snapshot). - Test
tests/test_which_search.pysui 21 casi verificati, rossi prima del fix; 88 test verdi. Esempio «comuni per anno» sostituito: non individuava un report preciso. opensituas.which()aggiunto alla libreria: CLI e libreria usanoservice.which_records, stesso risultato (test di parità). Principio: ogni comando dati della CLI ha la sua funzione nella libreria.- Revisione Greptile della PR #5: corretta la docstring di
which()che prometteva «senza rete»;scripts/build_which_index.pylegge il catalogo dal gateway senza ripieghi su cache o snapshot, ed esce senza scrivere se non è disponibile; i metadati usano lo stesso catalogo scaricato (service.report_info(..., catalog=)), così una cache vecchia non blocca i report nuovi (testtests/test_build_which_index.py). - Lo snapshot del catalogo incluso ha 74 report, il catalogo online 77 (466, 467, 469): non aggiornato qui.
- Aggiunta al README la sezione
Agent quickstart: prompt da incollare in un agente, con verifica o installazione su conferma, lettura dell'help, una chiamata reale (cerca-codice comune Ledro, provata a mano il 2026-11-15 con v0.2.0) e regole su date, validità, zeri iniziali e nomi ambigui. Prompt non ancora provato in una sessione pulita di un agente.
- Skill
situas-explorercorretta sui dati reali:AREE_INT_2020contiene solo la lettera (F, nonF-Ultraperiferico: il filtro dava zero righe, anche nella demo web),MACRO_AI_2020èI/C, le zone montane sono0/1, Sesto San Giovanni è015209(015179è Pregnana Milanese). Non esiste un codice variazione «fusione»: l'esempio sulle fusioni del 2016 ora conta i nuovi comuniCS(27), non le righe (313). - Release v0.2.0: prima versione pubblicata con la libreria Python. Tolta dal README la nota che descriveva l'API come non ancora su PyPI.
- Skill di progetto
release(.claude/skills/release/SKILL.md, invocabile solo a mano con/release [patch|minor|major|X.Y.Z]): seguedocs/release.mdcon controlli bloccanti (main allineato, tag e versione PyPI liberi, ruff, pytest,twine check, versione della wheel installata) e una conferma prima di push, GitHub release e PyPI. Build intmp/release-distinvece didist/.__version__era fermo a0.1.0con il pacchetto a0.1.2: ora lo leggeimportlib.metadata, con test intests/test_version.py. Tolto il permesso automaticotwine uploaddasettings.local.json: la conferma la chiede la skill. - Libreria Python nel branch
feat/python-library:catalog,get,storiaecerca_codicerestituiscono DataFrame pandas;inforestituisce un dizionario ecountun intero validato. Codici testuali e zeri iniziali preservati. - Servizio condiviso estratto dalla CLI, che conserva output, envelope ed exit code; modulo interno rinominato
_catalog.pyper liberare la funzione pubblicacatalog. - Aggiunta dipendenza
pandas>=2.0, aggiornati README, architettura, specifica e piano. Nessun aggiornamento versione o pubblicazione PyPI. - Autorizzati commit, push del branch e apertura di una Pull Request verso
main; merge e release restano esclusi. - Verifiche: 62 test passati (baseline 29), Ruff pulito; wheel/sdist costruiti e wheel installata in venv temporaneo con snapshot incluso. Review locale senza revisore indipendente; nessuna chiamata live SITUAS. Ambiente test: Python 3.14.0, pandas 3.1.1.
- Fix
info: l'endpointINFO_LINKnel catalogo portapdata=<inizio validità>e l'API restituiva i metadati dell'epoca, non quelli attuali. Per pfun 74 (Comuni - Dimensione) mancavanoAREA_KMQ,POP_RES,ANNO_POP_RES,COD_PROV_STORICO. Fix:info_cmdapplica oraapply_date(..., default_date=validity_end(entry))sull'INFO_LINK, come già facevaget_cmdper loSPOOL_LINK. 15 colonne restituite invece di 10 per pfun 74. - Skill
situas-explorerarricchita: Fase 2 con snippet jq per nome/tipo/descrizione campi; sette casi d'uso per giornalisti e analisti (master table codici, normalizzazione comune, aree interne e policy, storia variazioni, traslazione codici tra date, SLL e specializzazione produttiva, Cities/FUA/NUTS3 europei). - README: aggiunta sezione "Casi d'uso" con gli stessi sette scenari e comandi copiabili.
- Aggiunti comandi
agent-contextewhichper l'auto-orientamento degli agenti AI.agent-contextemette un JSON versionato (schema_version,cli,commandscon flag e exit code contract) senza chiamate di rete.which <query>cerca report SITUAS per token su titolo/ambito/unità e restituiscecomando_suggeritocon date di default; exit 2 se nessun match. 11 nuovi test verdi; ruff pulito. - Release 0.1.0 su PyPI.
pyproject.tomlallineato a opensdmx: aggiuntiauthors,keywords,classifiers, gruppodev(pytest, ruff),[tool.ruff.lint], pinuv_build. AggiuntiLICENSE(MIT) edocs/release.md. Fix ruffF841(variabilecfgnon usata interritorial.py). Repo reso pubblico. 18 test verdi, ruff pulito. - Simulazione uso giornalistico: testati end-to-end tutti i comandi con chiamate API reali.
- Fix comportamento data di default: per i report
DATA,get/countsenza--dateora usano la fine validità (dato più recente), non l'inizio. Primacount 61dava i comuni del 1948 (7688) invece di oggi (7894). Aggiuntecatalog.validity_end()e parametrodefault_dateadapply_date. Help diget/count, SKILL e README aggiornati. - Fix
cerca-codice: per gli omonimi (es. Samone) la LOV ripete lo stessoRCsu più voci; il tool iterava per match e duplicava i record (Samone 12 invece di 6) con chiamate di rete ridondanti. Ora deduplica perRC: record corretti e metà richieste. docs/tutorial-giornalisti.md: 5 casi d'uso verificati (serie storica comuni, fusioni e cambi nome viastoria, province soppresse,cerca-codice/omonimi, export CSV).- Test: pytest non era nel venv; reinstallato. Suite da 14 → 18 verdi (4 nuovi su default_date).
- Help ottimizzato per agenti:
--outputcome enum (table|json|csv, validato), epilog top-level con il contratto agente (-o json, exit code, workflow), esempi per ogni comando. - Primo rilascio
opensituasv0.1.0. - API SITUAS mappate via curl + agent-browser (tracciamento traffico delle pagine SPA).
- Comandi catalogo:
catalog/list,info,get,count(74 report; date dai link pre-validati; enveloperesultset/items; errori in HTTP 200 viaERRCODE). - Comandi territoriali:
storia(comune/provincia/regione, con--dettaglio) ecerca-codice. Per regioni/uts la storia unisce le forme storiche con lo stesso codice. - Scoperta chiave: i servizi
ricercacodice_*richiedono headerReferer; il catalogo si ottiene solo via gateway POST (publish dà 401). ricostruzione-codicidel portale = UI sui report di catalogoPERIODO(nessun endpoint nuovo), coperta daget/count.- Output
table/json/csv; cache catalogo 7 giorni + snapshot incluso. 13 test verdi.