Skip to content

Commit ce5d40f

Browse files
author
TNFR AI Agent
committed
feat: consolidate nodal research and audited execution plan
Intent: preserve nodal research results and establish one testable research queue. Operators involved: Coherence, Coupling, Silence and shared network execution. Affected invariants: nodal evolution, phase semantics, capacity and reproducibility. Key changes: - Integrate shared binary64 phase/EPI kernels, nodal remainder accounting, capacity feedback and scoped C6 carried-state analysis with regression tests. - Preserve the C6 checkpoint: 41 of 56 first-exit regions excluded, 15 open. This does not claim global stability or physical validation. - Consolidate research ownership, archive the old roadmap byte for byte, and document the audited five-stage measurement and prediction protocol. - Identify existing owners, evaluation leakage, admission gaps and model boundaries before empirical implementation; next task remains P1.1. Validation: 392 integration tests passed; documentation and staged whitespace checks passed. Reused 451 prior targeted tests at matching source hashes; these counts are not an additive coverage claim. Archived roadmap SHA-256 matches its original bytes. Existing local proof artifacts remain local. Expected risks: finite and restricted results retain their declared scope; P1 implementation and broader stability/physical correspondence remain open.
1 parent c3ee03d commit ce5d40f

209 files changed

Lines changed: 67905 additions & 1346 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.

