Add comprehensive documentation for RECEPTION dual-role implementation

Co-authored-by: fermga <203334638+fermga@users.noreply.github.com>

Author: Copilot

docs/RECEPTION_DUAL_ROLE.md

@@ -0,0 +1,188 @@
+# RECEPTION Dual-Role Frequency Classification
+
+## Issue Resolution
+
+**Issue**: [GRAMÁTICA CANÓNICA] Inconsistencia entre clasificación de frecuencias y reglas de bifurcación (P1)
+
+**Problem**: Structural inconsistency between RECEPTION operator frequency classification and its role in graduated bifurcation rules (R4).
+
+- RECEPTION classified as **medium** frequency in `STRUCTURAL_FREQUENCIES`
+- RECEPTION acts as **weak destabilizer** in graduated bifurcation windows
+- **Contradiction**: Medium νf cannot generate sufficient ΔNFR for ZHIR alone
+
+## Theoretical Foundation
+
+### Nodal Equation
+```
+∂EPI/∂t = νf · ΔNFR
+```
+
+Where:
+- **νf**: Structural frequency (reorganization rate)
+- **ΔNFR**: Internal reorganization gradient (structural pressure)
+
+### RECEPTION Dual Role
+
+**Base Frequency (νf)**:
+- Classification: `medium`
+- Represents: Structural capture rate
+- Effect: Moderate reorganization capacity
+
+**Destabilization Capacity (ΔNFR Generation)**:
+- Classification: `weak`
+- Condition: Requires prior coherent base
+- Effect: Can generate reorganization pressure when capturing external coherence into prepared node
+
+## Solution: Hybrid Category (Option C)
+
+### DUAL_FREQUENCY_OPERATORS Configuration
+
+```python
+DUAL_FREQUENCY_OPERATORS: dict[str, dict[str, str]] = {
+    RECEPTION: {
+        "base_freq": "medium",
+        "destabilization_capacity": "weak",
+        "conditions": "requires_prior_coherence",
+        "rationale": (
+            "Captures external coherence which can generate ΔNFR when "
+            "integrated into structurally prepared node"
+        ),
+    }
+}
+```
+
+### Context Validation
+
+RECEPTION as weak destabilizer requires:
+
+1. **Prior Stabilizer**: IL or THOL within 3 operators before EN
+2. **No Interruption**: No SILENCE between stabilizer and EN (would remove base)
+3. **Structural Preparation**: Node must have coherent base for EN to generate ΔNFR
+
+### Valid Patterns
+
+✅ **AL → EN → IL → EN → ZHIR**
+- First EN captures
+- IL stabilizes (creates coherent base)
+- Second EN destabilizes with context
+- ZHIR enabled by EN-generated ΔNFR
+
+✅ **EN → IL → EN → ZHIR**
+- First EN captures
+- IL stabilizes
+- Second EN has context
+- ZHIR enabled
+
+✅ **OZ → IL → EN → ZHIR**
+- OZ provides strong destabilization
+- IL resolves
+- EN has context from resolution
+- ZHIR enabled by OZ (EN's context not needed when stronger destabilizer present)
+
+### Invalid Patterns
+
+❌ **EN → ZHIR** (without context)
+- EN has no prior stabilizer
+- Medium νf alone insufficient for ZHIR
+- Violates structural coherence
+
+❌ **AL → EN → ZHIR** (no stabilization)
+- EN not stabilized by IL/THOL
+- No coherent base for destabilization
+- Cannot generate required ΔNFR
+
+❌ **AL → EN → IL → SHA → EN → ZHIR** (SILENCE interruption)
+- IL provides base
+- SHA removes base (νf → 0)
+- Second EN has no context
+- Cannot destabilize
+
+## Implementation
+
+### Files Modified
+
+1. **src/tnfr/operators/grammar.py**
+   - Added `DUAL_FREQUENCY_OPERATORS` constant
+   - Implemented `_validate_reception_context()` method
+   - Enhanced `_has_graduated_destabilizer()` with context validation
+   - Added extensive documentation
+
+2. **tests/unit/operators/test_reception_dual_role.py** (NEW)
+   - 21 comprehensive tests
+   - Coverage: valid contexts, invalid contexts, distance limits, SILENCE interruption
+   - Backward compatibility validation
+
+3. **tests/unit/operators/test_graduated_destabilizer_windows.py**
+   - Updated 1 test for more precise error reporting
+
+### Test Results
+
+- ✅ 21/21 dual-role tests passing
+- ✅ 26/26 graduated destabilizer tests passing
+- ✅ 27/27 grammar module tests passing
+- ✅ 17/17 bifurcation tests passing
+- ✅ **Total: 91/91 related tests passing**
+
+## Theoretical Implications
+
+### Why Context Matters
+
+From ∂EPI/∂t = νf · ΔNFR:
+
+1. **Base Operation**: EN with medium νf provides moderate reorganization rate
+2. **Context Multiplication**: When EN captures external coherence into prepared node:
+   - Integration creates structural tension
+   - Tension manifests as ΔNFR
+   - Product νf · ΔNFR sufficient for structural transformation
+3. **Without Context**: EN alone has medium νf but generates minimal ΔNFR
+   - Insufficient product for ZHIR (requires high transformation energy)
+   - Violates structural coherence principles
+
+### Frequency vs. Destabilization
+
+**Key Distinction**:
+- **Frequency (νf)**: Intrinsic reorganization capacity
+- **Destabilization (ΔNFR)**: Context-dependent gradient generation
+
+**RECEPTION uniqueness**:
+- Medium base frequency (inherent property)
+- Weak destabilization capacity (contextual property)
+- First operator with explicit dual classification
+
+## Future Considerations
+
+### Potential Dual-Role Operators
+
+Consider evaluating:
+- **COUPLING (UM)**: Medium frequency, could generate ΔNFR through synchronization
+- **TRANSITION (NAV)**: Medium frequency, already moderate destabilizer, possible context-dependent intensification
+- **RESONANCE (RA)**: High frequency, could have context-dependent amplification
+
+### Telemetry Enhancement
+
+Add tracking for:
+- Context validation decisions
+- RECEPTION destabilization success/failure rates
+- Distance between stabilizer and EN
+- SILENCE interruption frequency
+
+### Documentation Updates
+
+- [ ] Add to Mathematical Foundations document
+- [ ] Update operator reference with dual-role concept
+- [ ] Create visual diagrams for EN context patterns
+- [ ] Add examples to tutorials
+
+## References
+
+- **Issue**: GitHub Issue #[number]
+- **TNFR.pdf**: Section 2.1 - Ecuación Nodal
+- **Code**: `src/tnfr/operators/grammar.py:DUAL_FREQUENCY_OPERATORS`
+- **Tests**: `tests/unit/operators/test_reception_dual_role.py`
+- **Theory**: Resonant Fractal Nature Theory - Bifurcation and Emergence
+
+---
+
+**Implementation Date**: 2025-11-08  
+**Status**: ✅ Complete and Tested  
+**Backward Compatibility**: ✅ Preserved