Release v2.1.5 - Legal Notice for Text Authenticity

- Added legal notice to README about Normattiva text authenticity
- Added legal warning panel to CLI help output (Rich formatted)
- Added legal_notice field to YAML front matter in generated documents
- All three locations provide consistent message about non-official status
- Updated LOG.md with 2026-01-02 entry

This is a patch release (v2.1.4 → v2.1.5) for legal compliance.
No breaking changes - informational notice only.

Author: aborruso

LOG.md

@@ -1384,5 +1384,29 @@ Creata pianificazione completa per rendere normattiva2md usabile da notebook e s
 **Compatibilità:** 100% backward compatible - CLI funziona esattamente come prima
 
 **Prossimo step:** Review pianificazione → implementazione Fase 1 (Foundation)
+## 2026-01-02
+
+### Aggiunta Avviso Legale su README, CLI e Front Matter
+
+**Conformità legale:** Aggiunto avviso legale prominente sullo status ufficiale dei documenti
+
+**Modifiche implementate:**
+- **README.md**: Nuova sezione `⚠️ Avvertenza legale` subito dopo introduzione
+- **cli.py - Rich help**: Panel visuale rosso/giallo con avvertenza alla apertura help
+- **cli.py - argparse epilog**: Avvertenza anche nel footer standard `--help`
+- **markdown_converter.py**: Campo `legal_notice` nel front matter YAML di ogni documento
+
+**Avviso fornito:**
+- I testi presenti in Normattiva non hanno carattere di ufficialità
+- L'unico testo ufficiale è quello pubblicato sulla Gazzetta Ufficiale Italiana
+- Utilizzo solo a scopo informativo
+
+**Posizionamento strategico:**
+1. Prima di usare il tool → README
+2. Quando richiede aiuto → CLI
+3. Nel documento generato → Front matter YAML
+
+**Impatto:** Nessuno breaking change, avvertenza informativa, importante per conformità legale
+
 ## 2026-01-01
 - Improved CLI help output with Rich library for better readability and organization

README.md

@@ -6,6 +6,16 @@
 
 **Normattiva2MD** è uno strumento da riga di comando progettato per convertire documenti XML in formato **Akoma Ntoso** (in particolare le norme pubblicate su `normattiva.it`) in documenti **Markdown** leggibili e ben formattati. L'obiettivo principale è offrire un formato compatto e immediatamente riutilizzabile quando le norme devono essere fornite come contesto a un **Large Language Model (LLM)** o elaborate in pipeline di Intelligenza Artificiale.
 
+## ⚠️ Avvertenza legale
+
+**I testi presenti nella banca dati "Normattiva" non hanno carattere di ufficialità.**
+
+**L'unico testo ufficiale e definitivo è quello pubblicato sulla Gazzetta Ufficiale Italiana a mezzo stampa, che prevale in casi di discordanza.**
+
+Gli utenti di questo strumento devono essere consapevoli che i documenti convertiti da normattiva.it sono forniti a scopo informativo e non hanno valore legale ufficiale. Per qualsiasi utilizzo legale o giuridico, consultare sempre la versione ufficiale pubblicata sulla Gazzetta Ufficiale Italiana.
+
+---
+
 ## 🎯 Perché Markdown per le norme?
 
 Convertire le norme legali da XML Akoma Ntoso a Markdown offre vantaggi significativi:

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "normattiva2md"
-version = "2.1.4"
+version = "2.1.5"
 description = "Convertitore da XML Akoma Ntoso a formato Markdown con download automatico delle leggi citate e cross-references inline (CLI: normattiva2md)"
 readme = "README.md"
 requires-python = ">=3.7"

setup.py

@@ -19,7 +19,7 @@ def read_readme():
 
 setup(
     name="normattiva2md",
-    version="2.1.4",
+    version="2.1.5",
     description="Convertitore da XML Akoma Ntoso a formato Markdown con download automatico delle leggi citate e cross-references inline (CLI: normattiva2md)",
     long_description=read_readme(),
     long_description_content_type="text/markdown",

src/normattiva2md/cli.py

@@ -39,6 +39,22 @@ def print_rich_help():
     console.print(title)
     console.print()
 
+    # Legal warning
+    warning_text = Text()
+    warning_text.append(
+        "⚠️  I testi presenti nella banca dati \"Normattiva\" non hanno carattere di ufficialità.\n"
+        "L'unico testo ufficiale e definitivo è quello pubblicato sulla Gazzetta Ufficiale Italiana.",
+        style="bold yellow on dark_red"
+    )
+    warning_panel = Panel(
+        warning_text,
+        title="[bold red]AVVERTENZA LEGALE[/bold red]",
+        border_style="red",
+        padding=(1, 2),
+    )
+    console.print(warning_panel)
+    console.print()
+
     # Description
     console.print(
         "Converte documenti Akoma Ntoso in formato Markdown da file XML o URL normattiva.it",
@@ -260,6 +276,11 @@ def main():
         formatter_class=argparse.RawDescriptionHelpFormatter,
         prog=cmd_display,
         epilog=f"""
+⚠️  AVVERTENZA LEGALE:
+  I testi presenti nella banca dati "Normattiva" non hanno carattere di ufficialità.
+  L'unico testo ufficiale e definitivo è quello pubblicato sulla Gazzetta Ufficiale Italiana.
+  Per qualsiasi utilizzo legale o giuridico, consultare sempre la versione ufficiale.
+
   Esempi d'uso:
 
     # Output a file

src/normattiva2md/constants.py

@@ -7,4 +7,4 @@
 MAX_FILE_SIZE_MB = 50
 MAX_FILE_SIZE_BYTES = MAX_FILE_SIZE_MB * 1024 * 1024
 DEFAULT_TIMEOUT = 30
-VERSION = "2.1.4"
+VERSION = "2.1.5"

src/normattiva2md/markdown_converter.py

@@ -35,6 +35,8 @@ def generate_front_matter(metadata):
 
     # Generate YAML front matter
     lines = ["---"]
+    # Add legal warning at the top
+    lines.append("legal_notice: I testi presenti nella banca dati \"Normattiva\" non hanno carattere di ufficialità. L'unico testo ufficiale è quello pubblicato sulla Gazzetta Ufficiale Italiana.")
     for key, value in front_matter_data.items():
         lines.append(f"{key}: {value}")
     lines.append("---")