feat: Add loc property to RyanDataAddressError and enhance cleaning metrics tracking

- Add loc property to RyanDataAddressError for ValidationRunner field extraction
- Add OperationType constants (normalization, formatting, expansion, cleaning, parsing)
- Add STREET_TYPE_TO_ABBREV, DIRECTION_TO_ABBREV, UNIT_TYPE_TO_ABBREV mappings
- Add new tracking methods: track_case_normalization, track_street_type_changes,
  track_direction_changes, track_unit_type_changes, track_punctuation_removal,
  track_component_parsing
- Export OperationType from ryandata_address_utils package
- Add 16 new tests for enhanced tracking functionality

Fixes validation report showing 'unknown' field name for ZIP/state errors
Provides detailed cleaning metrics for address transformation tracking

Author: github-actions

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ryandata-address-utils"
-version = "0.7.1"
+version = "0.7.2"
 description = "A Python address parser using usaddress with Pydantic models, validation, and extensible architecture"
 readme = "README.md"
 license = { text = "MIT" }

src/ryandata_address_utils/__init__.py

@@ -51,6 +51,8 @@
     CleaningTracker,
     ValidationError,
     ValidationResult,
+    # Transformation tracking
+    OperationType,
 )
 from ryandata_address_utils.core import RyanDataError as CoreRyanDataError
 from ryandata_address_utils.core import (
@@ -137,6 +139,8 @@
     "ValidationResult",
     "CoreRyanDataError",
     "CoreRyanDataValidationError",
+    # Transformation tracking
+    "OperationType",
     # Address-specific errors
     "RyanDataAddressError",
     "RyanDataValidationError",

src/ryandata_address_utils/core/__init__.py

@@ -57,7 +57,13 @@
 )
 from ryandata_address_utils.core.errors import RyanDataError, RyanDataValidationError
 from ryandata_address_utils.core.factory import PluginFactory
-from ryandata_address_utils.core.tracking import TransformationTracker
+from ryandata_address_utils.core.tracking import (
+    DIRECTION_TO_ABBREV,
+    STREET_TYPE_TO_ABBREV,
+    UNIT_TYPE_TO_ABBREV,
+    OperationType,
+    TransformationTracker,
+)
 from ryandata_address_utils.core.zip_normalizer import (
     ZipCodeNormalizer,
     ZipCodeResult,
@@ -80,6 +86,10 @@
     "CleaningTracker",
     # Transformation tracking
     "TransformationTracker",
+    "OperationType",
+    "STREET_TYPE_TO_ABBREV",
+    "DIRECTION_TO_ABBREV",
+    "UNIT_TYPE_TO_ABBREV",
     # Validation (from abstract_validation_base)
     "BaseValidator",
     "CompositeValidator",