Skip to content

Commit ed8e9d6

Browse files
author
TNFR AI Agent
committed
v0.0.3: docs consolidation, benchmarks cleanup, documentation sync, DOI update
- docs/ consolidated: 19 -> 14 files (3 merges, 5 deletions) - benchmarks/ cleaned: 16 -> 14 Python files (2 deletions, 1 import fix) - AGENTS.md: fixed 3 broken theory links, 3 stale test counts, operator/SDK/examples/benchmark counts, expanded Domain Showcases with examples 21-30 - README.md: fixed all stale counts (operators 56, engines 7, SDK 7, examples 33, benchmarks 14, tests 1634+), theory link, DOI - .github/agents/my-agent.md: synced with AGENTS.md changes - .zenodo.json: version 0.0.3, DOI 10.5281/zenodo.18883306 - examples/ renumbered: 01-30 sequential suite (33 files) - theory/ consolidated: 14 files - Test baseline: 1634 passed, 9 skipped, 0 failures
1 parent 955fd34 commit ed8e9d6

471 files changed

Lines changed: 36910 additions & 24164 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/agents/my-agent.md

Lines changed: 27 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -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**:
12011216
1. **Install**: `pip install tnfr`
12021217
2. **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)
12041219
4. **Original Theory**: [TNFR.pdf](TNFR.pdf) § 1-2 (paradigm, nodal equation)
12051220
5. **First Run**: `python -c "import tnfr; print('TNFR ready!')"`
12061221
6. **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

.vscode/settings.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
11
{
2-
"git.ignoreLimitWarning": true
2+
"git.ignoreLimitWarning": true,
3+
"chat.agent.maxRequests": 500
34
}

.zenodo.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
{
22
"title": "TNFR-Python-Engine: Resonant Fractal Nature Theory Implementation",
33
"description": "Canonical computational implementation of TNFR - a paradigm shift from modeling 'things' to modeling coherent patterns that persist through resonance. This Python package provides the complete TNFR physics engine including the 13 structural operators, unified grammar validation (U1-U6), and the four canonical structural fields (Φ_s, |∇φ|, K_φ, ξ_C). Features include: nodal equation dynamics (∂EPI/∂t = νf·ΔNFR), structural potential confinement, phase synchronization, and multi-scale coherence analysis.",
4-
"version": "0.0.1",
5-
"publication_date": "2025-11-13",
6-
"doi": "10.5281/zenodo.17761312",
4+
"version": "0.0.3",
5+
"publication_date": "2026-03-06",
6+
"doi": "10.5281/zenodo.18883306",
77
"creators": [
88
{
99
"name": "FMG",

0 commit comments

Comments
 (0)