feat(naming): rename decorators/, errors/, protocols/ files (OMN-1217, OMN-1218, OMN-1219)

.github/workflows/test.yml

@@ -16,7 +16,7 @@ concurrency:
 env:
   POETRY_VERSION: "2.2.1"
   PYTHON_VERSION: "3.12"
-  CACHE_VERSION: "0.1.4"
+  CACHE_VERSION: "0.1.5"
 
 jobs:
   # =============================================================================

CLAUDE.md

@@ -396,7 +396,7 @@ raise ModelOnexError(
 #### Use @standard_error_handling decorator:
 
 ```python
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 
 @standard_error_handling  # Eliminates 6+ lines of try/catch boilerplate
 async def my_operation(self):

docs/MVP_PLAN.md

@@ -1311,7 +1311,7 @@ Create centralized validation layer that validates contracts at node load time.
 **Description**:
 Define canonical error classes for the validation and adapter logic. Makes debugging tolerable and stack traces meaningful.
 
-**Location**: `src/omnibase_core/errors/declarative_errors.py`
+**Location**: `src/omnibase_core/errors/error_declarative.py`
 
 **Acceptance Criteria**:
 - [ ] `ContractValidationError` - invalid contract structure

docs/architecture/EXECUTION_SHAPE_EXAMPLES.md

@@ -323,7 +323,7 @@ from omnibase_core.models.container.model_onex_container import ModelONEXContain
 from omnibase_core.models.fsm.model_intent import ModelIntent
 from omnibase_core.models.results.model_intent_result import ModelIntentResult
 from omnibase_core.enums.enum_intent_type import EnumIntentType
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 
 
 class NodeDatabaseWriterEffect(NodeEffect):
@@ -664,7 +664,7 @@ from pydantic import BaseModel
 
 from omnibase_core.nodes import NodeEffect
 from omnibase_core.models.container.model_onex_container import ModelONEXContainer
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 
 
 router = APIRouter()

docs/architecture/adr/ADR-012-VALIDATOR-ERROR-HANDLING.md

@@ -218,7 +218,7 @@ With `ValueError`, this logic requires fragile string parsing.
 **Pattern**: Validators using `ModelOnexError` integrate seamlessly with ONEX error handling decorators:
 
 ```python
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 
 class NodeMyReducer(NodeReducer):
     @standard_error_handling  # Catches ModelOnexError, logs with context

docs/architecture/decisions/ADR-003-reducer-output-exception-consistency.md

@@ -410,7 +410,7 @@ except ModelOnexError as e:
 
 **Business Logic Errors** (node operations):
 ```python
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 
 @standard_error_handling
 async def execute_reduction(self, input_data: ModelReducerInput):

docs/reference/api/utils.md

@@ -13,14 +13,14 @@ This document provides comprehensive API reference for utility functions and hel
 
 ### standard_error_handling
 
-**Location**: `omnibase_core.decorators.error_handling`
+**Location**: `omnibase_core.decorators.decorator_error_handling`
 
 **Purpose**: Decorator that provides standard error handling pattern for ONEX operations.
 
 This decorator eliminates 6+ lines of boilerplate error handling code and ensures consistent error patterns across all nodes.
 
 ```
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 
 @standard_error_handling(operation_name="data processing")
 async def process_data(self, input_data):
@@ -47,14 +47,14 @@ except Exception as e:
 
 ### validation_error_handling
 
-**Location**: `omnibase_core.decorators.error_handling`
+**Location**: `omnibase_core.decorators.decorator_error_handling`
 
 **Purpose**: Decorator for validation operations that may throw ValidationError.
 
 Similar to `standard_error_handling` but specifically designed for validation operations.
 
 ```
-from omnibase_core.decorators.error_handling import validation_error_handling
+from omnibase_core.decorators.decorator_error_handling import validation_error_handling
 
 @validation_error_handling(operation_name="input validation")
 def validate_user_input(self, user_data):
@@ -290,7 +290,7 @@ Provides additional decorators for common patterns in ONEX development.
 ### Error Handling Pattern
 
 ```
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 from omnibase_core.models.errors.model_onex_error import ModelOnexError
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 
@@ -358,7 +358,7 @@ class MyNode(NodeCoreBase):
 3. **YAML Loading**: Use `load_and_validate_yaml_model` for type-safe YAML loading with validation
 4. **Import Paths**: The correct import path for `standard_error_handling` is:
    ```python
-   from omnibase_core.decorators.error_handling import standard_error_handling
+   from omnibase_core.decorators.decorator_error_handling import standard_error_handling
    ```
    NOT `from omnibase_core.utils.standard_error_handling`
 

docs/reference/templates/EFFECT_NODE_TEMPLATE.md

@@ -92,7 +92,7 @@ from omnibase_core.enums.enum_effect_types import (
     EnumTransactionState,
     EnumCircuitBreakerState,
 )
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 from omnibase_core.utils.error_sanitizer import ErrorSanitizer
 
 from .config import {DomainCamelCase}{MicroserviceCamelCase}EffectConfig

docs/reference/templates/ORCHESTRATOR_NODE_TEMPLATE.md

@@ -87,7 +87,7 @@ from omnibase_core.models.contracts.subcontracts.model_workflow_definition impor
 )
 from omnibase_core.models.errors.model_onex_error import ModelOnexError
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 from omnibase_core.utils.error_sanitizer import ErrorSanitizer
 
 from .config import {DomainCamelCase}{MicroserviceCamelCase}OrchestratorConfig