‎.gitattributes‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Preserve the archived roadmap's original mixed line endings and byte digest.
2+
theory/research/archive/ROADMAP_PRE_FIVE_STAGE_2026-09-17.txt -text whitespace=blank-at-eol,blank-at-eof,space-before-tab,cr-at-eol

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

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -289,6 +289,15 @@ global projected autonomy. Branch crossing, changing support and finite-time
289289
phase closure remain open. See
290290
[src/tnfr/physics/phase_quotient.py](https://github.com/fermga/TNFR-Python-Engine/blob/main/src/tnfr/physics/phase_quotient.py).
291291

292+
For two neighbors whose oriented displacements are certified inside the
293+
center's open half-π interval, the phasor direction is their exact midpoint.
294+
IL and CPU pressure paths share a rational-π kernel that separately certifies
295+
rounding of this displacement and the displayed mean; unresolved cases retain
296+
the phasor path. Pressure still divides the rounded displacement by represented
297+
π. Existing phase normalization/writes, other channels and Euler rounding remain
298+
separate, so this local accuracy result does not prove runtime mean conservation.
299+
See [src/tnfr/mathematics/_phase_midpoint.py](https://github.com/fermga/TNFR-Python-Engine/blob/main/src/tnfr/mathematics/_phase_midpoint.py).
300+
292301
---
293302

294303
## 3. The structural tetrad
@@ -463,7 +472,7 @@ transformation remains open under research line S10.
463472
| 4 | **Dissonance** (OZ) | Controlled instability; raises \|ΔNFR\| | Destabilizer (U2), bifurcation trigger (U4a), closure (U1b) | Must increase \|ΔNFR\| |
464473
| 5 | **Coupling** (UM) | Phase synchronization link `φᵢ → φⱼ` | Requires phase check (U3) | Valid only if `\|wrap(φᵢ − φⱼ)\| ≤ Δφ_max` |
465474
| 6 | **Resonance** (RA) | Coherent amplification / propagation | Requires phase check (U3) | Blends scalar EPI over U3-compatible neighbours while preserving sign/kind identity |
466-
| 7 | **Silence** (SHA) | Freezes evolution; `νf → 0`, EPI fixed | Closure (U1b) | Preserves EPI over time |
475+
| 7 | **Silence** (SHA) | Reduces νf; leaves EPI unchanged at the event | Closure (U1b) | Preserves EPI during SHA; zero subsequent nodal change requires `νf·ΔNFR = 0` |
467476
| 8 | **Expansion** (VAL) | Adds structural complexity; raises νf | Destabilizer (U2) | νf not decreased (capacity lever) |
468477
| 9 | **Contraction** (NUL) | Removes complexity; νf↓ and ΔNFR densifies | — | νf not increased (acts on both levers) |
469478
| 10 | **Self-organization** (THOL) | Autopoietic sub-EPI formation | Stabilizer (U2), handler (U4a), transformer (U4b) | Preserves global form while creating sub-EPIs |
@@ -585,6 +594,26 @@ invocation, preventing an integrator from installing and running a replacement.
585594
violation or later failure rolls back the graph transaction. Physical and stage
586595
callback counts are recorded separately and must sum to the total.
587596

597+
The separate opt-in `execute_nodal_remainder_event_schedule` retains numerical
598+
EPI as `X=Fraction(x)+r`, with visible `x=RN(X)`. Its shared carried kernel
599+
uses exact represented nodal areas `h*nu_f*DeltaNFR`; the visible prefix
600+
residual is `r_initial-r_final`. A graph-owned binding persists across calls
601+
and rejects stale chart, clock or support without resetting the remainder.
602+
Canonical pressure and timestamped histories read visible EPI. Each declared
603+
positive segment refreshes pressure and advances through the shared kernel;
604+
configured stage callbacks and terminal refreshes keep their separate roles.
605+
Only admitted EPI-preserving Coupling, Coherence and Silence events are
606+
supported, with actual chart/support checks and whole-invocation rollback.
607+
Both exact and visible EPI must remain inside the declared positive band
608+
and configured bounds. EPI-writing events, explicit REMESH, clipping,
609+
custom callbacks and broader solver configurations remain outside this path.
610+
The exact EPI readout shift is `w_epi*L_rw*r`; its nodal arithmetic mean
611+
vanishes on regular support with common capacity. Other channels and their
612+
realization retain a separate source budget. This finite sealed execution
613+
does not prove generated-pressure summability, solver convergence or future
614+
domain preservation. See
615+
[the carried flow/event contract](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/COUPLING_WINDING_PERSISTENCE.md#21-live-pressure-and-an-explicit-carried-flowevent-contract).
616+
588617
For a fixed pure-EPI generator `A=diag(nu_f)L_rw`, the exact-real held-pressure
589618
Euler model has `g_H(mu)=1-T*mu` regardless of internal substeps whose exact
590619
represented durations sum to `T`; explicit pressure refresh gives the exact-real
@@ -1229,7 +1258,7 @@ evidence (phase/νf logs, C(t)/Si curves, controlled bifurcations), compatibilit
12291258

12301259
Cover, at minimum: coherence **monotonicity** (IL does not reduce C(t) outside dissonance
12311260
tests), **bifurcation** (OZ triggers with handlers present), **propagation** (RA raises
1232-
phase sync), **latency** (SHA keeps EPI invariant), **mutation threshold** (ZHIR changes θ
1261+
phase sync), **latency** (SHA preserves EPI at the event boundary and attenuates νf), **mutation threshold** (ZHIR changes θ
12331262
only when `ΔEPI/Δt > ξ`), **multi-scale** (nested EPIs keep identity), and
12341263
**reproducibility** (same seed → same trajectory). See [TESTING.md](https://github.com/fermga/TNFR-Python-Engine/blob/main/TESTING.md).
12351264

‎AGENTS.md‎

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -289,6 +289,15 @@ global projected autonomy. Branch crossing, changing support and finite-time
289289
phase closure remain open. See
290290
[src/tnfr/physics/phase_quotient.py](https://github.com/fermga/TNFR-Python-Engine/blob/main/src/tnfr/physics/phase_quotient.py).
291291

292+
For two neighbors whose oriented displacements are certified inside the
293+
center's open half-π interval, the phasor direction is their exact midpoint.
294+
IL and CPU pressure paths share a rational-π kernel that separately certifies
295+
rounding of this displacement and the displayed mean; unresolved cases retain
296+
the phasor path. Pressure still divides the rounded displacement by represented
297+
π. Existing phase normalization/writes, other channels and Euler rounding remain
298+
separate, so this local accuracy result does not prove runtime mean conservation.
299+
See [src/tnfr/mathematics/_phase_midpoint.py](https://github.com/fermga/TNFR-Python-Engine/blob/main/src/tnfr/mathematics/_phase_midpoint.py).
300+
292301
---
293302

294303
## 3. The structural tetrad
@@ -463,7 +472,7 @@ transformation remains open under research line S10.
463472
| 4 | **Dissonance** (OZ) | Controlled instability; raises \|ΔNFR\| | Destabilizer (U2), bifurcation trigger (U4a), closure (U1b) | Must increase \|ΔNFR\| |
464473
| 5 | **Coupling** (UM) | Phase synchronization link `φᵢ → φⱼ` | Requires phase check (U3) | Valid only if `\|wrap(φᵢ − φⱼ)\| ≤ Δφ_max` |
465474
| 6 | **Resonance** (RA) | Coherent amplification / propagation | Requires phase check (U3) | Blends scalar EPI over U3-compatible neighbours while preserving sign/kind identity |
466-
| 7 | **Silence** (SHA) | Freezes evolution; `νf → 0`, EPI fixed | Closure (U1b) | Preserves EPI over time |
475+
| 7 | **Silence** (SHA) | Reduces νf; leaves EPI unchanged at the event | Closure (U1b) | Preserves EPI during SHA; zero subsequent nodal change requires `νf·ΔNFR = 0` |
467476
| 8 | **Expansion** (VAL) | Adds structural complexity; raises νf | Destabilizer (U2) | νf not decreased (capacity lever) |
468477
| 9 | **Contraction** (NUL) | Removes complexity; νf↓ and ΔNFR densifies | — | νf not increased (acts on both levers) |
469478
| 10 | **Self-organization** (THOL) | Autopoietic sub-EPI formation | Stabilizer (U2), handler (U4a), transformer (U4b) | Preserves global form while creating sub-EPIs |
@@ -585,6 +594,26 @@ invocation, preventing an integrator from installing and running a replacement.
585594
violation or later failure rolls back the graph transaction. Physical and stage
586595
callback counts are recorded separately and must sum to the total.
587596

597+
The separate opt-in `execute_nodal_remainder_event_schedule` retains numerical
598+
EPI as `X=Fraction(x)+r`, with visible `x=RN(X)`. Its shared carried kernel
599+
uses exact represented nodal areas `h*nu_f*DeltaNFR`; the visible prefix
600+
residual is `r_initial-r_final`. A graph-owned binding persists across calls
601+
and rejects stale chart, clock or support without resetting the remainder.
602+
Canonical pressure and timestamped histories read visible EPI. Each declared
603+
positive segment refreshes pressure and advances through the shared kernel;
604+
configured stage callbacks and terminal refreshes keep their separate roles.
605+
Only admitted EPI-preserving Coupling, Coherence and Silence events are
606+
supported, with actual chart/support checks and whole-invocation rollback.
607+
Both exact and visible EPI must remain inside the declared positive band
608+
and configured bounds. EPI-writing events, explicit REMESH, clipping,
609+
custom callbacks and broader solver configurations remain outside this path.
610+
The exact EPI readout shift is `w_epi*L_rw*r`; its nodal arithmetic mean
611+
vanishes on regular support with common capacity. Other channels and their
612+
realization retain a separate source budget. This finite sealed execution
613+
does not prove generated-pressure summability, solver convergence or future
614+
domain preservation. See
615+
[the carried flow/event contract](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/COUPLING_WINDING_PERSISTENCE.md#21-live-pressure-and-an-explicit-carried-flowevent-contract).
616+
588617
For a fixed pure-EPI generator `A=diag(nu_f)L_rw`, the exact-real held-pressure
589618
Euler model has `g_H(mu)=1-T*mu` regardless of internal substeps whose exact
590619
represented durations sum to `T`; explicit pressure refresh gives the exact-real
@@ -1229,7 +1258,7 @@ evidence (phase/νf logs, C(t)/Si curves, controlled bifurcations), compatibilit
12291258

12301259
Cover, at minimum: coherence **monotonicity** (IL does not reduce C(t) outside dissonance
12311260
tests), **bifurcation** (OZ triggers with handlers present), **propagation** (RA raises
1232-
phase sync), **latency** (SHA keeps EPI invariant), **mutation threshold** (ZHIR changes θ
1261+
phase sync), **latency** (SHA preserves EPI at the event boundary and attenuates νf), **mutation threshold** (ZHIR changes θ
12331262
only when `ΔEPI/Δt > ξ`), **multi-scale** (nested EPIs keep identity), and
12341263
**reproducibility** (same seed → same trajectory). See [TESTING.md](https://github.com/fermga/TNFR-Python-Engine/blob/main/TESTING.md).
12351264

0 commit comments

Comments
 (0)