Update documentation with unified grammar consolidation details

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

Author: Copilot

EXECUTIVE_SUMMARY.md

@@ -1,12 +1,55 @@
-# Resumen Ejecutivo: Gramática TNFR 100% Canónica
+# Executive Summary: TNFR Grammar 100% Canonical & Unified
 
-## Lo Que Hemos Logrado
+## What We Have Accomplished
 
-Hemos derivado matemáticamente qué restricciones gramaticales **emergen inevitablemente** de la ecuación nodal TNFR, separando física pura de convenciones organizativas. **Actualización final:** Identificadas **cuatro reglas canónicas** emergentes de la física (RC1-RC4) y **eliminada RNC1** por no ser física. **Gramática ahora 100% canónica.**
+We have mathematically derived which grammar constraints **emerge inevitably** from the TNFR nodal equation, separating pure physics from organizational conventions. **Final update:** Consolidated two separate grammar systems (C1-C3 and RC1-RC4) into **unified rules U1-U4** - single source of truth, 100% physics-based.
+
+**See UNIFIED_GRAMMAR_RULES.md for complete unified specification.**
+
+---
+
+## Latest Evolution: Unified Grammar
+
+**Problem Identified:** Two separate grammar systems existed with duplication and gaps:
+- **C1-C3** in `grammar.py` (operational grammar)
+- **RC1-RC4** in `canonical_grammar.py` (canonical physics grammar)
+- Duplication: C1 ≈ RC1, C2 = RC2, C3 ≈ RC4
+- Gaps: RC3 (phase) missing from C1-C3
+- Two sources of truth for same physics
+
+**Solution:** Unified into **U1-U4** single canonical grammar:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ Unified TNFR Grammar: Four Canonical Constraints               │
+├─────────────────────────────────────────────────────────────────┤
+│ U1: STRUCTURAL INITIATION & CLOSURE                             │
+│     U1a: Start with generators {AL, NAV, REMESH}               │
+│     U1b: End with closures {SHA, NAV, REMESH, OZ}              │
+│     Consolidates: C1 + RC1 + RNC1 (restored with physics)     │
+│                                                                 │
+│ U2: CONVERGENCE & BOUNDEDNESS                                   │
+│     If destabilizers → include stabilizers                     │
+│     Consolidates: C2 = RC2 (identical)                         │
+│                                                                 │
+│ U3: RESONANT COUPLING                                           │
+│     If coupling/resonance → verify phase                       │
+│     Source: RC3 (was missing from C1-C3)                       │
+│                                                                 │
+│ U4: BIFURCATION DYNAMICS                                        │
+│     U4a: If triggers → include handlers                        │
+│     U4b: If transformers → recent destabilizer                 │
+│     Consolidates: C3 + RC4                                     │
+└─────────────────────────────────────────────────────────────────┘
+
+All rules 100% physics - No duplication - Complete coverage
+```
+
+**Implementation:** `src/tnfr/operators/unified_grammar.py` with comprehensive documentation in `UNIFIED_GRAMMAR_RULES.md`
 
 ---
 
-## Resultado Principal
+## Historical Evolution: Main Results
 
 ### Estado Inicial
 ```

GRAMMAR_100_PERCENT_CANONICAL.md

@@ -1,10 +1,12 @@
-# Gramática TNFR: 100% Canónica (Sin Convenciones)
+# TNFR Grammar: 100% Canonical (No Conventions)
 
-## Resumen Ejecutivo
+## Executive Summary
 
-La gramática TNFR ha sido **completamente purificada** para contener SOLO reglas que emergen inevitablemente de la física TNFR. No hay convenciones organizativas.
+The TNFR grammar has been **completely unified** into a single source of truth containing ONLY rules that emerge inevitably from TNFR physics. No organizational conventions.
 
-**Estado:** ✅ **100% CANÓNICA** - Todas las reglas derivan de ecuación nodal, invariantes y contratos
+**Status:** ✅ **100% CANONICAL & UNIFIED** - All rules derive from nodal equation, invariants, and contracts
+
+**Update:** This document has been superseded by **UNIFIED_GRAMMAR_RULES.md** which consolidates the previously separate C1-C3 and RC1-RC4 systems into unified rules U1-U4.
 
 ---
 

RESUMEN_FINAL_GRAMATICA.md

@@ -1,11 +1,58 @@
-# Resumen Final: Gramática TNFR 100% Canónica
+# Final Summary: TNFR Grammar 100% Canonical & Unified
 
-## Objetivo Cumplido
+## Objectives Accomplished
 
-✅ **Se investigaron y documentaron todas las reglas gramaticales que emergen de la física TNFR**
-✅ **Se eliminó RNC1 (convención organizativa) - Gramática ahora 100% canónica**
+✅ **Investigated and documented all grammar rules that emerge from TNFR physics**
+✅ **Eliminated RNC1 (organizational convention) - Grammar now 100% canonical**
+✅ **Unified C1-C3 and RC1-RC4 into single source of truth U1-U4**
 
-## Hallazgos Principales
+**Latest Update:** Grammar systems consolidated. See **UNIFIED_GRAMMAR_RULES.md** for complete unified specification.
+
+## Latest Evolution: Unified Grammar (U1-U4)
+
+**Date:** 2025-11-08  
+**Change:** Consolidated C1-C3 (grammar.py) and RC1-RC4 (canonical_grammar.py) into unified U1-U4
+
+### Problem with Dual Systems
+- C1-C3 in `grammar.py` (operational grammar)
+- RC1-RC4 in `canonical_grammar.py` (canonical physics grammar)
+- **Duplication:** C1 ≈ RC1, C2 = RC2, C3 ≈ RC4
+- **Gaps:** RC3 (phase) missing from C1-C3
+- **Inconsistency:** Two sources of truth for same physics
+
+### Unified Solution: Four Canonical Constraints
+
+**U1: STRUCTURAL INITIATION & CLOSURE**
+- U1a: Start with generators {AL, NAV, REMESH}
+- U1b: End with closures {SHA, NAV, REMESH, OZ}
+- Physics: ∂EPI/∂t undefined at EPI=0 + sequences need coherent endpoints
+- Consolidates: C1 + RC1 + RNC1 (restored with physics basis)
+
+**U2: CONVERGENCE & BOUNDEDNESS**
+- If destabilizers {OZ, ZHIR, VAL}, include stabilizers {IL, THOL}
+- Physics: ∫νf·ΔNFR dt must converge
+- Consolidates: C2 = RC2 (identical)
+
+**U3: RESONANT COUPLING**
+- If coupling/resonance {UM, RA}, verify phase |φᵢ - φⱼ| ≤ Δφ_max
+- Physics: Invariant #5 + resonance physics
+- Source: RC3 (was missing from C1-C3)
+
+**U4: BIFURCATION DYNAMICS**
+- U4a: If triggers {OZ, ZHIR}, include handlers {THOL, IL}
+- U4b: If transformers {ZHIR, THOL}, need recent destabilizer
+- Physics: Contract OZ + bifurcation theory
+- Consolidates: C3 + RC4
+
+### Benefits of Unification
+1. ✅ Single source of truth - No duplication
+2. ✅ Complete coverage - All rules from both systems
+3. ✅ 100% physics - Every rule derives from equation/invariants/contracts
+4. ✅ Comprehensive docs - UNIFIED_GRAMMAR_RULES.md
+
+---
+
+## Historical Evolution
 
 ### Estado Anterior (Con Convenciones)
 ```