Skip to content

Commit f11d421

Browse files
author
TNFR AI Agent
committed
Prepare 0.0.3.4 changelog: June emergent-geometry + centralization cycle
Promotes the [Unreleased] section to [0.0.3.4] dated 2026-06-17 and prepends the June development cycle that the previous [Unreleased] (dated 2026-05-31, Yang-Mills + N15-N17 only) did not cover. New [0.0.3.4] sections (eight themed groups + the prior Y/N milestones nested under "Research Program Milestones"): - Emergent Geometry — Symplectic Substrate (canonical): the symplectic phase space the nodal dynamics generates, with the full structure tower (Noether, Hermitian/Kähler, integrability, Poincaré-Cartan, Marsden-Weinstein, U(2) polarization / Stokes) and non-circular threshold-value derivation. - Emergent Geometry — Structural Diffusion (transport layer): the EPI channel = graph Laplacian, six transport layers, overdamped-projection bridge. - Operator Contracts & Energy — Centralization and Emergence: the single source-of-truth contract layer, public English names, and the measured energy/coherence emergence (E absent from EPI/νf; Lyapunov role = grammar U2). - Grammar — Single Canonical Source & Formal-Language Characterization. - Number Theory & the Dual-Lever. - Millennium Problem Programs: P vs NP (PNP-1), BSD (BSD-1), Hodge (HC-1), each Branch B / B3 with honest scope. - Documentation, Examples & Repository Hygiene. - Research Program Milestones: the existing Y1-Y5 and N15-N17 entries, demoted to #### and nested under a clarifying ### heading (no pseudo-version header that would break changelog/towncrier parsers). All cited modules, theory docs, and examples verified to exist. Documentation only; no source or test change. Release remains tag-driven (setuptools-scm): this entry leaves 0.0.3.4 one `git tag v0.0.3.4` away.
1 parent fe7cb31 commit f11d421

1 file changed

Lines changed: 200 additions & 10 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 200 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,199 @@
22

33
All notable changes to this project will be documented in this file.
44