@@ -1464,7 +1464,7 @@ dependencies:
         - "models.orchestrator.model_orchestrator_input"
         - "models.orchestrator.model_orchestrator_output"
         - "enums.enum_workflow_execution"
-        - "decorators.error_handling"
+        - "decorators.decorator_error_handling"
         - "errors.model_onex_error"
 
 # Interface contracts
@@ -1606,7 +1606,7 @@ from omnibase_core.nodes import (
 from omnibase_core.models.container.model_onex_container import ModelONEXContainer
 
 # Error handling
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 from omnibase_core.models.errors.model_onex_error import ModelOnexError
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 ```

docs/release/V040_RELEASE_CHECKLIST.md

@@ -1198,7 +1198,7 @@ sys.exit(0)  # Explicit success exit
     ```bash
     # Generate error object snapshot with all observability fields
     poetry run python -c "
-    from omnibase_core.errors.declarative_errors import NodeExecutionError
+    from omnibase_core.errors.error_declarative import NodeExecutionError
     import json
 
     # Create error with all observability fields

src/omnibase_core/backends/cache/backend_cache_redis.py

@@ -347,7 +347,7 @@ def __init__(
         self._default_ttl = default_ttl
         self._max_connections = max_connections
         self._pool: ConnectionPoolType | None = None
-        self._client: Redis[str] | None = None
+        self._client: Redis | None = None
         self._connected = False
 
     @property

src/omnibase_core/decorators/__init__.py

@@ -3,19 +3,19 @@
 Provides decorators to mark legitimate exceptions to ONEX strict typing standards.
 """
 
-from .allow_dict_any import allow_dict_any
-from .convert_to_schema import (
+from .decorator_allow_dict_any import allow_dict_any
+from .decorator_convert_to_schema import (
     convert_dict_to_schema,
     convert_list_to_schema,
     convert_to_schema,
 )
 from .decorator_enforce_execution_shape import enforce_execution_shape
-from .error_handling import (
+from .decorator_error_handling import (
     io_error_handling,
     standard_error_handling,
     validation_error_handling,
 )
-from .pattern_exclusions import (
+from .decorator_pattern_exclusions import (
     allow_any_type,
     allow_legacy_pattern,
     allow_mixed_types,

src/omnibase_core/errors/__init__.py

@@ -4,30 +4,30 @@
 # These symbols are re-exported via __all__ and resolved at runtime
 # through __getattr__ to avoid circular import dependencies.
 if TYPE_CHECKING:
-    from omnibase_core.errors.declarative_errors import (
+    from omnibase_core.errors.error_callable_not_found import CallableNotFoundError
+    from omnibase_core.errors.error_declarative import (
         AdapterBindingError,
         NodeExecutionError,
         PurityViolationError,
         UnsupportedCapabilityError,
     )
-    from omnibase_core.errors.error_callable_not_found import CallableNotFoundError
     from omnibase_core.errors.error_dependency_cycle import DependencyCycleError
     from omnibase_core.errors.error_duplicate_hook import DuplicateHookError
     from omnibase_core.errors.error_hook_registry_frozen import HookRegistryFrozenError
     from omnibase_core.errors.error_hook_timeout import HookTimeoutError
     from omnibase_core.errors.error_hook_type_mismatch import HookTypeMismatchError
     from omnibase_core.errors.error_pipeline import PipelineError
-    from omnibase_core.errors.error_unknown_dependency import UnknownDependencyError
-    from omnibase_core.errors.exception_compute_pipeline_error import (
-        ComputePipelineError,
-    )
-    from omnibase_core.errors.runtime_errors import (
+    from omnibase_core.errors.error_runtime import (
         ContractValidationError,
         EventBusError,
         HandlerExecutionError,
         InvalidOperationError,
         RuntimeHostError,
     )
+    from omnibase_core.errors.error_unknown_dependency import UnknownDependencyError
+    from omnibase_core.errors.exception_compute_pipeline_error import (
+        ComputePipelineError,
+    )
     from omnibase_core.models.common.model_onex_warning import ModelOnexWarning
     from omnibase_core.models.common.model_registry_error import ModelRegistryError
     from omnibase_core.models.core.model_cli_adapter import ModelCLIAdapter
@@ -123,8 +123,8 @@
 # - ModelOnexError, OnexError (alias) - from models.errors
 # - ModelOnexWarning, ModelRegistryError - from models.common
 # - ModelCLIAdapter - from models.core
-# - RuntimeHostError, HandlerExecutionError, etc. - from errors.runtime_errors
-# - AdapterBindingError, PurityViolationError, etc. - from errors.declarative_errors
+# - RuntimeHostError, HandlerExecutionError, etc. - from errors.error_runtime
+# - AdapterBindingError, PurityViolationError, etc. - from errors.error_declarative
 # - PipelineError, CallableNotFoundError, etc. - from errors.error_* modules
 # =============================================================================
 def __getattr__(name: str) -> Any:
@@ -177,9 +177,9 @@ def __getattr__(name: str) -> Any:
         "ContractValidationError",
     }
     if name in _runtime_error_classes:
-        from omnibase_core.errors import runtime_errors
+        from omnibase_core.errors import error_runtime
 
-        return getattr(runtime_errors, name)
+        return getattr(error_runtime, name)
 
     # Compute pipeline errors
     if name == "ComputePipelineError":
@@ -204,9 +204,9 @@ def __getattr__(name: str) -> Any:
         "UnsupportedCapabilityError",
     }
     if name in _declarative_error_classes:
-        from omnibase_core.errors import declarative_errors
+        from omnibase_core.errors import error_declarative
 
-        return getattr(declarative_errors, name)
+        return getattr(error_declarative, name)
 
     # -------------------------------------------------------------------------
     # Pipeline errors - consolidated import from individual modules

src/omnibase_core/errors/declarative_errors.py → src/omnibase_core/errors/error_declarative.py

@@ -18,7 +18,7 @@
 - Structured fields for logging and observability
 
 Usage:
-    from omnibase_core.errors.declarative_errors import (
+    from omnibase_core.errors.error_declarative import (
         AdapterBindingError,
         PurityViolationError,
         NodeExecutionError,

src/omnibase_core/errors/runtime_errors.py → src/omnibase_core/errors/error_runtime.py

@@ -25,7 +25,7 @@
 - No circular dependencies
 
 Usage:
-    from omnibase_core.errors.runtime_errors import (
+    from omnibase_core.errors.error_runtime import (
         RuntimeHostError,
         HandlerExecutionError,
         EventBusError,

src/omnibase_core/errors/exception_adapter_binding_error.py

@@ -28,7 +28,7 @@
 
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 from omnibase_core.enums.enum_onex_status import EnumOnexStatus
-from omnibase_core.errors.runtime_errors import RuntimeHostError
+from omnibase_core.errors.error_runtime import RuntimeHostError
 
 
 class AdapterBindingError(RuntimeHostError):

src/omnibase_core/errors/exception_node_execution_error.py

@@ -28,7 +28,7 @@
 
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 from omnibase_core.enums.enum_onex_status import EnumOnexStatus
-from omnibase_core.errors.runtime_errors import RuntimeHostError
+from omnibase_core.errors.error_runtime import RuntimeHostError
 
 
 class NodeExecutionError(RuntimeHostError):

src/omnibase_core/errors/exception_purity_violation_error.py

@@ -28,7 +28,7 @@
 
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 from omnibase_core.enums.enum_onex_status import EnumOnexStatus
-from omnibase_core.errors.runtime_errors import RuntimeHostError
+from omnibase_core.errors.error_runtime import RuntimeHostError
 
 
 class PurityViolationError(RuntimeHostError):

src/omnibase_core/errors/exception_unsupported_capability_error.py

@@ -28,7 +28,7 @@
 
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 from omnibase_core.enums.enum_onex_status import EnumOnexStatus
-from omnibase_core.errors.runtime_errors import RuntimeHostError
+from omnibase_core.errors.error_runtime import RuntimeHostError
 
 
 class UnsupportedCapabilityError(RuntimeHostError):

src/omnibase_core/mixins/mixin_caching.py

@@ -64,7 +64,7 @@ def __init__(self, container):
 import time
 from typing import TYPE_CHECKING, Any
 
-from omnibase_core.decorators.allow_dict_any import allow_dict_any
+from omnibase_core.decorators.decorator_allow_dict_any import allow_dict_any
 from omnibase_core.enums import EnumCoreErrorCode
 from omnibase_core.models.errors.model_onex_error import ModelOnexError
 from omnibase_core.types.typed_dict_mixin_types import TypedDictCacheStats

src/omnibase_core/models/capabilities/model_capability_requirement_set.py

@@ -52,7 +52,7 @@
 
 from pydantic import BaseModel, ConfigDict, Field, model_validator
 
-from omnibase_core.decorators.allow_dict_any import allow_dict_any
+from omnibase_core.decorators.decorator_allow_dict_any import allow_dict_any
 from omnibase_core.types.type_json import JsonType
 
 # =============================================================================

src/omnibase_core/models/container/model_onex_container.py

@@ -34,7 +34,7 @@
 
 from typing import TYPE_CHECKING, TypeVar, cast
 
-from omnibase_core.decorators.allow_dict_any import allow_dict_any
+from omnibase_core.decorators.decorator_allow_dict_any import allow_dict_any
 from omnibase_core.models.errors.model_onex_error import ModelOnexError
 from omnibase_core.types.type_serializable_value import (
     SerializableValue,

src/omnibase_core/models/context/model_effect_template_context.py

@@ -45,7 +45,7 @@
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 
-from omnibase_core.decorators.allow_dict_any import allow_dict_any
+from omnibase_core.decorators.decorator_allow_dict_any import allow_dict_any
 
 __all__ = ["ModelEffectTemplateContext"]
 

src/omnibase_core/models/effect/model_effect_input.py

@@ -70,7 +70,7 @@
 from pydantic import BaseModel, Field, model_validator
 
 from omnibase_core.constants import TIMEOUT_DEFAULT_MS
-from omnibase_core.decorators.allow_dict_any import allow_dict_any
+from omnibase_core.decorators.decorator_allow_dict_any import allow_dict_any
 from omnibase_core.enums.enum_effect_types import EnumEffectType
 from omnibase_core.models.context import ModelEffectInputData
 from omnibase_core.models.effect.model_effect_metadata import ModelEffectMetadata

src/omnibase_core/models/intents/model_registration_record_base.py

@@ -61,7 +61,7 @@
 
 from pydantic import BaseModel, ConfigDict
 
-from omnibase_core.decorators.allow_dict_any import allow_dict_any
+from omnibase_core.decorators.decorator_allow_dict_any import allow_dict_any
 
 
 class ModelRegistrationRecordBase(BaseModel):

src/omnibase_core/models/operations/model_effect_operation_config.py

@@ -35,7 +35,7 @@
     EFFECT_OPERATION_DESCRIPTION_MAX_LENGTH,
     EFFECT_OPERATION_NAME_MAX_LENGTH,
 )
-from omnibase_core.decorators.allow_dict_any import allow_dict_any
+from omnibase_core.decorators.decorator_allow_dict_any import allow_dict_any
 from omnibase_core.models.contracts.subcontracts.model_effect_circuit_breaker import (
     ModelEffectCircuitBreaker,
 )

src/omnibase_core/models/operations/model_operationparameters.py

@@ -1,6 +1,6 @@
 from pydantic import BaseModel, Field
 
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 from omnibase_core.models.errors.model_onex_error import ModelOnexError
 from omnibase_core.models.operations.model_operation_parameters_base import (

src/omnibase_core/models/services/model_node_service_config.py

@@ -14,7 +14,7 @@
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
-from omnibase_core.decorators.error_handling import standard_error_handling
+from omnibase_core.decorators.decorator_error_handling import standard_error_handling
 from omnibase_core.enums.enum_core_error_code import EnumCoreErrorCode
 from omnibase_core.enums.enum_log_level import EnumLogLevel as LogLevel
 from omnibase_core.enums.enum_service_mode import EnumServiceMode