gdpr-pseudonymizer 2.3.0__tar.gz → 2.3.1__tar.gz

gdpr_pseudonymizer-2.3.0/README.md → gdpr_pseudonymizer-2.3.1/PKG-INFO

@@ -1,3 +1,52 @@
+Metadata-Version: 2.4
+Name: gdpr-pseudonymizer
+Version: 2.3.1
+Summary: CLI and GUI tool for GDPR-compliant pseudonymization of French text documents using NLP-based entity detection and reversible mapping
+License: MIT
+License-File: LICENSE
+Keywords: gdpr,pseudonymization,nlp,privacy,data-protection
+Author: GDPR Pseudonymizer Team
+Requires-Python: >=3.11,<3.14
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Legal Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: French
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Security
+Classifier: Topic :: Text Processing :: Linguistic
+Provides-Extra: all
+Provides-Extra: docx
+Provides-Extra: excel
+Provides-Extra: formats
+Provides-Extra: gui
+Provides-Extra: pdf
+Requires-Dist: PySide6-Essentials (>=6.8.3,<6.9.0) ; (python_version >= "3.11" and python_version < "3.14") and (extra == "gui" or extra == "all")
+Requires-Dist: PyYAML (>=6.0,<7.0)
+Requires-Dist: SQLAlchemy (>=2.0.0,<2.1.0)
+Requires-Dist: click (>=8.0.0,<8.2.0)
+Requires-Dist: cryptography (>=50.0.1,<51.0.0)
+Requires-Dist: defusedxml (>=0.7.1) ; extra == "excel" or extra == "formats" or extra == "all"
+Requires-Dist: markdown-it-py (>=3.0.0,<4.0.0)
+Requires-Dist: openpyxl (>=3.1.0,<4.0.0) ; extra == "excel" or extra == "formats" or extra == "all"
+Requires-Dist: pdfplumber (>=0.11.0,<0.12.0) ; extra == "pdf" or extra == "formats" or extra == "all"
+Requires-Dist: python-docx (>=1.1.0,<2.0.0) ; extra == "docx" or extra == "formats" or extra == "all"
+Requires-Dist: readchar (>=4.2.0,<5.0.0)
+Requires-Dist: rich (>=13.7.0,<14.0.0)
+Requires-Dist: spacy (>=3.7.0,<4.0.0)
+Requires-Dist: structlog (>=23.2.0,<24.0.0)
+Requires-Dist: typer (>=0.9.0,<0.10.0)
+Project-URL: Documentation, https://liochandayo.github.io/RGPDpseudonymizer/
+Project-URL: Homepage, https://github.com/LioChanDaYo/RGPDpseudonymizer
+Project-URL: Repository, https://github.com/LioChanDaYo/RGPDpseudonymizer
+Description-Content-Type: text/markdown
+
 > 🇬🇧 **English** | 🇫🇷 [Français](README.fr.md)
 
 # GDPR Pseudonymizer
@@ -14,7 +63,19 @@ Transform sensitive French documents for safe AI analysis with local processing,
 
 ---
 