5-
## [Unreleased] - 2026-05-31
6-
7-
### Y5 — TNFR–Yang–Mills Closure / Obstruction Classification
5+
## [0.0.3.4] - 2026-06-17
6+
7+
This release consolidates the emergent-geometry program, centralizes the
8+
operator/grammar/contract layer onto single canonical sources, opens three new
9+
TNFR-native Millennium-problem programs, and refactors the documentation to the
10+
current engine state. The 13-operator catalog, grammar U1–U6, and the nodal
11+
equation are unchanged; everything below either *measures* structure the nodal
12+
equation already contains or removes duplication. Full suite: 2043 passed, 2
13+
skipped.
14+
15+
### Emergent Geometry — Symplectic Substrate (canonical)
16+
17+
The nodal equation generates its own geometry; the graph is only the data
18+
substrate. The conservation laws of `physics/conservation.py` are consolidated
19+
into an explicit emergent **symplectic phase space** that the engine measures
20+
rather than postulates.
21+
22+
- **New module**: `src/tnfr/physics/symplectic_substrate.py` — phase space
23+
`P = ℝ^{4N}` with conjugate pairs `(K_φ, J_φ)` (geometric) and `(Φ_s, J_ΔNFR)`
24+
(potential); symplectic 2-form `ω` (antisymmetric, non-degenerate, closed);
25+
canonical Poisson brackets; `H_sub = ½Σ(K_φ²+J_φ²+Φ_s²+J_ΔNFR²)` equal to the
26+
energy functional exactly; Liouville `div(X_H)=0` (the 13 operators are
27+
symplectomorphisms).
28+
- **Derived structure tower** (each measured to machine precision):
29+
Noether charges (time-translation → `H_sub`; geometric U(1) → `E_geo = ½Σ|Ψ|²`;
30+
potential U(1) → `E_pot`); the compatible Hermitian / flat-Kähler triple
31+
`(ω, J, g)` with `J = −ω` — so the `i` in `Ψ = K_φ + i·J_φ` *is* the complex
32+
structure the substrate induces; complete integrability (action–angle,
33+
Liouville–Arnold); Poincaré–Cartan integral invariants; Marsden–Weinstein
34+
symplectic reduction; and the hidden **U(2) polarization symmetry** whose
35+
SU(2) part supplies three conserved **Stokes parameters** on the per-node
36+
Poincaré sphere (classical wave polarization — Stokes 1852 / Poincaré 1892 —
37+
not isospin or qubits).
38+
- **Threshold values derived non-circularly**: `physics/variational.py`
39+
`derive_tetrad_threshold_values` recovers φ (inverse-square self-similar fixed
40+
point), γ (harmonic-accumulation gap), e (memoryless-decay series) from each
41+
tetrad field's accumulation law; π remains a geometric primitive.
42+
- **Consolidated entry point**: `verify_substrate_geometry(G)` bundles all
43+
certificates into a `SubstrateGeometryReport`.
44+
- **SDK**: `Network.symplectic_substrate()` + `SymplecticReport`, in
45+
`TNFR.analyze()`.
46+
- **Honest scope**: a flat, constant-coefficient linear Kähler backbone — a
47+
consolidation of geometry already implied by `conservation.py` +
48+
`variational.py`; it does not resolve any open program.
49+
- **Demonstrations**: `examples/08_emergent_geometry/98`, `106`, `114`.
50+
51+
### Emergent Geometry — Structural Diffusion (transport layer)
52+
53+
The EPI channel of the canonical ΔNFR is the random-walk graph Laplacian
54+
`−L_rw·EPI` (verified to residual ~1e-16), so the nodal equation is literally a
55+
discrete diffusion equation with diffusivity `νf`. From this single identity the
56+
engine measures, in TNFR's own variables, a tower of empirically-established
57+
transport phenomena.
58+
59+
- **New module**: `src/tnfr/physics/structural_diffusion.py` — six transport
60+
layers: diffusion/synchronization (Fourier/Fick/Kuramoto), overdamped drift
61+
(`q̇ = νf·F`, Stokes/Einstein mobility — corrects the prior "Newton's second
62+
law" reading: the bare first-order nodal equation is overdamped, νf is mobility
63+
not inverse mass), discrete standing-wave modes (bounded-manifold Laplacian
64+
eigenmodes), structural-stability dispersion relation (`σ_k = r − νf·λ_k`, the
65+
spectral form of U2), random walk + effective resistance (Ohm/Kirchhoff), and
66+
structural flow (current, Kirchhoff continuity, Ohm).
67+
- **Overdamped-projection bridge**: the nodal equation is the strong-damping
68+
limit of the substrate wave `q̈ + γq̇ + Lq = 0` with `νf = 1/γ`; the γ-dial
69+
spans diffusion (γ→∞) to standing waves (γ→0).
70+
- **Honest scope**: the EPI-channel ↔ Laplacian identity is exact; the full ΔNFR
71+
is multi-channel; `λ_2` is purely topological and does not encode any canonical
72+
constant (measured negative result).
73+
- **Demonstrations**: `examples/08_emergent_geometry/99`, `113`, `134`, `135`.
74+
75+
### Operator Contracts & Energy — Centralization and Emergence
76+
77+
- **Canonical contract layer**: new `src/tnfr/operators/operator_contracts.py` —
78+
the single source of truth for what each operator does to node state, anchored
79+
to the direct `_op_*` effect (TNFR.pdf §2.2.1). Each `OperatorContract` records
80+
the public English name, the `primary_channel` (one nodal-equation channel:
81+
EPI / νf / θ / ΔNFR), the `scale` (NODE for twelve operators, NETWORK for the
82+
U5 operator REMESH), and a verifiable postcondition. The proactive audit
83+
(`audit_operator_contracts`), the reactive integrity monitor (`POSTCONDITIONS`),
84+
and the introspection metadata now all derive from this spec — eliminating the
85+
historical drift where scattered copies disagreed (e.g. AL claiming "positive
86+
ΔNFR" though `_op_AL` only raises EPI; RA checked for EPI increase though it
87+
preserves identity; VAL/NUL checked |EPI| though they scale νf).
88+
- **Public English names**: the structural-operator name (Emission, Reception, …)
89+
is canonical at the public level; the glyph code (AL, EN, …) is the internal
90+
symbol.
91+
- **Energy/coherence are emergent**: the structural energy
92+
`E = ½Σ(Φ_s²+|∇φ|²+K_φ²+J_φ²+J_ΔNFR²)` contains no EPI or νf term (measured:
93+
scaling EPI or νf leaves E unchanged). The per-operator Lyapunov role in
94+
`physics/lyapunov.py` is therefore re-derived from the canonical grammar U2 role
95+
(`config.physics_derivation`), not from a hardcoded energy algebra:
96+
stabilisers {IL, THOL}, destabilisers {OZ, ZHIR, VAL}, the rest neutral. The
97+
form-channel operators (AL, EN, RA, REMESH) are energy-neutral because EPI is
98+
absent from E.
99+
- **Dual-lever clarified**: the two levers are the two right-hand-side factors of
100+
the nodal equation — νf (capacity) and ΔNFR (pressure); operators that write
101+
the form EPI (the LHS) sit on neither lever.
102+
- **Demonstrations**: `examples/08_emergent_geometry/152`,
103+
`examples/02_physics_regimes/115`.
104+
105+
### Grammar — Single Canonical Source & Formal-Language Characterization
106+
107+
- **Centralization**: the operator-classification sets (generators, closures,
108+
stabilizers, destabilizers, transformers, bifurcation triggers/handlers) are
109+
derived once in `config.physics_derivation` and re-exported by
110+
`operators/grammar_types.py`. Every grammar consumer — the U1–U6 validator,
111+
the secondary sequence validator, grammar_dynamics, the runtime preconditions,
112+
the error factory, and the operator metadata — now reads the single source.
113+
Parallel hardcoded copies (including a secondary validator that wrongly listed
114+
NUL as a U2 destabilizer) were removed and pinned by
115+
`tests/operators/test_grammar_canonical_consistency.py`.
116+
- **Canonical grammar spec**: new `operators/grammar_canon.py` materializes the
117+
U1–U6 role table, the five-type structural typology, and the canonical glyphic
118+
macros (anchored to TNFR.pdf §2.3), with a self-consistency check.
119+
- **Formal-language thread** (characterization, demos only): the grammar is a
120+
regular language with a 29-state minimal DFA and exact Perron–Frobenius
121+
capacity; the asymptotic constraint lives entirely in the bifurcation rule
122+
(U4b); the syntactic monoid is aperiodic so the language is star-free /
123+
first-order definable; nesting `THOL[...]` lifts the glyphic sub-language to
124+
context-free (Dyck/Catalan); the emergent operator distribution is the
125+
Shannon–Parry maximum-entropy equilibrium.
126+
- **Demonstrations**: `examples/08_emergent_geometry/139`–`152`.
127+
128+
### Number Theory & the Dual-Lever
129+
130+
- Prime families as orbits on the zero-pressure set `{ΔNFR = 0}`; numbers as a
131+
coupled network (Ω-graded centrality, primes as the transport periphery); the
132+
nodal flow on numbers (primes as equilibria, not attractors); primality as
133+
grammatical inertness; numbers as free-monoid words with the dual-lever as the
134+
two additive gradings (count Ω → ΔNFR pressure, size log → νf capacity); the
135+
capacity arm carries von Mangoldt and the prime-ladder Hamiltonian P14 is the
136+
capacity-arm operator — locating the Riemann oscillatory obstruction on the
137+
capacity axis the per-node substrate is blind to.
138+
- **Honest scope**: these restate classical multiplicative number theory through
139+
the grammar/dual-lever lens; they close no open problem.
140+
- **Demonstrations**: `examples/07_number_theory/94`–`97`, `100`–`102`,
141+
`116`, `146`–`149`.
142+
143+
### Millennium Problem Programs (TNFR-native reformulations)
144+
145+
Three new programs join Riemann / Navier–Stokes / Yang–Mills. **None claims a
146+
solution** — each carries an explicit honest-scope statement and classified
147+
obstruction.
148+
149+
- **P vs NP (PNP-1)** — the nodal equation is a gradient flow, so verifying a
150+
configuration's coherence is `O(|E|)` but synthesizing a globally coherent one
151+
by relaxation traps in dissonance basins (measured global-optimum hit rate
152+
drops monotonically with problem size on frustrated MAX-CUT). Mirrors P≠NP;
153+
Branch B open. `theory/TNFR_P_VS_NP_RESEARCH_NOTES.md`,
154+
`examples/09_millennium/109`.
155+
- **Birch–Swinnerton-Dyer (BSD-1)** — `a_p = p+1−#E(F_p)` as structural pressure;
156+
the accumulated product reproduces the original 1965 empirical rank separation
157+
by brute-force point counting. GL(1)→GL(2) gap open; Branch B.
158+
`theory/TNFR_BSD_RESEARCH_NOTES.md`, `examples/09_millennium/110`.
159+
- **Hodge (HC-1)** — the tetrad cochain tower carries a complete discrete Hodge
160+
decomposition (harmonic = homology exactly, Eckmann 1944), but is structurally
161+
blind to the (p,p) bigrading and algebraicity the conjecture requires (a strong
162+
negative, Branch B3-leaning). `theory/TNFR_HODGE_RESEARCH_NOTES.md`,
163+
`examples/09_millennium/111`.
164+
165+
### Documentation, Examples & Repository Hygiene
166+
167+
- **README + core theory docs** refactored to the current engine state: corrected
168+
a real API note (operators are callable, there is no `.apply()`), added the
169+
emergent-geometry section to `theory/FUNDAMENTAL_THEORY.md`, rewrote the energy
170+
classification in `theory/STRUCTURAL_OPERATORS.md` /
171+
`theory/STRUCTURAL_STABILITY_AND_DYNAMICS.md` to the emergent/grammar-U2 frame,
172+
and updated counts.
173+
- **Examples reorganized** into 10 thematic subfolders (`01_foundations` …
174+
`10_applications`), resolving the prior 77–86 numbering collision; each file
175+
keeps a stable global number. Foundational examples refactored to the canonical
176+
Kuramoto phase-synchrony physics.
177+
- **Documentation-integrity pass**: repaired all dangling example/source/`.md`
178+
links repo-wide, pruned 9 obsolete `docs/` files, rebuilt the `theory/` hub,
179+
and resynced the derived `.github/agents/my-agent.md` mirror.
180+
- **Deep repo cleanup**: removed foreign GraphQL scratch JSONs, a CUDA debug
181+
script, a backup test, an empty dead CLI module, and a stale task tracker; fixed
182+
a dangling `tnfr-validate` console-script entry point in `pyproject.toml`.
183+
- **Registry consolidation + lint**: the SDK fluent glyph→operator map and the
184+
lyapunov operator table now derive from the canonical registries; cleared a
185+
small set of dead-code lint findings.
186+
- **SDK fixes**: repaired silent no-ops in `auto_optimize` and
187+
`evolve_grammar_aware`; added a proactive measured operator-contract fidelity
188+
audit (`net.audit_operators()`).
189+
190+
### Research Program Milestones (Yang–Mills Y1–Y5, REMESH-∞ N15, Navier–Stokes N16–N17)
191+
192+
The Yang–Mills (Y1–Y5) and REMESH-∞ / Navier–Stokes (N15–N17) program
193+
milestones below were developed earlier in the cycle and are part of this
194+
release. Each carries an explicit honest-scope statement; none resolves a Clay
195+
Millennium Problem.
196+
197+
#### Y5 — TNFR–Yang–Mills Closure / Obstruction Classification
8198

