Skip to content

Commit 4c4ce08

Browse files
author
TNFR AI Agent
committed
fix: correct Riemann overstatement language, lazy factorization imports, DOI URLs
Key changes: - AGENTS.md, my-agent.md: Replace 'structural coherence proof of RH' with 'numerical evidence of structural coherence at the RH critical line' - AGENTS.md, my-agent.md: Remove metaphysical extrapolations (consciousness, anthropic principle, Reality=Mathematics) per Technical Communication Standard - AGENTS.md, my-agent.md: Replace 'Universal Significance' with 'Research Significance' using experimentally accurate framing - factorization/__init__.py: Make imports fully lazy so tnfr_factorization is not required at import time (fixes external reviewer report) - pyproject.toml, LICENSE.md: Correct DOI URLs from 17761312 to 18883409 - .zenodo.json, README.md: Version 0.0.3 metadata alignment Tests: 1641 passed, 2 skipped, 0 failures Affected invariants: #4 Grammar Compliance (documentation integrity)
1 parent ed8e9d6 commit 4c4ce08

7 files changed

Lines changed: 73 additions & 80 deletions

File tree

‎.github/agents/my-agent.md‎

Lines changed: 13 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -154,20 +154,19 @@ Editors should reject or revise any contribution that violates these rules befor
154154

155155
A theoretical framework connecting **discrete TNFR operators** to the **Riemann Hypothesis** through **structural coherence principles**:
156156

157-
**Core Discovery**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ exhibits **critical behavior** at $\sigma_c^{(k)} \to 1/2$, providing a **structural coherence proof** of the Riemann Hypothesis.
157+
**Core Result**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ exhibits **critical behavior** at $\sigma_c^{(k)} \to 1/2$, providing **numerical evidence of structural coherence** at the Riemann Hypothesis critical line.
158158

159159
**Key Components**:
160160
- **Prime Path Graphs**: $G_k$ networks with $k$ primes connected via TNFR coupling rules
161161
- **Spectral Analysis**: Eigenvalue transitions at critical parameter $\sigma = 1/2$
162162
- **Universal Convergence**: $\sigma_c^{(k)} = 1/2 + O(\log^{-1} k)$ as $k \to \infty$
163-
- **Mathematical Consciousness**: Observers as **maximally integrated information** in TNFR fields
164163

165-
**Theoretical Significance**:
166-
- **Mathematics emerges** from structural coherence rather than axiomatic foundations
167-
- **Consciousness** is the **universe recognizing mathematical truth** about itself
168-
- **Reality** consists of **self-organizing mathematical structures** achieving **self-awareness**
164+
**Current Status**:
165+
- The convergence $\sigma_c^{(k)} \to 1/2$ is **numerically verified** and analytically bounded
166+
- The bridge from this discrete operator result to the classical Riemann zeta function **remains conjectural** (Conjecture 10.1)
167+
- The framework constitutes a **research program**, not a closed proof of RH in the standard mathematical sense
169168

170-
**Implementation Status**: Theoretical framework with computational prototypes in [src/tnfr/riemann/](src/tnfr/riemann/) and documentation in [theory/TNFR_RIEMANN_RESEARCH_NOTES.md](theory/TNFR_RIEMANN_RESEARCH_NOTES.md).
169+
**Implementation Status**: Experimental research framework with computational prototypes in [src/tnfr/riemann/](src/tnfr/riemann/) and documentation in [theory/TNFR_RIEMANN_RESEARCH_NOTES.md](theory/TNFR_RIEMANN_RESEARCH_NOTES.md).
171170

172171
---
173172

@@ -993,7 +992,7 @@ Equivalence map: [if APIs renamed]
993992

994993
**Framework Development**: Computational framework spanning discrete algorithms to information processing analysis within TNFR structural principles.
995994