-## What's New in v2.2
+## What's New in v2.3
+
+- **Names you add are replaced everywhere** — A name you add by hand (`[A]` in the command line, "Ajouter comme entité" in the desktop app) is now replaced at every place it appears, also where it is written in capitals or in capitals without accents ("ZORBAL", "HELENE"), never in a word written in small letters ("Petit" leaves "petit"). A name of two words or more is found whatever its accents and capitals.
+- **Corrections cover the whole name** — Correcting a name or changing its type now applies at every place, in the desktop app as in the command line, in Excel and CSV cells too, and with the full name you type: correcting "Élorine" to "Élorine du Prélis" no longer leaves "du Prélis" in clear.
+- **Your own pseudonym is used** — A pseudonym you choose ("Changer le pseudonyme", `[C]`) is now written in the file and kept for later documents. Before, a generated one was used instead.
+- **Complete erasure** — `delete-mapping "Name"` deletes every saved pseudonym of that name: each type, and each way it was written with capitals or accents. The erasure log no longer keeps the erased name, and the names earlier versions wrote there are removed the first time v2.3 opens the database.
+- **Safer batch runs** — In desktop batch review, each document keeps its own decisions and result when you move between documents, and a running batch can no longer mix with another run. When several documents of a `batch` meet the same new name at the same moment, it gets one pseudonym.
+- **No name left in clear without warning** — Names you neither accepted nor rejected are announced before the file is written. When the detector finds no new name, the command line asks whether to add one it missed.
+- **Same name, two types** — "Zorbaville" the town and "Zorbaville" the company now get separate pseudonyms. Your mapping database is converted once, the first time v2.3 opens it; after that, do not open it with v2.2 or older (copy it first if you may need to go back).
+- **More precise detection** — One candidate per name instead of fragments; job titles (CTO, DRH, "VP Europe") are no longer offered as organisations; names no longer run into the next line; fewer false places; names with particles ("van der", "Le") stay whole; people in greetings, organisations followed by their country, short forms and aliases defined in a contract are now offered; accents stored as a separate mark are handled. On a blind final exam of 30 unseen documents, detection scores F1 61.4% (see [Detection accuracy](#detection-accuracy-epic-10-october-2026)).
+
+<details>
+<summary>v2.2 highlights</summary>
 
 - **Choose the spaCy model** — `--model` / `pseudonymization.model` accept any spaCy package name (e.g. `en_core_web_trf` for English); `spacy` still selects the French `fr_core_news_lg`. The model only drives NLP detection: regex patterns, dictionaries and pseudonym libraries stay French. See the [CLI Reference](docs/CLI-REFERENCE.md).
 - **Retype entities during CLI validation (`[T]`)** — Switch a detected entity between PERSON, LOCATION and ORG for every occurrence, instead of rejecting and re-adding it
@@ -22,6 +83,8 @@ Transform sensitive French documents for safe AI analysis with local processing,
 - **Fresh `pip install` fixed** — v2.1.3 crashed on import when pip resolved SQLAlchemy 2.1; SQLAlchemy is now capped below 2.1
 - **Audit log records the real model** — e.g. `fr_core_news_lg-3.8.0` instead of `spacy-unknown`
 
+</details>
+
 <details>
 <summary>v2.1 highlights</summary>
 
@@ -47,9 +110,9 @@ Pre-built standalone executables are available for Windows, macOS, and Linux. No
 
 | Platform | File | Notes |
 |----------|------|-------|
-| **Windows** | `gdpr-pseudonymizer-2.2.0-windows-setup.exe` | Run the installer. Adds Start Menu shortcut. |
-| **macOS (Apple Silicon)** | `gdpr-pseudonymizer-2.2.0-macos-arm64.dmg` | Open DMG, drag to Applications. |
-| **Linux** | `gdpr-pseudonymizer-2.2.0-linux.AppImage` | `chmod +x` then run. |
+| **Windows** | `gdpr-pseudonymizer-2.3.0-windows-setup.exe` | Run the installer. Adds Start Menu shortcut. |
+| **macOS (Apple Silicon)** | `gdpr-pseudonymizer-2.3.0-macos-arm64.dmg` | Open DMG, drag to Applications. |
+| **Linux** | `gdpr-pseudonymizer-2.3.0-linux.AppImage` | `chmod +x` then run. |
 
 > **Intel Macs:** no DMG is published. GitHub retired its Intel macOS runners, and an
 > Apple Silicon runner cannot cross-build a working x86_64 bundle. Install with
@@ -127,7 +190,7 @@ GDPR Pseudonymizer is a **privacy-first CLI and GUI tool** that combines AI effi
 
 ## 🚀 Quick Start
 
-**Status:** 🎉 **v2.2.0** (September 2026) — spaCy Model Choice, Entity Retyping & Span Fixes
+**Status:** 🎉 **v2.3.0** (November 2026) — Detection Precision, Corrections at Every Place & Complete Erasure
 
 ### Getting Started
 
@@ -149,7 +212,7 @@ pip install gdpr-pseudonymizer[excel]
 pip install gdpr-pseudonymizer[formats]
 ```
 
-### What v2.2 Delivers
+### What v2.3 Delivers
 
 - 🖥️ **Desktop GUI** — Visual entity validation with drag-and-drop, batch dashboard, and database management
 - 📦 **Standalone executables** — Windows .exe, macOS .dmg (Apple Silicon), Linux AppImage — no Python required
@@ -164,8 +227,10 @@ pip install gdpr-pseudonymizer[formats]
 - 🎯 **NER accuracy** — LOCATION false-negative rate reduced from 27% to 13% via regex expansion & POS disambiguation
 - 🧠 **Choice of spaCy model** — French by default; any spaCy model for detection (e.g. `--model en_core_web_trf`)
 - 🏷️ **Entity retyping** — Change an entity's type (PERSON/LOCATION/ORG) during CLI validation with `[T]`
+- ✍️ **Corrections at every place** — Names you add, correct or retype are replaced wherever they appear, also where written in capitals
+- 🗑️ **Complete erasure** — `delete-mapping` erases every saved pseudonym of a name, and the erasure log keeps no name
 
-**What v2.2 does NOT deliver:**
+**What v2.3 does NOT deliver:**
 - ❌ Fully automatic "set and forget" processing
 - ❌ 85%+ AI accuracy (current: F1 61.4% on unseen documents, 82.6% on our development corpus — we plan to raise it)
 - ❌ Optional validation mode (validation is mandatory)
@@ -180,7 +245,9 @@ pip install gdpr-pseudonymizer[formats]
 
 **v2.1 (Q1 2026):** GUI polish, Excel/CSV support, neutral ID theme, NER accuracy improvements, keyboard shortcuts help
 
-**v2.2 (Q3 2026) — CURRENT RELEASE:** Choice of spaCy model, entity retyping in CLI validation, entity-span accuracy fixes, fresh-install fix (SQLAlchemy < 2.1)
+**v2.2 (Q3 2026):** Choice of spaCy model, entity retyping in CLI validation, entity-span accuracy fixes, fresh-install fix (SQLAlchemy < 2.1)
+
+**v2.3 (Q4 2026) — CURRENT RELEASE:** Detection precision (Epic 10), benchmark repair and blind final exam, names added or corrected replaced at every place, custom pseudonyms used, complete erasure with no name in the erasure log, safer batch runs
 
 **v3.0 (2027+):** NLP accuracy & automation
 - Fine-tuned French NER model (70-85% F1 target, up from 61.4% on unseen documents today)
@@ -195,7 +262,7 @@ pip install gdpr-pseudonymizer[formats]
 See [Installation Guide](https://liochandayo.github.io/RGPDpseudonymizer/installation/) for detailed platform-specific instructions.
 
 ### Prerequisites
-- **Python 3.10, 3.11, or 3.12** (validated in CI/CD — 3.13+ not yet tested)
+- **Python 3.11, 3.12 or 3.13** (validated in CI/CD — 3.14+ not yet tested)
 
 ### Install from PyPI (Recommended)
 
@@ -404,7 +471,7 @@ The validation UI provides an intuitive keyboard-driven interface for reviewing
 
 | Component | Technology | Version | Purpose |
 |-----------|------------|---------|---------|
-| **Runtime** | Python | 3.10-3.12 | Validated in CI/CD (3.13+ not yet tested) |
+| **Runtime** | Python | 3.11-3.13 | Validated in CI/CD (3.14+ not yet tested) |
 | **NLP Library** | spaCy | 3.8.0 | French entity detection (fr_core_news_lg) |
 | **CLI Framework** | Typer | 0.9+ | Command-line interface |
 | **Database** | SQLite | 3.35+ | Local mapping table storage with WAL mode |
@@ -511,7 +578,7 @@ The validation UI provides an intuitive keyboard-driven interface for reviewing
 
 ## 🛠️ Development Status
 
-**Epics 1-7 Complete** — current release v2.2.0 (September 2026): spaCy model choice, entity retyping, entity-span fixes. v2.1.0 (March 2026) closed Epic 7.
+**Epics 1-7 and 10 Complete** — current release v2.3.0 (November 2026) closed Epic 10: detection precision, corrections at every place, complete erasure. v2.1.0 (March 2026) closed Epic 7.
 
 - ✅ **Epic 1:** Foundation & NLP Validation (9 stories) — spaCy integration, validation UI, hybrid detection, entity deduplication
 - ✅ **Epic 2:** Core Pseudonymization Engine (9 stories) — pseudonym libraries, encryption, audit logging, batch processing, GDPR 1:1 mapping
@@ -539,6 +606,7 @@ The validation UI provides an intuitive keyboard-driven interface for reviewing
   - ✅ Story 7.5: NER Accuracy Regex Expansion & POS Disambiguation
   - ✅ Story 7.6: Quality & Compatibility Integration Tests
   - ✅ Story 7.7: v2.1 Release Preparation
+- ✅ **Epic 10:** v2.3 Detection Precision Quick Wins — benchmark repair and held-out set, blind final exam with confidence ranges, overlap and boundary fixes, fewer false places, greetings and organisation-plus-country handling, type-aware mappings, names added or corrected replaced at every place, custom pseudonyms, erasure log without names, batch fixes, v2.3 release
 - **Total:** 60 stories, 1670+ tests, 86%+ coverage, all quality gates green
 
 ---
@@ -689,7 +757,7 @@ poetry run pytest tests/integration/test_validation_workflow_integration.py -v
 - **Performance tests:** 19 tests validating all NFR targets — single-document benchmarks (NFR1), entity-detection benchmarks, batch performance (NFR2), memory profiling (NFR4), startup time (NFR5), stability/error rate (NFR6), stress testing (Story 4.5)
 - **Current coverage:** 86%+ across all modules (100% for progress module, 91.41% for AuditRepository)
 - **Total tests:** 1670+ tests
-- **CI/CD:** Tests run on Python 3.10-3.12 across Windows, macOS, and Linux
+- **CI/CD:** Tests run on Python 3.11-3.13 across Windows, macOS, and Linux
 - **Quality gates:** All pass (Black, Ruff, mypy, pytest)
 
 ### Key Integration Test Scenarios
@@ -722,7 +790,7 @@ The integration test suite covers:
 
 | Metric | Value | Status |
 |--------|-------|--------|
-| **Development Progress** | v2.2.0 | ✅ Epics 1-7 complete |
+| **Development Progress** | v2.3.0 | ✅ Epics 1-7 and 10 complete |
 | **Stories Complete** | 60 (Epics 1-7) | ✅ All epics complete |
 | **LLM Utility (NFR10)** | 4.27/5.0 (85.4%) | ✅ PASSED (threshold: 80%) |
 | **Installation Success (NFR3)** | 87.5% (7/8 platforms) | ✅ PASSED (threshold: 85%) |
@@ -762,4 +830,5 @@ The integration test suite covers:
 
 ---
 
-**Last Updated:** 2026-10-01 (v2.2.0 — spaCy model choice, entity retyping, entity-span fixes)
+**Last Updated:** 2026-11-03 (v2.3.0 — detection precision, corrections at every place, complete erasure)
+

gdpr_pseudonymizer-2.3.0/PKG-INFO → gdpr_pseudonymizer-2.3.1/README.md

@@ -1,52 +1,3 @@
-Metadata-Version: 2.4
-Name: gdpr-pseudonymizer
-Version: 2.3.0
-Summary: CLI and GUI tool for GDPR-compliant pseudonymization of French text documents using NLP-based entity detection and reversible mapping
-License: MIT
-License-File: LICENSE
-Keywords: gdpr,pseudonymization,nlp,privacy,data-protection
-Author: GDPR Pseudonymizer Team
-Requires-Python: >=3.10,<3.14
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Legal Industry
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: French
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Security
-Classifier: Topic :: Text Processing :: Linguistic
-Provides-Extra: all
-Provides-Extra: docx
-Provides-Extra: excel
-Provides-Extra: formats
-Provides-Extra: gui
-Provides-Extra: pdf
-Requires-Dist: PySide6-Essentials (>=6.7.0,<6.8.0) ; (python_version >= "3.10" and python_version < "3.13") and (extra == "gui" or extra == "all")
-Requires-Dist: PyYAML (>=6.0,<7.0)
-Requires-Dist: SQLAlchemy (>=2.0.0,<2.1.0)
-Requires-Dist: click (>=8.0.0,<8.2.0)
-Requires-Dist: cryptography (>=50.0.1,<51.0.0)
-Requires-Dist: markdown-it-py (>=3.0.0,<4.0.0)
-Requires-Dist: openpyxl (>=3.1.0,<4.0.0) ; extra == "excel" or extra == "formats" or extra == "all"
-Requires-Dist: pdfplumber (>=0.11.0,<0.12.0) ; extra == "pdf" or extra == "formats" or extra == "all"
-Requires-Dist: python-docx (>=1.1.0,<2.0.0) ; extra == "docx" or extra == "formats" or extra == "all"
-Requires-Dist: readchar (>=4.2.0,<5.0.0)
-Requires-Dist: rich (>=13.7.0,<14.0.0)
-Requires-Dist: spacy (>=3.7.0,<4.0.0)
-Requires-Dist: structlog (>=23.2.0,<24.0.0)
-Requires-Dist: typer (>=0.9.0,<0.10.0)
-Project-URL: Documentation, https://liochandayo.github.io/RGPDpseudonymizer/
-Project-URL: Homepage, https://github.com/LioChanDaYo/RGPDpseudonymizer
-Project-URL: Repository, https://github.com/LioChanDaYo/RGPDpseudonymizer
-Description-Content-Type: text/markdown
-
 > 🇬🇧 **English** | 🇫🇷 [Français](README.fr.md)
 
 # GDPR Pseudonymizer
@@ -63,7 +14,19 @@ Transform sensitive French documents for safe AI analysis with local processing,
 
 ---
 
-## What's New in v2.2
+## What's New in v2.3
+
+- **Names you add are replaced everywhere** — A name you add by hand (`[A]` in the command line, "Ajouter comme entité" in the desktop app) is now replaced at every place it appears, also where it is written in capitals or in capitals without accents ("ZORBAL", "HELENE"), never in a word written in small letters ("Petit" leaves "petit"). A name of two words or more is found whatever its accents and capitals.
+- **Corrections cover the whole name** — Correcting a name or changing its type now applies at every place, in the desktop app as in the command line, in Excel and CSV cells too, and with the full name you type: correcting "Élorine" to "Élorine du Prélis" no longer leaves "du Prélis" in clear.
+- **Your own pseudonym is used** — A pseudonym you choose ("Changer le pseudonyme", `[C]`) is now written in the file and kept for later documents. Before, a generated one was used instead.
+- **Complete erasure** — `delete-mapping "Name"` deletes every saved pseudonym of that name: each type, and each way it was written with capitals or accents. The erasure log no longer keeps the erased name, and the names earlier versions wrote there are removed the first time v2.3 opens the database.
+- **Safer batch runs** — In desktop batch review, each document keeps its own decisions and result when you move between documents, and a running batch can no longer mix with another run. When several documents of a `batch` meet the same new name at the same moment, it gets one pseudonym.
+- **No name left in clear without warning** — Names you neither accepted nor rejected are announced before the file is written. When the detector finds no new name, the command line asks whether to add one it missed.
+- **Same name, two types** — "Zorbaville" the town and "Zorbaville" the company now get separate pseudonyms. Your mapping database is converted once, the first time v2.3 opens it; after that, do not open it with v2.2 or older (copy it first if you may need to go back).
+- **More precise detection** — One candidate per name instead of fragments; job titles (CTO, DRH, "VP Europe") are no longer offered as organisations; names no longer run into the next line; fewer false places; names with particles ("van der", "Le") stay whole; people in greetings, organisations followed by their country, short forms and aliases defined in a contract are now offered; accents stored as a separate mark are handled. On a blind final exam of 30 unseen documents, detection scores F1 61.4% (see [Detection accuracy](#detection-accuracy-epic-10-october-2026)).
+
+<details>
+<summary>v2.2 highlights</summary>
 
 - **Choose the spaCy model** — `--model` / `pseudonymization.model` accept any spaCy package name (e.g. `en_core_web_trf` for English); `spacy` still selects the French `fr_core_news_lg`. The model only drives NLP detection: regex patterns, dictionaries and pseudonym libraries stay French. See the [CLI Reference](docs/CLI-REFERENCE.md).
 - **Retype entities during CLI validation (`[T]`)** — Switch a detected entity between PERSON, LOCATION and ORG for every occurrence, instead of rejecting and re-adding it
@@ -71,6 +34,8 @@ Transform sensitive French documents for safe AI analysis with local processing,
 - **Fresh `pip install` fixed** — v2.1.3 crashed on import when pip resolved SQLAlchemy 2.1; SQLAlchemy is now capped below 2.1
 - **Audit log records the real model** — e.g. `fr_core_news_lg-3.8.0` instead of `spacy-unknown`
 
+</details>
+
 <details>
 <summary>v2.1 highlights</summary>
 
@@ -96,9 +61,9 @@ Pre-built standalone executables are available for Windows, macOS, and Linux. No
 
 | Platform | File | Notes |
 |----------|------|-------|
-| **Windows** | `gdpr-pseudonymizer-2.2.0-windows-setup.exe` | Run the installer. Adds Start Menu shortcut. |
-| **macOS (Apple Silicon)** | `gdpr-pseudonymizer-2.2.0-macos-arm64.dmg` | Open DMG, drag to Applications. |
-| **Linux** | `gdpr-pseudonymizer-2.2.0-linux.AppImage` | `chmod +x` then run. |
+| **Windows** | `gdpr-pseudonymizer-2.3.0-windows-setup.exe` | Run the installer. Adds Start Menu shortcut. |
+| **macOS (Apple Silicon)** | `gdpr-pseudonymizer-2.3.0-macos-arm64.dmg` | Open DMG, drag to Applications. |
+| **Linux** | `gdpr-pseudonymizer-2.3.0-linux.AppImage` | `chmod +x` then run. |
 
 > **Intel Macs:** no DMG is published. GitHub retired its Intel macOS runners, and an
 > Apple Silicon runner cannot cross-build a working x86_64 bundle. Install with
@@ -176,7 +141,7 @@ GDPR Pseudonymizer is a **privacy-first CLI and GUI tool** that combines AI effi
 
 ## 🚀 Quick Start
 
-**Status:** 🎉 **v2.2.0** (September 2026) — spaCy Model Choice, Entity Retyping & Span Fixes
+**Status:** 🎉 **v2.3.0** (November 2026) — Detection Precision, Corrections at Every Place & Complete Erasure
 
 ### Getting Started
 
@@ -198,7 +163,7 @@ pip install gdpr-pseudonymizer[excel]
 pip install gdpr-pseudonymizer[formats]
 ```
 
-### What v2.2 Delivers
+### What v2.3 Delivers
 
 - 🖥️ **Desktop GUI** — Visual entity validation with drag-and-drop, batch dashboard, and database management
 - 📦 **Standalone executables** — Windows .exe, macOS .dmg (Apple Silicon), Linux AppImage — no Python required
@@ -213,8 +178,10 @@ pip install gdpr-pseudonymizer[formats]
 - 🎯 **NER accuracy** — LOCATION false-negative rate reduced from 27% to 13% via regex expansion & POS disambiguation
 - 🧠 **Choice of spaCy model** — French by default; any spaCy model for detection (e.g. `--model en_core_web_trf`)
 - 🏷️ **Entity retyping** — Change an entity's type (PERSON/LOCATION/ORG) during CLI validation with `[T]`
+- ✍️ **Corrections at every place** — Names you add, correct or retype are replaced wherever they appear, also where written in capitals
+- 🗑️ **Complete erasure** — `delete-mapping` erases every saved pseudonym of a name, and the erasure log keeps no name
 
-**What v2.2 does NOT deliver:**
+**What v2.3 does NOT deliver:**
 - ❌ Fully automatic "set and forget" processing
 - ❌ 85%+ AI accuracy (current: F1 61.4% on unseen documents, 82.6% on our development corpus — we plan to raise it)
 - ❌ Optional validation mode (validation is mandatory)
@@ -229,7 +196,9 @@ pip install gdpr-pseudonymizer[formats]
 
 **v2.1 (Q1 2026):** GUI polish, Excel/CSV support, neutral ID theme, NER accuracy improvements, keyboard shortcuts help
 
-**v2.2 (Q3 2026) — CURRENT RELEASE:** Choice of spaCy model, entity retyping in CLI validation, entity-span accuracy fixes, fresh-install fix (SQLAlchemy < 2.1)
+**v2.2 (Q3 2026):** Choice of spaCy model, entity retyping in CLI validation, entity-span accuracy fixes, fresh-install fix (SQLAlchemy < 2.1)
+
+**v2.3 (Q4 2026) — CURRENT RELEASE:** Detection precision (Epic 10), benchmark repair and blind final exam, names added or corrected replaced at every place, custom pseudonyms used, complete erasure with no name in the erasure log, safer batch runs
 
 **v3.0 (2027+):** NLP accuracy & automation
 - Fine-tuned French NER model (70-85% F1 target, up from 61.4% on unseen documents today)
@@ -244,7 +213,7 @@ pip install gdpr-pseudonymizer[formats]
 See [Installation Guide](https://liochandayo.github.io/RGPDpseudonymizer/installation/) for detailed platform-specific instructions.
 
 ### Prerequisites
-- **Python 3.10, 3.11, or 3.12** (validated in CI/CD — 3.13+ not yet tested)
+- **Python 3.11, 3.12 or 3.13** (validated in CI/CD — 3.14+ not yet tested)
 
 ### Install from PyPI (Recommended)
 
@@ -453,7 +422,7 @@ The validation UI provides an intuitive keyboard-driven interface for reviewing
 
 | Component | Technology | Version | Purpose |
 |-----------|------------|---------|---------|
-| **Runtime** | Python | 3.10-3.12 | Validated in CI/CD (3.13+ not yet tested) |
+| **Runtime** | Python | 3.11-3.13 | Validated in CI/CD (3.14+ not yet tested) |
 | **NLP Library** | spaCy | 3.8.0 | French entity detection (fr_core_news_lg) |
 | **CLI Framework** | Typer | 0.9+ | Command-line interface |
 | **Database** | SQLite | 3.35+ | Local mapping table storage with WAL mode |
@@ -560,7 +529,7 @@ The validation UI provides an intuitive keyboard-driven interface for reviewing
 
 ## 🛠️ Development Status
 
-**Epics 1-7 Complete** — current release v2.2.0 (September 2026): spaCy model choice, entity retyping, entity-span fixes. v2.1.0 (March 2026) closed Epic 7.
+**Epics 1-7 and 10 Complete** — current release v2.3.0 (November 2026) closed Epic 10: detection precision, corrections at every place, complete erasure. v2.1.0 (March 2026) closed Epic 7.
 
 - ✅ **Epic 1:** Foundation & NLP Validation (9 stories) — spaCy integration, validation UI, hybrid detection, entity deduplication
 - ✅ **Epic 2:** Core Pseudonymization Engine (9 stories) — pseudonym libraries, encryption, audit logging, batch processing, GDPR 1:1 mapping
@@ -588,6 +557,7 @@ The validation UI provides an intuitive keyboard-driven interface for reviewing
   - ✅ Story 7.5: NER Accuracy Regex Expansion & POS Disambiguation
   - ✅ Story 7.6: Quality & Compatibility Integration Tests
   - ✅ Story 7.7: v2.1 Release Preparation
+- ✅ **Epic 10:** v2.3 Detection Precision Quick Wins — benchmark repair and held-out set, blind final exam with confidence ranges, overlap and boundary fixes, fewer false places, greetings and organisation-plus-country handling, type-aware mappings, names added or corrected replaced at every place, custom pseudonyms, erasure log without names, batch fixes, v2.3 release
 - **Total:** 60 stories, 1670+ tests, 86%+ coverage, all quality gates green
 
 ---
@@ -738,7 +708,7 @@ poetry run pytest tests/integration/test_validation_workflow_integration.py -v
 - **Performance tests:** 19 tests validating all NFR targets — single-document benchmarks (NFR1), entity-detection benchmarks, batch performance (NFR2), memory profiling (NFR4), startup time (NFR5), stability/error rate (NFR6), stress testing (Story 4.5)
 - **Current coverage:** 86%+ across all modules (100% for progress module, 91.41% for AuditRepository)
 - **Total tests:** 1670+ tests
-- **CI/CD:** Tests run on Python 3.10-3.12 across Windows, macOS, and Linux
+- **CI/CD:** Tests run on Python 3.11-3.13 across Windows, macOS, and Linux
 - **Quality gates:** All pass (Black, Ruff, mypy, pytest)
 
 ### Key Integration Test Scenarios
@@ -771,7 +741,7 @@ The integration test suite covers:
 
 | Metric | Value | Status |
 |--------|-------|--------|
-| **Development Progress** | v2.2.0 | ✅ Epics 1-7 complete |
+| **Development Progress** | v2.3.0 | ✅ Epics 1-7 and 10 complete |
 | **Stories Complete** | 60 (Epics 1-7) | ✅ All epics complete |
 | **LLM Utility (NFR10)** | 4.27/5.0 (85.4%) | ✅ PASSED (threshold: 80%) |
 | **Installation Success (NFR3)** | 87.5% (7/8 platforms) | ✅ PASSED (threshold: 85%) |
@@ -811,5 +781,4 @@ The integration test suite covers:
 
 ---
 
-**Last Updated:** 2026-10-01 (v2.2.0 — spaCy model choice, entity retyping, entity-span fixes)
-
+**Last Updated:** 2026-11-03 (v2.3.0 — detection precision, corrections at every place, complete erasure)

{gdpr_pseudonymizer-2.3.0 → gdpr_pseudonymizer-2.3.1}/gdpr_pseudonymizer/cli/commands/batch.py

@@ -41,6 +41,7 @@ from gdpr_pseudonymizer.cli.validators import (
     validate_theme_or_exit,
 )
 from gdpr_pseudonymizer.core.document_processor import DocumentProcessor
+from gdpr_pseudonymizer.core.saved_own_words import notice_line, own_word_rows_of
 from gdpr_pseudonymizer.data.database import open_database
 from gdpr_pseudonymizer.exceptions import DatabaseConversionError
 from gdpr_pseudonymizer.utils.logger import configure_logging, get_logger
@@ -68,6 +69,9 @@ class BatchResult:
     reused_entities: int = 0
     total_time_seconds: float = 0.0
     errors: list[str] = field(default_factory=list)
+    # Story 11.7: the largest count of saved pseudonyms holding a word of
+    # their own name after a document of this run was written
+    own_word_rows: int = 0
 
 
 def _process_single_document_worker(
@@ -92,6 +96,7 @@ def _process_single_document_worker(
         - entities_reused: int (if success)
         - processing_time: float (if success)
         - error: str (if failure)
+        - own_word_rows: int (Story 11.7, the notice's count)
     """
     input_path, output_path, db_path, passphrase, theme, model, entity_types_csv = args
 
@@ -126,6 +131,7 @@ def _process_single_document_worker(
             "entities_reused": result.entities_reused,
             "processing_time": result.processing_time_seconds,
             "error": result.error_message if not result.success else None,
+            "own_word_rows": own_word_rows_of(result) if result.success else 0,
         }
     except Exception as e:
         return {
@@ -136,6 +142,7 @@ def _process_single_document_worker(
             "entities_reused": 0,
             "processing_time": 0.0,
             "error": str(e),
+            "own_word_rows": 0,
         }
 
 
@@ -246,6 +253,10 @@ def _process_batch_parallel(
                     batch_result.total_entities += result["entities_detected"]
                     batch_result.new_entities += result["entities_new"]
                     batch_result.reused_entities += result["entities_reused"]
+                    batch_result.own_word_rows = max(
+                        batch_result.own_word_rows,
+                        result.get("own_word_rows", 0) or 0,
+                    )
                 else:
                     batch_result.failed_files += 1
                     error_msg = result.get("error", "Unknown error")
@@ -615,6 +626,9 @@ def batch_command(
                             batch_result.total_entities += result.entities_detected
                             batch_result.new_entities += result.entities_new
                             batch_result.reused_entities += result.entities_reused
+                            batch_result.own_word_rows = max(
+                                batch_result.own_word_rows, own_word_rows_of(result)
+                            )
 
                             # Update progress tracker
                             progress_tracker.update_file_complete(
@@ -692,6 +706,10 @@ def batch_command(
         # Display summary report
         _display_batch_summary(batch_result)
 
+        # Story 11.7: one note per run, the largest count of its documents
+        if batch_result.own_word_rows > 0:
+            console.print(notice_line(batch_result.own_word_rows), markup=False)
+
         logger.info(
             "batch_complete",
             total_files=batch_result.total_files,

{gdpr_pseudonymizer-2.3.0 → gdpr_pseudonymizer-2.3.1}/gdpr_pseudonymizer/cli/commands/delete_mapping.py

@@ -14,7 +14,7 @@ from __future__ import annotations
 import sys
 import time
 import uuid
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from pathlib import Path
 from typing import Optional
 
@@ -188,7 +188,7 @@ def delete_mapping_command(
             for deleted in deleted_rows:
                 operation = Operation(
                     id=str(uuid.uuid4()),
-                    timestamp=datetime.now(timezone.utc),
+                    timestamp=datetime.now(UTC),
                     operation_type="ERASURE",
                     files_processed=[],
                     user_modifications={

{gdpr_pseudonymizer-2.3.0 → gdpr_pseudonymizer-2.3.1}/gdpr_pseudonymizer/cli/commands/import_mappings.py

@@ -20,7 +20,7 @@ from gdpr_pseudonymizer.data.database import open_database
 from gdpr_pseudonymizer.data.repositories.mapping_repository import (
     SQLiteMappingRepository,
 )
-from gdpr_pseudonymizer.exceptions import DuplicateEntityError
+from gdpr_pseudonymizer.exceptions import DatabaseError, DuplicateEntityError
 from gdpr_pseudonymizer.utils.logger import configure_logging, get_logger
 
 # Configure logging
@@ -119,6 +119,7 @@ def import_mappings_command(
 
         # Import statistics
         imported = 0
+        replaced = 0
         skipped = 0
         errors = 0
 
@@ -183,6 +184,22 @@ def import_mappings_command(
                         skipped += 1
                         continue
 
+                    # Story 11.2: a yes replaces the existing row's mapping
+                    # in one transaction; the row keeps its id, its name as
+                    # stored and its first-seen time
+                    try:
+                        target_repo.replace_mapping(existing.id, entity)
+                        replaced += 1
+                    except DatabaseError as e:
+                        errors += 1
+                        # The type and the error's kind, never the name
+                        logger.error(
+                            "import_entity_error",
+                            entity_type=entity.entity_type,
+                            error_type=type(e).__name__,
+                        )
+                    continue
+
                 try:
                     # Create new entity without ID (let DB generate new one)
                     from gdpr_pseudonymizer.data.models import Entity as EntityModel
@@ -228,6 +245,8 @@ def import_mappings_command(
         # Display results
         console.print("\n[bold]Import Complete[/bold]\n")
         console.print(f"  Imported: [green]{imported}[/green]")
+        if replaced:
+            console.print(f"  Replaced: [green]{replaced}[/green]")
         console.print(f"  Skipped:  [yellow]{skipped}[/yellow]")
         if errors:
             console.print(f"  Errors:   [red]{errors}[/red]")
@@ -236,6 +255,7 @@ def import_mappings_command(
             "import_complete",
             source=str(source_db),
             imported=imported,
+            replaced=replaced,
             skipped=skipped,
             errors=errors,
         )

{gdpr_pseudonymizer-2.3.0 → gdpr_pseudonymizer-2.3.1}/gdpr_pseudonymizer/cli/commands/process.py

@@ -29,6 +29,7 @@ from gdpr_pseudonymizer.cli.validators import (
     validate_theme_or_exit,
 )
 from gdpr_pseudonymizer.core.document_processor import DocumentProcessor
+from gdpr_pseudonymizer.core.saved_own_words import notice_line, own_word_rows_of
 from gdpr_pseudonymizer.exceptions import FileProcessingError
 from gdpr_pseudonymizer.utils.logger import configure_logging, get_logger
 
@@ -235,6 +236,12 @@ def process_command(
                     f"[cyan]ℹ  {result.entities_reused} entity mapping(s) reused from database (idempotent processing)[/cyan]\n"
                 )
 
+            # Story 11.7: the database holds saved pseudonyms that hold a word
+            # of their own name (the rows this document saved included)
+            own_word_rows = own_word_rows_of(result)
+            if own_word_rows > 0:
+                console.print(notice_line(own_word_rows), markup=False)
+
             logger.info(
                 "processing_complete",
                 entities_detected=result.entities_detected,