9199
- **Verdict**: `BRANCH_B_OBSTRUCTION_CLASSIFIED` — Y1–Y4 establish a finite TNFR `U(1)` structural gauge diagnostic surface, but Clay-strength closure requires a new canonical non-Abelian derivation plus a continuum / thermodynamic lower-bound theorem.
10200
- **New API**: `classify_yang_mills_closure()` in `src/tnfr/yang_mills/closure.py`, exported from `tnfr.yang_mills` with `YangMillsClosureReport`.
@@ -14,7 +204,7 @@ All notable changes to this project will be documented in this file.
14204
- **Validation**: 4 new tests in `tests/physics/test_yang_mills_closure.py` cover Branch-B classification, report reuse, sampled collapse handling, and package-root import. Y1–Y5 focused run: `33 passed`.
15205
- **Next target**: Y6 / Branch-B derivation search for a TNFR-native non-Abelian connection and non-commuting generator algebra. If no derivation exists without external group labels, the programme should pause at Branch B.
16206

17-
### Y4 — TNFR–Yang–Mills Finite Scaling Diagnostic
207+
#### Y4 — TNFR–Yang–Mills Finite Scaling Diagnostic
18208

19209
- **Verdict surface**: `FINITE_SCALING_EVIDENCE` or `GAP_COLLAPSE_OBSERVED` depending on sampled finite graph families. This is a finite diagnostic only, not a continuum theorem.
20210
- **New API**: `run_finite_scaling_study()` in `src/tnfr/yang_mills/scaling.py`, exported from `tnfr.yang_mills` with `FiniteScalingPoint` and `FiniteScalingReport`.
@@ -23,7 +213,7 @@ All notable changes to this project will be documented in this file.
23213
- **Validation**: 6 new tests in `tests/physics/test_yang_mills_scaling.py` cover report shape/scope, grouped finite scaling, reproducibility, sampled collapse classification, invalid input rejection, and package-root import. Y1–Y4 focused run: `29 passed`.
24214
- **Next target**: Y5 closure / obstruction classification, likely Branch B unless a later TNFR-native non-Abelian connection and generator algebra are derived.
25215