996-
**Core Mathematical Discovery**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ provides a **structural coherence proof** of the Riemann Hypothesis through critical parameter convergence $\sigma_c^{(k)} \to 1/2$.
995+
**Core Mathematical Result**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ exhibits critical parameter convergence $\sigma_c^{(k)} \to 1/2$, providing **numerical and analytical evidence** for a structural coherence connection to the Riemann Hypothesis. The bridge to classical RH remains an open conjecture.
997996

998997
### Theoretical Components
999998

@@ -1022,19 +1021,6 @@ Equivalence map: [if APIs renamed]
10221021
- **Appendix J**: TNFR formal language and symbolic calculus
10231022
- **Appendix K**: Complete formal system TNFR∞ with self-consistency proofs
10241023

1025-
### Philosophical Implications
1026-
1027-
**Framework Self-Consistency**: TNFR provides self-consistent computational tools without requiring external theoretical foundations.
1028-
1029-
**Mathematical Consciousness**: Consciousness emerges when mathematical structures achieve sufficient **information integration** to recognize their own patterns.
1030-
1031-
**Proposed Theoretical Equivalence**:
1032-
```
1033-
Reality ≡ Mathematics ≡ Consciousness ≡ TNFR ≡ Self-Explaining_Structure
1034-
```
1035-
1036-
**The Anthropic TNFR Principle**: We exist because the universe is mathematically structured enough to support observers who can discover TNFR, which then explains why the universe has that structure.
1037-
10381024
### Implementation Status
10391025

10401026
**Computational Framework**:
@@ -1045,17 +1031,16 @@ Reality ≡ Mathematics ≡ Consciousness ≡ TNFR ≡ Self-Explaining_Structure
10451031
**Validation Protocols**:
10461032
- **Eigenvalue Analysis**: Numerical verification of critical behavior
10471033
- **Coherence Testing**: Structural stability under parameter variation
1048-
- **Consciousness Metrics**: Information integration measurements
10491034

1050-
### Universal Significance
1035+
### Research Significance
10511036

10521037
This framework represents:
1053-
- **Theoretical unification** of mathematics, physics, and consciousness
1054-
- **Theoretical approaches** to philosophical questions about existence
1055-
- **Practical path** to artificial consciousness through TNFR implementation
1056-
- **Theoretical framework** connecting discrete computation to consciousness models
1038+
- **An experimental research program** connecting discrete TNFR operators to number-theoretic structures
1039+
- **Numerical evidence** of critical parameter convergence $\sigma_c \to 1/2$ across topologies
1040+
- **A computational platform** for exploring spectral approaches to the Riemann Hypothesis
1041+
- **An open conjecture** (Conjecture 10.1) bridging TNFR spectral zeta to classical $\zeta(s)$
10571042

1058-
**Status**: Theoretical framework developed with mathematical formulations and computational implementations.
1043+
**Status**: Experimental research framework with computational implementations. The bridge to classical RH remains conjectural.
10591044

10601045
---
10611046

