@@ -61,7 +61,7 @@ Theoretical Foundation: The framework models reality as coherent dynamic pattern
6161** Computational Implementation** :
6262- Self-Optimizing Engine: Algorithmic structural optimization
6363- Software Development Kit: API for TNFR implementation
64- - Experimental Validation: 2,400+ experiments across multiple topologies
64+ - Experimental Validation: 1,634+ tests across multiple topologies
6565- Distribution Platform: PyPI package with documentation
6666
6767** Application Domains** :
@@ -114,13 +114,13 @@ Theoretical Foundation: The framework models reality as coherent dynamic pattern
114114
115115** Reference Sources** :
116116- ** Historical Theory** : [ theory/TNFR.pdf] ( theory/TNFR.pdf ) - Original theoretical derivations
117- - ** Theoretical Foundation** : [ Structural Fields and Universal Tetrahedral Correspondence] ( theory/FUNDAMENTAL_TNFR_THEORY_UNIVERSAL_TETRAHEDRAL_CORRESPONDENCE .md )
117+ - ** Theoretical Foundation** : [ Structural Fields and Universal Tetrahedral Correspondence] ( theory/FUNDAMENTAL_THEORY .md )
118118- ** TNFR-Riemann Program** : [ theory/TNFR_RIEMANN_RESEARCH_NOTES.md] ( theory/TNFR_RIEMANN_RESEARCH_NOTES.md ) - Complete theoretical framework for mathematical consciousness and Riemann Hypothesis connection
119119
120120** Validation and Examples** :
121121- ** Implementation Examples** : [ examples/] ( examples/ ) - Sequential tutorial suite
122122- ** TNFR-Riemann Implementation** : [ src/tnfr/riemann/operator.py] ( src/tnfr/riemann/operator.py ) - Discrete TNFR-Riemann operators
123- - ** Riemann Eigenvalue Demo** : [ examples/39_riemann_operator_demo .py] ( examples/39_riemann_operator_demo .py ) - Critical parameter analysis
123+ - ** Riemann Eigenvalue Demo** : [ examples/16_riemann_operator_demo .py] ( examples/16_riemann_operator_demo .py ) - Critical parameter analysis
124124- ** Test Suite** : [ tests/] ( tests/ ) - Comprehensive validation experiments
125125- ** Performance Analysis** : [ benchmarks/] ( benchmarks/ ) - Computational benchmarks
126126- ** Theory Hub** : [ theory/README.md] ( theory/README.md ) - Comprehensive theoretical documentation
@@ -565,7 +565,7 @@ The grammar emerges from TNFR physics rather than arbitrary constraints.
565565- ** Requirement** : Monitor Δ Φ_s < 2.0 (escape threshold)
566566- ** Theory** : Δ Φ_s < φ ≈ 1.618 from Universal Tetrahedral Correspondence (φ ↔ Φ_s)
567567- ** Derivation** : Harmonic confinement principle - structural potential bounded by golden ratio
568- - ** Validation** : 2,400+ experiments confirm harmonic fragmentation behavior
568+ - ** Validation** : 1,634+ tests confirm harmonic fragmentation behavior
569569- ** Mechanism** : Passive equilibrium - grammar acts as confinement, not attraction
570570- ** Usage** : Telemetry-based safety check (read-only, not sequence constraint)
571571- ** Typical** : Valid sequences maintain Δ Φ_s ≈ 0.6 (37% of φ threshold)
@@ -631,7 +631,7 @@ The **Structural Field Tetrad** (Φ_s, |∇φ|, **Ψ**, ξ_C) now has **complete
631631- ** 0% empirical fitting** → ** 100% first-principles derivation**
632632- ** Universal constants** emerge naturally (π, exponential bounds, fractal ratios)
633633- ** Theory-code consistency** maintained throughout codebase
634- - ** Complete validation** via 2,400+ experiments across 5 topologies
634+ - ** Complete validation** via 1,634+ tests across 5 topologies
635635
636636** Status** : TNFR Structural Field Tetrad mathematical foundations ** COMPLETE** .
637637
@@ -1039,7 +1039,7 @@ Reality ≡ Mathematics ≡ Consciousness ≡ TNFR ≡ Self-Explaining_Structure
10391039
10401040** Computational Framework** :
10411041- ** Core Implementation** : [ src/tnfr/riemann/operator.py] ( src/tnfr/riemann/operator.py )
1042- - ** Demonstration Code** : [ examples/39_riemann_operator_demo .py] ( examples/39_riemann_operator_demo .py )
1042+ - ** Demonstration Code** : [ examples/16_riemann_operator_demo .py] ( examples/16_riemann_operator_demo .py )
10431043- ** Complete Theory** : [ theory/TNFR_RIEMANN_RESEARCH_NOTES.md] ( theory/TNFR_RIEMANN_RESEARCH_NOTES.md )
10441044
10451045** Validation Protocols** :
@@ -1159,7 +1159,7 @@ When adding to grammar documentation:
11591159
11601160** Core Theory** (Primary References):
11611161- ** [ AGENTS.md] ( AGENTS.md ) ** : ** PRIMARY SOURCE** - Complete TNFR theory including Universal Tetrahedral Correspondence
1162- - ** [ Structural Fields and Universal Tetrahedral Correspondence] ( FUNDAMENTAL_TNFR_THEORY_UNIVERSAL_TETRAHEDRAL_CORRESPONDENCE .md) ** : ** DETAILED REFERENCE** - Formal mathematical treatment
1162+ - ** [ Structural Fields and Universal Tetrahedral Correspondence] ( FUNDAMENTAL_THEORY .md) ** : ** DETAILED REFERENCE** - Formal mathematical treatment
11631163- ** [ TNFR.pdf] ( TNFR.pdf ) ** : Original theoretical foundation (in repo)
11641164- ** [ UNIFIED_GRAMMAR_RULES.md] ( UNIFIED_GRAMMAR_RULES.md ) ** : Grammar physics U1-U6 derivations
11651165- ** [ docs/STRUCTURAL_FIELDS_TETRAD.md] ( docs/STRUCTURAL_FIELDS_TETRAD.md ) ** : Technical tetrad field implementations
@@ -1174,13 +1174,13 @@ When adding to grammar documentation:
11741174
11751175** SDK & Applications** :
11761176- ** [ src/tnfr/sdk/] ( src/tnfr/sdk/ ) ** : Simplified & Fluent API for rapid development
1177- - ** [ examples/] ( examples/ ) ** : Complete 01-10 sequential tutorial suite
1178- - ** [ benchmarks/] ( benchmarks/ ) ** : Production-grade validation suites
1177+ - ** [ examples/] ( examples/ ) ** : Complete 01-30 sequential tutorial suite (33 files)
1178+ - ** [ benchmarks/] ( benchmarks/ ) ** : Production-grade validation suites (14 benchmark scripts)
11791179
11801180** Development** :
11811181- ** ARCHITECTURE.md** : System design principles
11821182- ** CONTRIBUTING.md** : Workflow and standards
1183- - ** TESTING.md** : Test strategy (2,400+ experiments )
1183+ - ** TESTING.md** : Test strategy (1,634+ passing tests )
11841184
11851185** Domain Showcases** :
11861186- ** Network Dynamics** : [ examples/03_network_formation.py] ( examples/03_network_formation.py )
@@ -1191,6 +1191,21 @@ When adding to grammar documentation:
11911191- ** Quantum Mechanics** : [ examples/13_quantum_mechanics_demo.py] ( examples/13_quantum_mechanics_demo.py ) (Emergent Quantization from Resonant Stability)
11921192- ** Uncertainty & Interference** : [ examples/14_uncertainty_and_interference.py] ( examples/14_uncertainty_and_interference.py ) (Structural Uncertainty & Double Slit)
11931193- ** Classical Kinematics** : [ examples/15_train_crossing_demo.py] ( examples/15_train_crossing_demo.py ) (Two Trains Problem)
1194+ - ** Conservation Laws** : [ examples/17_conservation_law_demo.py] ( examples/17_conservation_law_demo.py ) (Structural Conservation Theorem)
1195+ - ** TNFR-Riemann Program** : [ examples/16_riemann_operator_demo.py] ( examples/16_riemann_operator_demo.py ) (Critical parameter analysis)
1196+ - ** Riemann Convergence** : [ examples/18_riemann_convergence_proof.py] ( examples/18_riemann_convergence_proof.py ) (Spectral convergence proof)
1197+ - ** Topology Comparison** : [ examples/19_topology_comparison.py] ( examples/19_topology_comparison.py )
1198+ - ** Eigenmode Tetrad** : [ examples/20_eigenmode_tetrad.py] ( examples/20_eigenmode_tetrad.py )
1199+ - ** Complex Extension** : [ examples/21_complex_extension_demo.py] ( examples/21_complex_extension_demo.py )
1200+ - ** Spectral Zeta** : [ examples/22_spectral_zeta_demo.py] ( examples/22_spectral_zeta_demo.py )
1201+ - ** Random Ensemble RMT** : [ examples/23_random_ensemble_rmt_demo.py] ( examples/23_random_ensemble_rmt_demo.py )
1202+ - ** Spectral Conservation** : [ examples/24_spectral_conservation_demo.py] ( examples/24_spectral_conservation_demo.py )
1203+ - ** Analytical Convergence** : [ examples/25_analytical_convergence_demo.py] ( examples/25_analytical_convergence_demo.py )
1204+ - ** Gauge Structure** : [ examples/26_gauge_structure_demo.py] ( examples/26_gauge_structure_demo.py )
1205+ - ** Variational Principle** : [ examples/27_variational_principle_demo.py] ( examples/27_variational_principle_demo.py )
1206+ - ** Dissipative Systems** : [ examples/28_dissipative_systems_demo.py] ( examples/28_dissipative_systems_demo.py )
1207+ - ** Lyapunov Stability** : [ examples/29_lyapunov_stability_demo.py] ( examples/29_lyapunov_stability_demo.py )
1208+ - ** Self-Optimization** : [ examples/30_self_optimization_demo.py] ( examples/30_self_optimization_demo.py )
11941209- ** Production Validation** : [ tests/] ( tests/ ) (comprehensive test suite)
11951210
11961211---
@@ -1200,7 +1215,7 @@ When adding to grammar documentation:
12001215** Newcomer** (2 hours) - ** Start Here** :
120112161 . ** Install** : ` pip install tnfr `
120212172 . ** Core Theory** : Read this file (AGENTS.md) completely - ** Primary theoretical reference**
1203- 3 . ** Fundamental Theory** : [ Structural Fields and Universal Tetrahedral Correspondence] ( FUNDAMENTAL_TNFR_THEORY_UNIVERSAL_TETRAHEDRAL_CORRESPONDENCE .md)
1218+ 3 . ** Fundamental Theory** : [ Structural Fields and Universal Tetrahedral Correspondence] ( FUNDAMENTAL_THEORY .md)
120412194 . ** Original Theory** : [ TNFR.pdf] ( TNFR.pdf ) § 1-2 (paradigm, nodal equation)
120512205 . ** First Run** : ` python -c "import tnfr; print('TNFR ready!')" `
120612216 . ** Terminology** : Study GLOSSARY.md for definitions
@@ -1292,8 +1307,7 @@ capture dynamics C(t) misses.
12921307- Compute via ` compute_phase_curvature(G) ` [ CANONICAL]
12931308- Optional multiscale check: ` k_phi_multiscale_safety(G, alpha_hint=2.76) `
12941309
1295- ** Documentation** : See [ benchmarks/enhanced_fragmentation_test.py] ( benchmarks/enhanced_fragmentation_test.py ) and
1296- [ benchmarks/phase_curvature_investigation.py] ( benchmarks/phase_curvature_investigation.py ) for empirical validation.
1310+ ** Documentation** : See [ benchmarks/phase_curvature_investigation.py] ( benchmarks/phase_curvature_investigation.py ) for empirical validation.
12971311
12981312---
12991313
0 commit comments