26-
### Y3 — TNFR–Yang–Mills Non-Abelian Derivability Audit
216+
#### Y3 — TNFR–Yang–Mills Non-Abelian Derivability Audit
27217

28218
- **Verdict**: `OPEN_DERIVABILITY_GAP` — audited candidate routes for deriving a non-Abelian / multi-channel gauge sector from TNFR-internal data only; no route is promoted to canonical status.
29219
- **New API**: `audit_nonabelian_derivability()` in `src/tnfr/yang_mills/derivability.py`, exported from `tnfr.yang_mills` with `NonAbelianCandidateAudit` and `NonAbelianDerivabilityReport`.
@@ -32,7 +222,7 @@ All notable changes to this project will be documented in this file.
32222
- **Validation**: 5 new tests in `tests/physics/test_yang_mills_derivability.py` cover baseline `U(1)` confirmation, nested-EPI obstruction, cycle-bundle rejection, unsupported route errors, and package-root import. Y1+Y2+Y3 focused run: `23 passed`.
33223
- **Open boundary**: YMG-4 remains open. Y4 scaling can proceed only as a conditional finite diagnostic; it cannot become a Clay-strength claim while non-Abelian derivability is unresolved.
34224

35-
### Y2 — TNFR–Yang–Mills U6 Confinement Sweep
225+
#### Y2 — TNFR–Yang–Mills U6 Confinement Sweep
36226