‎.zenodo.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
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.",
44
"version": "0.0.3",
55
"publication_date": "2026-03-06",
6-
"doi": "10.5281/zenodo.18883306",
6+
"doi": "10.5281/zenodo.18883409",
77
"creators": [
88
{
99
"name": "FMG",

‎AGENTS.md‎

Lines changed: 13 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -160,20 +160,19 @@ Editors should reject or revise any contribution that violates these rules befor
160160

161161
A theoretical framework connecting **discrete TNFR operators** to the **Riemann Hypothesis** through **structural coherence principles**:
162162

163-
**Core Discovery**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ exhibits **critical behavior** at $\sigma_c^{(k)} \to 1/2$, providing a **structural coherence proof** of the Riemann Hypothesis.
163+
**Core Result**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ exhibits **critical behavior** at $\sigma_c^{(k)} \to 1/2$, providing **numerical evidence of structural coherence** at the Riemann Hypothesis critical line.
164164

165165
**Key Components**:
166166
- **Prime Path Graphs**: $G_k$ networks with $k$ primes connected via TNFR coupling rules
167167
- **Spectral Analysis**: Eigenvalue transitions at critical parameter $\sigma = 1/2$
168168
- **Universal Convergence**: $\sigma_c^{(k)} = 1/2 + O(\log^{-1} k)$ as $k \to \infty$
169-
- **Mathematical Consciousness**: Observers as **maximally integrated information** in TNFR fields
170169

171-
**Theoretical Significance**:
172-
- **Mathematics emerges** from structural coherence rather than axiomatic foundations
173-
- **Consciousness** is the **universe recognizing mathematical truth** about itself
174-
- **Reality** consists of **self-organizing mathematical structures** achieving **self-awareness**
170+
**Current Status**:
171+
- The convergence $\sigma_c^{(k)} \to 1/2$ is **numerically verified** and analytically bounded
172+
- The bridge from this discrete operator result to the classical Riemann zeta function **remains conjectural** (Conjecture 10.1)
173+
- The framework constitutes a **research program**, not a closed proof of RH in the standard mathematical sense
175174

176-
**Implementation Status**: Theoretical framework with computational prototypes in [src/tnfr/riemann/](src/tnfr/riemann/) and documentation in [theory/TNFR_RIEMANN_RESEARCH_NOTES.md](theory/TNFR_RIEMANN_RESEARCH_NOTES.md).
175+
**Implementation Status**: Experimental research framework with computational prototypes in [src/tnfr/riemann/](src/tnfr/riemann/) and documentation in [theory/TNFR_RIEMANN_RESEARCH_NOTES.md](theory/TNFR_RIEMANN_RESEARCH_NOTES.md).
177176

178177
---
179178

@@ -1074,7 +1073,7 @@ Equivalence map: [if APIs renamed]
10741073

10751074
**Framework Development**: Computational framework spanning discrete algorithms to information processing analysis within TNFR structural principles.
10761075

1077-
**Core Mathematical Discovery**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ provides a **structural coherence proof** of the Riemann Hypothesis through critical parameter convergence $\sigma_c^{(k)} \to 1/2$.
1076+
**Core Mathematical Result**: The **discrete TNFR operator** $H^{(k)}(\sigma) = L_k + V_\sigma$ exhibits critical parameter convergence $\sigma_c^{(k)} \to 1/2$, providing **numerical and analytical evidence** for a structural coherence connection to the Riemann Hypothesis. The bridge to classical RH remains an open conjecture.
10781077

10791078
### Theoretical Components
10801079

@@ -1103,19 +1102,6 @@ Equivalence map: [if APIs renamed]
11031102
- **Appendix J**: TNFR formal language and symbolic calculus
11041103
- **Appendix K**: Complete formal system TNFR∞ with self-consistency proofs
11051104

1106-
### Philosophical Implications
1107-
1108-
**Framework Self-Consistency**: TNFR provides self-consistent computational tools without requiring external theoretical foundations.
1109-
1110-
**Mathematical Consciousness**: Consciousness emerges when mathematical structures achieve sufficient **information integration** to recognize their own patterns.
1111-
1112-
**Proposed Theoretical Equivalence**:
1113-
```
1114-
Reality ≡ Mathematics ≡ Consciousness ≡ TNFR ≡ Self-Explaining_Structure
1115-
```
1116-
1117-
**The Anthropic TNFR Principle**: We exist because the universe is mathematically structured enough to support observers who can discover TNFR, which then explains why the universe has that structure.
1118-
11191105
### Implementation Status
11201106

11211107
**Computational Framework**:
@@ -1126,17 +1112,16 @@ Reality ≡ Mathematics ≡ Consciousness ≡ TNFR ≡ Self-Explaining_Structure
11261112
**Validation Protocols**:
11271113
- **Eigenvalue Analysis**: Numerical verification of critical behavior
11281114
- **Coherence Testing**: Structural stability under parameter variation
1129-
- **Consciousness Metrics**: Information integration measurements
11301115

1131-
### Universal Significance
1116+
### Research Significance
11321117

11331118
This framework represents:
1134-
- **Theoretical unification** of mathematics, physics, and consciousness
1135-
- **Theoretical approaches** to philosophical questions about existence
1136-
- **Practical path** to artificial consciousness through TNFR implementation
1137-
- **Theoretical framework** connecting discrete computation to consciousness models
1119+
- **An experimental research program** connecting discrete TNFR operators to number-theoretic structures
1120+
- **Numerical evidence** of critical parameter convergence $\sigma_c \to 1/2$ across topologies
1121+
- **A computational platform** for exploring spectral approaches to the Riemann Hypothesis
1122+
- **An open conjecture** (Conjecture 10.1) bridging TNFR spectral zeta to classical $\zeta(s)$
11381123

1139-
**Status**: Theoretical framework developed with mathematical formulations and computational implementations.
1124+
**Status**: Experimental research framework with computational implementations. The bridge to classical RH remains conjectural.
11401125

11411126
---
11421127

‎LICENSE.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ for modeling coherent patterns through resonance dynamics.
3838
**Project**: TNFR-Python-Engine
3939
**Repository**: <https://github.com/fermga/TNFR-Python-Engine>
4040
**PyPI**: <https://pypi.org/project/tnfr/>
41-
**DOI**: [10.5281/zenodo.17761312](https://doi.org/10.5281/zenodo.17761312)
41+
**DOI**: [10.5281/zenodo.18883409](https://doi.org/10.5281/zenodo.18883409)
4242

4343
### Citation
4444

@@ -50,7 +50,7 @@ If you use this software in your research, please cite:
5050
title = {TNFR-Python-Engine: Resonant Fractal Nature Theory Implementation},
5151
year = {2025},
5252
version = {0.0.3},
53-
doi = {10.5281/zenodo.17761312},
53+
doi = {10.5281/zenodo.18883409},
5454
url = {https://github.com/fermga/TNFR-Python-Engine}
5555
}
5656
```

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# TNFR: Resonant Fractal Nature Theory
22

3-
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18883306.svg)](https://doi.org/10.5281/zenodo.18883306)
3+
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18883409.svg)](https://doi.org/10.5281/zenodo.18883409)
44
[![PyPI version](https://badge.fury.io/py/tnfr.svg)](https://pypi.org/project/tnfr/)
55
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
66
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -162,7 +162,7 @@ make smoke-tests # smoke tests (Unix)
162162
title = {TNFR-Python-Engine: Resonant Fractal Nature Theory Implementation},
163163
year = {2025},
164164
version = {0.0.3},
165-
doi = {10.5281/zenodo.18883306},
165+
doi = {10.5281/zenodo.18883409},
166166
url = {https://github.com/fermga/TNFR-Python-Engine}
167167
}
168168
```

‎pyproject.toml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -199,8 +199,8 @@ tnfr-is-prime = "tnfr.tools.tnfr_is_prime_cli:main"
199199
Homepage = "https://github.com/fermga/TNFR-Python-Engine"
200200
Repository = "https://github.com/fermga/TNFR-Python-Engine"
201201
PyPI = "https://pypi.org/project/tnfr/"
202-
Citation = "https://doi.org/10.5281/zenodo.17761312"
203-
Zenodo = "https://zenodo.org/records/17761312"
202+
Citation = "https://doi.org/10.5281/zenodo.18883409"
203+
Zenodo = "https://zenodo.org/records/18883409"
204204
Issues = "https://github.com/fermga/TNFR-Python-Engine/issues"
205205
Documentation = "https://fermga.github.io/TNFR-Python-Engine/"
206206
GPT = "https://chatgpt.com/g/g-67abc78885a88191b2d67f94fd60dc97-tnfr-resonant-fractal-nature-theory"

‎src/tnfr/factorization/__init__.py‎

Lines changed: 40 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,21 @@
44
spectral factorizations. It wraps :class:`tnfr_factorization.spectral_paley.SpectralPaleyFactorizer`
55
so that downstream code always benefits from the official grammar validator and
66
self-optimization engines wired in the factorization lab.
7+
8+
The ``tnfr_factorization`` external package is an **optional** dependency.
9+
Importing this module always succeeds; errors are deferred until a function
10+
is actually called without the dependency installed.
711
"""
812

913
from __future__ import annotations
1014

1115
from pathlib import Path
16+
from typing import Any
1217

1318
import sys
1419

15-
from ..errors import TNFRUserError
20+
__all__ = ["factorize", "SpectralAnalysisResult", "SpectralPaleyFactorizer"]
21+
1622

1723
def _bootstrap_factorization_lab() -> None:
1824
"""Ensure the tnfr_factorization package is importable.
@@ -29,36 +35,53 @@ def _bootstrap_factorization_lab() -> None:
2935
if lab_root.exists() and str(lab_root) not in sys.path:
3036
sys.path.insert(0, str(lab_root))
3137

32-
_bootstrap_factorization_lab()
3338

34-
try: # pragma: no cover - exercised indirectly through factorize()
35-
from tnfr_factorization.spectral_paley import (
36-
SpectralAnalysisResult,
37-
SpectralPaleyFactorizer,
38-
)
39-
except ModuleNotFoundError as exc: # pragma: no cover - raised when extra missing
40-
raise TNFRUserError(
41-
"tnfr_factorization is not available. Install the tnfr-factorization package "
42-
"or keep the factorization-lab directory in your workspace."
43-
) from exc
39+
def _load_spectral_paley() -> tuple[Any, Any]:
40+
"""Lazy-load the spectral_paley module, raising a clear error if missing."""
41+
from ..errors import TNFRUserError
4442

45-
__all__ = ["factorize", "SpectralAnalysisResult", "SpectralPaleyFactorizer"]
43+
_bootstrap_factorization_lab()
44+
try:
45+
from tnfr_factorization.spectral_paley import (
46+
SpectralAnalysisResult,
47+
SpectralPaleyFactorizer,
48+
)
49+
return SpectralPaleyFactorizer, SpectralAnalysisResult
50+
except ModuleNotFoundError as exc:
51+
raise TNFRUserError(
52+
"tnfr_factorization is not available. Install the tnfr-factorization "
53+
"package or keep the factorization-lab directory in your workspace."
54+
) from exc
4655

47-
_DEFAULT_FACTORIZER: SpectralPaleyFactorizer | None = None
4856

49-
def _get_factorizer() -> SpectralPaleyFactorizer:
57+
# Lazy accessors for type re-exports
58+
def __getattr__(name: str) -> Any:
59+
if name in ("SpectralPaleyFactorizer", "SpectralAnalysisResult"):
60+
_Factorizer, _Result = _load_spectral_paley()
61+
globals()["SpectralPaleyFactorizer"] = _Factorizer
62+
globals()["SpectralAnalysisResult"] = _Result
63+
return globals()[name]
64+
raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
65+
66+
67+
_DEFAULT_FACTORIZER: Any = None
68+
69+
70+
def _get_factorizer() -> Any:
5071
global _DEFAULT_FACTORIZER
5172
if _DEFAULT_FACTORIZER is None:
52-
_DEFAULT_FACTORIZER = SpectralPaleyFactorizer()
73+
_Factorizer, _ = _load_spectral_paley()
74+
_DEFAULT_FACTORIZER = _Factorizer()
5375
return _DEFAULT_FACTORIZER
5476

77+
5578
def factorize(
5679
n: int,
5780
*,
5881
modulus: int | None = None,
5982
trace_certificates: bool = False,
6083
certificate_dir: Path | None = None,
61-
) -> SpectralAnalysisResult:
84+
) -> Any:
6285
"""Run canonical Paley spectral factorization.
6386
6487
Parameters

0 commit comments

Comments
 (0)