E' stata pubblicata la nuova release di Caveman.PrivacyGuard

Riepilogo cumulativo di tutte le modifiche da v1.0.2 a v1.2.1.

v1.2.1 (2026-06-02) — Critical Bugfix Hotfix

🛑 Fixed

1. Critico: Falsi positivi su Carta d'Identità Tedesca — il pattern \b[A-Z0-9]{9}\b abbinato a RegexOptions.IgnoreCase globale causava falsi positivi su qualsiasi parola di 9 caratteri (es. "francesco", "contratto", "password") classificandola erroneamente come "German ID Card". Aggiunto (?-i) inline per ripristinare la case-sensitivity corretta.

🆕 Added

1. Demo: comando /restore — ripristino interattivo dei placeholder da una risposta AI.
2. Demo: comando /roundtrip — dimostrazione completa del flusso mask → AI → restore client-side.

v1.2.0 (2026-06-02) — Session Persistence & JSON Config

🆕 New Features

1. ThrowIfDisposed() — tutti i metodi pubblici lanciano un'eccezione ObjectDisposedException esplicita.
2. GetWhitelist() → IReadOnlySet<string> — ispezione degli elementi in whitelist.
3. IsWhitelisted(value) → bool — test rapido sulla whitelist.
4. AnalyzeAsync — 4 overload con CancellationToken per interfacce UI e applicazioni web.
5. AnalyzeBatch / AnalyzeBatchAsync — analisi batch in memoria.
6. PrivacySession.Count — conteggio O(1) senza necessità di copiare il dizionario.
7. NormalizeNewlines(StringBuilder) — allocazioni extra azzerate sui caratteri \r\n / \r.
8. LoadCustomJson / LoadCustomJsonFromString — caricamento delle regole di mascheramento da JSON.
9. WatchConfig / StopWatching / ConfigReloaded — supporto all'hot-reload (ricaricamento a caldo) sui file JSON.
10. PrivacySession.ToJson / FromJson / ImportFromJson — esportazione e persistenza delle sessioni.
11. IReadOnlySession — interfaccia in sola lettura per le sessioni.
12. PrivacyAnalyzer.Logger — integrazione con ILogger per la diagnostica di sistema.
13. PrivacyAnalyzer.ValidateRules() — validazione formale delle regole caricate.
14. GetRule() — cache O(1) gestita tramite ConcurrentDictionary.
15. netstandard2.0 target — compatibilità estesa con il mondo .NET Framework.
16. Demo: aggiunti i comandi /export e /validate.

🐛 Fixed

1. Dispose() — risolto un crash se il lock era ancora in uso: aggiunto catch(SynchronizationLockException), lasciando il rilascio del lock al Garbage Collector.
2. Warning nullable: corretti i tipi per ValidatorRegistry.TryGet → Func<string, bool>? e ContextKeywords → !.
3. Risolte le incompatibilità con netstandard2.0 relative a System.Index, Math.Clamp e RegexParseException.

🔧 Improved

1. Demo: nuovi comandi pratici /whitelist, /rules, /export, /validate.
2. README: documentate nel dettaglio tutte le nuove API.
3. Creata la classe unificata RegexHelper per la gestione multi-target.
4. Armonizzate le RegexOptions tra net8.0 e netstandard2.0.

v1.1.0 (2026-05-21) — Placeholder Session System

🆕 New Features

1. PrivacySession — mappatura basata sulla sessione per collegare i placeholder ai rispettivi valori originali.
2. Placeholder univoci [PG_N] — sostituiscono il vecchio formato generico [CATEGORY], permettendo il ripristino sicuro dei dati lato client.
3. session.Restore(text) — ripristina i valori originali all'interno di una risposta generata dall'AI.
4. session.RestoreDetailed(text) — esegue il ripristino restituendo anche il conteggio accurato delle sostituzioni effettuate.
5. session.MergeFrom(other) — unisce più sessioni basandosi sul valore originale.
6. session.AddOrGet(category, value) — registrazione pubblica di un placeholder.
7. analyzer.Analyze(input, session) — overload per eseguire l'analisi inserendo una sessione esplicita.
8. analyzer.RestoreText(text) — metodo di istanza basato su CurrentSession.
9. PrivacyAnalyzer.RestoreText(text, session) — helper statico di utilità.
10. EnableAutoMasking ? Session : null — restituisce una sessione nulla quando il mascheramento è disabilitato.

🐛 Fixed

1. CurrentSession — risolto un bug per cui la proprietà veniva ignorata dagli overload di Analyze().
2. ReaderWriterLockSlim — corretto un leak di risorse; PrivacyAnalyzer ora implementa correttamente IDisposable.
3. AddEntry — ottimizzato il lookup da O(n) a O(1) tramite l'introduzione di un ConcurrentDictionary secondario.
4. Analyze(input, session) — ora aggiorna correttamente lo stato di CurrentSession.

🔧 Improved

1. CompiledRule — convertito in un tipo record, sostituendo la precedente tupla a 7 campi.
2. GetLoadedCategories() / GetRule(category) / RemoveRule(category) — migliorata la gestione del ciclo di vita delle regole.
3. LoadCustomYaml(path, replace: true) — ora sovrascrive le regole esistenti (replace) invece di appenderle.
4. ClearRules() — svuota e rimuove completamente tutte le regole.
5. AddToWhitelist / RemoveFromWhitelist / ClearWhitelist — ciclo di vita completo per la gestione della whitelist.
6. ValidatorRegistry.Unregister(name) / Reset() — gestione del ciclo di vita dei validatori personalizzati.
7. LoadCustomYamlFromString(yaml) / LoadCustomYaml(path) — implementazione nativa completa.
8. I tag compliance_tags definiti in YAML vengono ora mappati correttamente in ComplianceFlags.
9. Timeout di 3 secondi sui nodi Regex — difesa integrata contro attacchi ReDoS.
10. Gli errori di parsing delle Regex ora includono dettagli sul contesto (categoria di dato e paese).
11. Aggiunti i commenti di documentazione XML su tutte le API pubbliche.
12. Demo: introdotto il comando /status per visionare il conteggio dei placeholder attivi.

Installazione

Collegamenti

1. NuGet: https://www.nuget.org/packages/Caveman.PrivacyGuard
2. GitHub: https://github.com/francescopaolopassaro/Caveman.PrivacyGuard
3. Licenza: MIT