37227
- **Verdict**: `EMPIRICAL_FINITE_GRAPH_ONLY` — finite sweep surface created for testing how the Y1 structural gauge gap behaves across U6-confined and U6-unconfined regimes.
38228
- **New API**: `run_u6_confinement_sweep()` in `src/tnfr/yang_mills/u6_sweep.py`, exported from `tnfr.yang_mills`.
@@ -41,7 +231,7 @@ All notable changes to this project will be documented in this file.
41231
- **Validation**: 5 new tests in `tests/physics/test_yang_mills_u6_sweep.py` cover report shape/scope, U6 target tracking, gap contracts, reproducibility, invalid input rejection, and package-root import. Y1+Y2 focused run: `18 passed`.
42232
- **Open boundary**: Y2 does not prove a U6 lower-bound theorem and does not address non-Abelian derivability (YMG-4) or continuum scaling (YMG-5). Next target: Y3 derivability audit.
43233

44-
### Y1 — TNFR–Yang–Mills Finite Structural Gauge Gap Diagnostic
234+
#### Y1 — TNFR–Yang–Mills Finite Structural Gauge Gap Diagnostic
45235

46236
- **Verdict**: `DIAGNOSTIC_SURFACE_CREATED` — first TNFR-native Yang–Mills / structural mass-gap attack surface implemented as a finite-graph diagnostic, not a Clay-strength proof.
47237
- **New package**: `src/tnfr/yang_mills/` with `build_structural_gauge_graph()`, `build_structural_gauge_gap_operator()`, and `compute_structural_gauge_gap()`.
@@ -51,7 +241,7 @@ All notable changes to this project will be documented in this file.
51241
- **Open boundaries**: non-Abelian derivability (YMG-4) and continuum / thermodynamic scaling (YMG-5) remain open.
52242
- **Documentation**: `theory/TNFR_YANG_MILLS_RESEARCH_NOTES.md` records the Y-series gap ledger and updates the next target to Y2 (U6 confinement sweep).
53243

