Claude/refactor main function

.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+# See https://pre-commit.com for more information
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+        args: ['--maxkb=500']
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.1.2
+    hooks:
+      - id: flake8
+        args:
+          - --max-line-length=150
+          - --extend-ignore=E501,W503,W504
+          - --select=E9,F63,F7,F82
+
+  - repo: https://github.com/pycqa/isort
+    rev: 6.0.1
+    hooks:
+      - id: isort
+        args: ['--profile=black', '--line-length=150']
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.15.0
+    hooks:
+      - id: mypy
+        args: ['--config-file=mypy.ini', '--ignore-missing-imports']
+        additional_dependencies: []
+        pass_filenames: false

CHANGELOG.md

@@ -0,0 +1,95 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [2.3.1] - 2026
+
+### Fixed
+- Unicode output crash on Windows (PyInstaller cp1252 encoding issue)
+- Replaced Cyrillic text in argparse help with English for cross-platform compatibility
+- Added PyInstaller runtime hook to force UTF-8 on Windows
+
+### Changed
+- CI: replaced softprops/action-gh-release with `gh` CLI
+- CI: opted into Node.js 24 for GitHub Actions runners
+- Docs: updated copyright year range to 2025-2026
+
+## [2.3.0] - 2026
+
+### Added
+- `modules/security.py` — AES-256-GCM encryption/decryption for mapping files
+- `modules/config.py` — YAML + ENV + CLI configuration with priority chain (CLI > ENV > YAML > Default)
+- `modules/masking_logger.py` — structured logging (JSON + colored console output)
+- `modules/selective.py` — `--only` / `--exclude` filters for selective masking
+- `modules/re_mask.py` — multi-pass re-masking with chain tracking
+- `modules/tools.py` — atomic masking functions for programmatic API usage
+- `modules/password_generator.py` — cryptographically secure password generation
+- CI/CD: GitHub Actions for linting, testing (Python 3.13, 3.9 compat), and releases
+- CI/CD: Windows binary builds via PyInstaller
+
+### Changed
+- Complete migration to `modules/` package architecture
+- UTF-8 encoding fixes (mojibake prevention)
+
+## [2.2.14] - 2025
+
+### Changed
+- Improved code documentation with detailed docstrings
+- Added inline comments for complex logic
+- Improved block comments for code sections
+
+## [2.2.13] - 2025
+
+### Changed
+- Merged `data_masking.py` (v2.2.10) and `data_masking_v2_2_12_fixed.py`
+- Preserved all bug fixes from v2.2.12
+
+## [2.2.12] - 2025
+
+### Fixed
+- Bug #18: `mask_rank()` did not preserve Title Case for multi-word ranks
+  ("Старший Лейтенант" now correctly maps to "Майор" in Title Case)
+
+## [2.2.11] - 2025
+
+### Fixed
+- Bug #16: `mask_rank()` did not preserve case when using `.title()`
+  ("Капітан" now correctly maps to "Майор" in Title Case)
+- Bug #17: `mask_name()` did not apply case for names already in mapping
+  ("петро" now correctly maps to "павло" in lowercase)
+
+## [2.2.10] - 2025
+
+### Fixed
+- Bug #15: "старшого\nсержанта" was incorrectly masked as "старшого старшого сержанта"
+  Added `normalize_broken_ranks()` function to handle line-broken ranks
+- Restored full report format and statistics output
+
+## [2.1.16] - 2025
+
+### Added
+- Abbreviation whitelist support (ЗСУ, МОУ, ВСУ, etc. are no longer masked)
+
+## [2.0.0] - 2025
+
+### Added
+- Instance tracking for all masked values
+- Deterministic masking via blake2b hash-based seed generation
+- v2.0 mapping file format with per-instance tracking
+- Support for Ukrainian military ranks with all grammatical cases (nominative, genitive, dative, instrumental)
+- Gender-aware masking (male/female rank forms)
+- Case preservation (UPPER, Title, lower)
+- Support for "у відставці" / "в запасі" / "на пенсії" suffixes
+
+### Supported data types
+- PIB (names, surnames, patronymics) with declension support
+- IPN (10-digit tax identification numbers)
+- Passports (AA123456) and ID passports (9-digit)
+- Military IDs (МТ123456)
+- Military ranks (Army, Navy, Legal, Medical services)
+- Brigades, military units (в/ч А1234)
+- Order numbers (наказ №123)
+- BR numbers (75/25/3400/Р)
+- Dates (DD.MM.YYYY with ±30 day shift)