54-
### N17-A — U3+U5 → K41: Analytical Cascade Locality (ANALYTICAL_CONSISTENT_CONDITIONAL)
244+
#### N17-A — U3+U5 → K41: Analytical Cascade Locality (ANALYTICAL_CONSISTENT_CONDITIONAL)
55245

56246
- **Verdict**: `ANALYTICAL_CONSISTENT_CONDITIONAL` — K41 $k^{-5/3}$ spectrum derived conditionally from TNFR grammar rules U2+U3+U5+CDC; algebraically closed given the Cascade Development Condition.
57247
- **Lemma U5-SS** (U5 + U2 → scale self-similarity): U5-uniformity (same canonical operators and constants at every hierarchy level) + U2 force $u_\ell = C(\varepsilon r_\ell)^{1/3}$ in the inertial range. The K41 scaling emerges from grammar structure (U5 collapses the dimensionless ratio to a level-independent constant), not from external dimensional analysis.
@@ -62,7 +252,7 @@ All notable changes to this project will be documented in this file.
62252
- **N17-B pre-registered** (deferred): empirical energy spectrum via `energy_spectrum_3d()` (to be implemented in `src/tnfr/navier_stokes/operator.py`), n ∈ {32, 48}, ν ∈ {0.01, 0.005}, T = 2.0. Expected verdict: `STEEPER_THAN_K41` (CDC not satisfied at Re_eff ≤ 500).
63253
- **Documentation**: `theory/TNFR_NAVIER_STOKES_RESEARCH_NOTES.md` §20 (full lemmas, theorem, CDC gap analysis, verdict table, N17-B pre-registration spec).
64254

65-
### N16 — NS-G5 Closure: 2D-Embedding Lemma
255+
#### N16 — NS-G5 Closure: 2D-Embedding Lemma
66256

67257
- **Verdict**: NS-G5 **CLOSED** at the discrete-operator level via the **2D-Embedding Lemma (Theorem NS-G5-TNFR)**.
68258
- **Algebraic proof** (three steps using existing `TNFRNavierStokesOperator` methods on z-independent u = (u₀(x,y), u₁(x,y), 0)):
@@ -75,7 +265,7 @@ All notable changes to this project will be documented in this file.
75265
- **Scope**: NS-G5 closure does NOT affect NS-G1..G4 and does NOT address the Clay Millennium Problem (3D global regularity).
76266
- **Documentation**: `theory/TNFR_NAVIER_STOKES_RESEARCH_NOTES.md` §19.
77267

78-
### N15 REMESH-∞ Closure — Catalog-Completeness Theorem
268+
#### N15 REMESH-∞ Closure — Catalog-Completeness Theorem
79269

80270
- **Master deliverable**: [theory/REMESH_INFINITY_DERIVATION.md](theory/REMESH_INFINITY_DERIVATION.md) §§1–23 (v3.0, ~816 lines). Three weeks (W1 + W2 + W3) executed in a single session and pushed to `origin/main`:
81271
- W1 `a1f298fd` — operator existence: $\mathcal{R}_\infty = P_{\ker(I-\mathcal{R})}$, bounded self-adjoint orthogonal projection on $H^2(D)$

0 commit comments

Comments
 (0)