Skip to content

Commit df2af8a

Browse files
author
TNFR AI Agent
committed
Merge relational coefficient and research consolidation
2 parents 01ac557 + 8537e1f commit df2af8a

84 files changed

Lines changed: 44443 additions & 319 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.

‎ARCHITECTURE.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,8 @@ graph invalidation and persistence retain their separate responsibilities.
5353
| Regional orientation relative to a supplied rate source | [`source_relative_form.py`](src/tnfr/physics/source_relative_form.py); reuses the regional form observer |
5454
| Conditional relational phase/form execution | [`dynamics/relational.py`](src/tnfr/dynamics/relational.py); one admitted field and atomic Euler step, reused by the SDK |
5555
| Prepared relational pattern observations | [`physics/relational_observations.py`](src/tnfr/physics/relational_observations.py); supplied regions/reference lifts, shared winding and regional support accounting |
56+
| Conditional coefficient uncertainty | [`physics/relational_observations.py`](src/tnfr/physics/relational_observations.py); exact three-sample stencils delegate to shared outward jet bounds, with declared preparation/clock/error premises |
57+
| Retained P2 acquisition audit | [`research/relational_acquisition.py`](src/tnfr/research/relational_acquisition.py); read-only protocol/archive and all-step error reconstruction; does not import the producer or evolve a graph |
5658
| Protected relational basins | [`physics/relational_capture.py`](src/tnfr/physics/relational_capture.py); reflected, full-state local and acute-sector theorems sharing exact phase/energy enclosures for conditional ideal-law limits |
5759
| Validated relational transit | [`physics/relational_transit.py`](src/tnfr/physics/relational_transit.py); exact reflected ODE enclosure using shared rational intervals, Taylor derivatives and signed-diagonal comparison; read-only proof computation, not live engine evolution |
5860
| Coherence and equilibrium kernel | [`common.py`](src/tnfr/metrics/common.py) |
@@ -220,6 +222,25 @@ thin adapter; the SDK's `relational_report_to_dict` supplies the exact rational
220222
JSON projection for the existing writer. Reports are observations, not live
221223
checkpoints or authenticated execution histories.
222224

225+
The same observation owner exposes graph-independent coefficient-jet and
226+
three-sample bounds. Exact rational stencil/error propagation delegates to the
227+
shared outward interval kernel and mathematical-pi enclosure, rather than a
228+
second coefficient estimator. These are module-level APIs, not `Network`
229+
methods: the caller supplies preparation, affine timing, baseline/gain and
230+
independent uncertainty. The existing exact report exporter supports both
231+
immutable report types. [Usage](docs/guides/REGIONAL_AND_RELATIONAL.md#bound-a-prepared-coefficient-response)
232+
and [admission](docs/contracts/RELATIONAL_DYNAMICS.md#relational-coefficient-samples)
233+
keep those external premises separate from arithmetic availability.
234+
235+
`research/relational_acquisition.py` reconstructs the retained known-source P2
236+
record without invoking `dynamics/relational.py` or importing a benchmark.
237+
It independently checks the declared model/window, reads saved states and
238+
rates, verifies protocol/source-archive bytes and recomputes error budgets
239+
through the shared observation and interval owners. Internal consistency,
240+
the original precision verdict and missing evidence have separate outputs.
241+
It neither authenticates execution nor requires current source to match a
242+
historical archive; the frozen producer and original records remain unchanged.
243+
223244
The same observer's `Network.relational_attachment` route compares two
224245
separately admitted components with their hypothetical joined field. Port
225246
messages, exact represented rate changes and shared support-reset accounting

‎README.md‎

Lines changed: 43 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -139,6 +139,14 @@ The results connect several parts of this picture:
139139
proved recovery region. The result also admits sufficiently small changes
140140
to the preparation. It concerns one supplied change followed by the declared
141141
dynamics, not an automatically chosen sequence of changes.
142+
7. **A response can identify a coefficient without selecting a law.** For the
143+
stated relational family, a prepared form mode and initial phase consensus
144+
let value, rate and acceleration identify one coefficient combination.
145+
Shared tools propagate uncertainty and abstain when it is unresolved. A
146+
known-source two-node computational acquisition now has a whole-window
147+
nonlinear and numerical error budget, rather than relying on a small solver
148+
residual. It verifies the estimation procedure inside that model; different
149+
nonlinear laws can still share the same initial response.
142150

143151
Negative controls are useful parts of these results. For example, two
144152
preparations with the same model-defined initial energy can reach different
@@ -154,25 +162,38 @@ complete set of rules, check that the rules work together, and predict something
154162
not used to choose those rules. Reusable results are integrated into shared tools
155163
and the engine where their scope supports it, with explicit conditions for use.
156164

157-
**The immediate question is what can select a change of connections and its
158-
timing.** We now have a conditional example in which the change respects both
159-
the storage budget and subsequent pattern recovery. The next study examines
160-
which choices the full nodal state, symmetries and clock actually constrain,
161-
and which would require an additional rule. It will not infer that a permitted
162-
event must happen or use node labels to break an unexplained tie.
163-
164-
The budget alone does not select an event. Keeping a loop at the instant of
165-
a change also does not, by itself, guarantee later recovery. The research
166-
separates these obligations so that an assumed event schedule cannot be
167-
mistaken for a mechanism generated by the model.
168-
169-
This step matters to the larger objective: explaining how coherent structures
170-
can compose and interact through their own dynamics, with fewer unexplained
171-
choices supplied from outside. The
172-
[execution plan](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/research/FIVE_STAGE_EXECUTION_PLAN.md#current-g3-gate)
173-
owns that next task; the
165+
**The current bounded question is how to distinguish constitutive laws after
166+
estimating a coefficient.** Two laws can obey the same storage balance and
167+
produce the same initial response around phase consensus, yet respond
168+
differently away from it. Calibration determines a setting; a separate,
169+
uncertainty-aware prediction must test which candidate response is compatible.
170+
Estimating the setting is not evidence that the law is true.
171+
172+
The [coefficient study](theory/nodal/RELATIONAL_EXCHANGE_ADMISSION.md#coefficient-synergy-audit)
173+
connects coefficient freedom, hidden-phase memory and observable response.
174+
Its [prepared identification and bounded acquisition](theory/nodal/RELATIONAL_EXCHANGE_ADMISSION.md#prepared-coefficient-identification)
175+
provide shared engine observations and a verified known-source software control.
176+
The next specification must carry an admitted calibration interval into both
177+
named candidates without refitting, and establish a discriminating prediction
178+
or a precise obstruction before another trajectory. This remains an internal
179+
model-admission question, not a new physical-data campaign.
180+
181+
The [effective-link and collective-memory results](theory/nodal/RELATIONAL_PATTERN_COMPOSITION.md#effective-link-admission)
182+
remain reusable: supplied nodal environments can transmit deformation and
183+
restore joint geometry, and reductions must retain their hidden information.
184+
The [connection-foundation results](theory/nodal/RELATION_FOUNDATIONS.md)
185+
separate primitive support from transport weight and effective interaction.
186+
They admit conditional contact mechanisms but do not select a birth law.
187+
Formation of the initial substrate, autonomous law selection and physical
188+
identification remain open; this does not make the valid conditional results
189+
obsolete or prove that those open goals are impossible.
190+
191+
For the current repository checkpoint, deliverables and stopping rule, use the
192+
[execution plan](theory/research/FIVE_STAGE_EXECUTION_PLAN.md#current-g3-gate)
193+
as the sole task queue. Its [resumption map](theory/research/FIVE_STAGE_EXECUTION_PLAN.md#current-checkpoint)
194+
locates reusable results and evidence; the
174195
[research portfolio](https://github.com/fermga/TNFR-Python-Engine/blob/main/TNFR_lineas_de_investigacion.txt)
175-
explains the roles of the supporting studies.
196+
classifies the supporting branches without scheduling additional campaigns.
176197

177198
### How this could connect to physical reality
178199

@@ -267,6 +288,7 @@ seeds; direct `TNFR.create(..., seed=...)` sets the topology seed.
267288
| Compare an attachment | `relational_attachment` | Fresh separate/joined fields for a hypothetical connection; does not change live support |
268289
| Compare a bridge relocation | `relational_relocation` | Supplied atomic bridge exchange preserving internal support; passive budget and recovery are separate obligations |
269290
| Apply a capture or transit theorem | `Network.relational_*capture` | Read-only sufficient certificates with support-specific hypotheses |
291+
| Bound a prepared coefficient response | `bound_relational_coefficient_from_jet`, `bound_relational_coefficient_from_samples` | Module-level observers with declared uncertainty; no graph evolution or preparation authentication |
270292

271293
The [regional and relational guide](https://github.com/fermga/TNFR-Python-Engine/blob/main/docs/guides/REGIONAL_AND_RELATIONAL.md)
272294
provides preparations and examples for joint dynamics. The
@@ -300,6 +322,7 @@ belong to the [structural field guide](https://github.com/fermga/TNFR-Python-Eng
300322
| What constrains a change of connections? | [Event storage, passivity and selection limits](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/nodal/RELATIONAL_PATTERN_COMPOSITION.md#support-event-premise-admission) |
301323
| Can a pattern survive a relocated connection? | [Passive relocation and recovery](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/nodal/RELATIONAL_PATTERN_COMPOSITION.md#identity-preserving-bridge-relocation) |
302324
| How does hidden state produce memory? | [Derived pattern memory](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/nodal/RELATIONAL_PATTERN_MEMORY.md) |
325+
| What can identify a coefficient, and what does not select its law? | [Coefficient, memory and preparation admission](theory/nodal/RELATIONAL_EXCHANGE_ADMISSION.md#coefficient-synergy-audit) |
303326
| Which terms are assumptions, results or observations? | [Classified glossary](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/GLOSSARY.md) |
304327
| How will physical claims be tested? | [Measurement and reserved evaluation](https://github.com/fermga/TNFR-Python-Engine/blob/main/theory/research/FIVE_STAGE_EXECUTION_PLAN.md#supporting-measurement-bridge) |
305328

@@ -317,9 +340,11 @@ does not make them interchangeable with the main generative model.
317340
| `src/tnfr/physics/`, `mathematics/`, `metrics/` | Theorem tools, numerical algebra, observations and diagnostics |
318341
| `src/tnfr/sdk/`, `cli/` | Public networks, study recipes, reports and command adapters |
319342
| `src/tnfr/config/`, `constants/`, `utils/` | Shared configuration, numerical settings, validation helpers and I/O |
343+
| `src/tnfr/research/` | Reusable admission, provenance and read-only record audits; not another evolution runtime |
320344
| `theory/` | Mathematical definitions, derivations, research strategy and the execution plan |
321345
| `docs/` | Usage guides, execution contracts and documentation navigation |
322346
| `tests/`, `examples/`, `benchmarks/` | Contract checks, executable illustrations and scoped measurement/research instruments |
347+
| `docs/assets/`, `artifacts/` | Preserved published evidence and local protocols/source archives/responses; missing local evidence remains unavailable |
323348
| [applications/](https://github.com/fermga/TNFR-Python-Engine/blob/main/applications/README.md) | Optional arithmetic applications with explicit verification boundaries |
324349

325350
[Architecture](https://github.com/fermga/TNFR-Python-Engine/blob/main/ARCHITECTURE.md)

‎TESTING.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,10 @@ second inventory of research results or individual test cases.
6363
The routine gate includes regional/source-relative form observations, generic
6464
linear observation admission, relational field/step execution, pattern,
6565
attachment and relocation observations, work/cut/phase-response accounting,
66-
protected capture and the listed current production boundaries. The attachment
66+
protected capture and the listed current production boundaries. Coefficient
67+
jet/sample observers and read-only acquisition-audit admission are
68+
also covered by the routine top-level modules. The retained full-window record
69+
is an optional research audit, not an implicit producer invocation. The attachment
6770
observer evaluates two components and a hypothetical joined field; relocation
6871
compares the admitted fields before and after a supplied bridge exchange.
6972
Neither observer changes live support or certifies future pattern recovery.

‎TNFR_lineas_de_investigacion.txt‎

Lines changed: 57 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
TNFR - RESEARCH PORTFOLIO
22
========================
3-
Updated: 2026-09-27.
3+
Updated: 2026-10-02.
44

55
1. PURPOSE AND DOCUMENT RESPONSIBILITIES
66
========================================
@@ -43,9 +43,26 @@ identity alone does not determine pressure, phase, capacity, support or events.
4343
Source-relative observations and fixed-law closure criteria now have shared
4444
engine/SDK owners. They retain their supplied-source and domain assumptions.
4545

46+
Connection foundations now distinguish declared support, normalized transport
47+
weight, observation distance and causal dependence. A zero-weight edge is not
48+
necessarily an absent relation, and first-neighbor normalization differs from
49+
contact between already active regions. The relation state and zero-boundary
50+
admissions retain distinct autonomous passive contact completions, without
51+
selecting relation-only storage or kinetics. Fixed-support nodal evolution
52+
cannot determine them. These are reusable foundational constraints, not an
53+
active parallel creation-law search.
54+
55+
The coefficient audit likewise separates conditional model consistency from
56+
constitutive selection. Balance, independent capacity composition, clock
57+
covariance and synchronized replicas permit different chi values. Prepared
58+
response and memory can identify chi within the admitted two-channel family;
59+
they do not derive a universal coefficient or reduce all TNFR freedom to it.
60+
The execution plan alone sets the current calibration/discrimination gate.
61+
4662
Primary owners:
4763
theory/FUNDAMENTAL_THEORY.md
4864
theory/NODAL_PARAMETER_FOUNDATIONS.md
65+
theory/nodal/RELATION_FOUNDATIONS.md
4966
theory/nodal/PRESSURE_CONSTITUTIVE_SCOPE.md
5067
theory/nodal/JOINT_PARAMETER_RESPONSE.md
5168
theory/nodal/DERIVED_FORM_PHASE.md
@@ -63,6 +80,13 @@ It has shared opt-in engine/SDK execution, signed-work and regional-response
6380
observations, and separate sufficient capture/transit certificates. The
6481
default operator runtime remains a different execution path.
6582

83+
Coefficient-jet and three-sample uncertainty observers now share an engine
84+
owner and exact report export, with explicit abstention. One known-source P2
85+
temporal acquisition has a prior-derived nonlinear derivative bound and a
86+
retained numerical error chain. This verifies the procedure within the model,
87+
not blind calibration, a physical measurement or preference for one same-jet
88+
nonlinear completion. Its records remain immutable and independently auditable.
89+
6690
On supplied two-ring support, a validated continuous transit joins formation
6791
to a protected maintained phase geometry. Controls with uniform or reversed
6892
initial form reach consensus under the same law. Initial energy and loss
@@ -94,24 +118,35 @@ improved both tangent and direct-cubic controls on matched Euler grids.
94118
That result neither certifies an exact-ODE error at the evaluated amplitude
95119
nor supplies an autonomous compressed node or a fitted memory law.
96120

97-
The component-to-joined interface is now admitted for one supplied acute unit
98-
bridge, retaining full internal state. Degree, internal form gradient and the
99-
complex neighbor resultant suffice for each new port row. Equal endpoint
100-
form/phase and zero event storage do not imply unchanged local rates, excluding
101-
the endpoint-difference-only control. The shared read-only engine/SDK report
102-
retains actual represented changes; it does not create a connection.
103-
Support-event accounting and nonselection are now explicit. With unchanged
104-
nodal state, pure addition costs nonnegative joint storage. An additional
105-
zero-supply passivity premise admits only equal form/phase endpoints and does
106-
not select occurrence; a continuous addition intensity on an open full-state
107-
domain must vanish. A supplied atomic edge exchange can lower storage on an
108-
open set. An explicit two-C5 bridge relocation now retains both internal
109-
cycles and a shared sufficient continuous recovery basin on a strict open
110-
domain. Its reverse can preserve recovery while failing the passive budget;
111-
the zero-perturbation control is a neutral exchange of equilibria.
112-
The shared observer/SDK compares the event without modifying live support.
113-
The remaining dependency is constitutive event choice and clock: a favorable
114-
budget and recoverable identity do not force a connection change to occur.
121+
Retained mechanisms in this branch are classified by what they preserve:
122+
- Attachment and relocation retain port neighborhoods, full state and event
123+
work. A passive change and subsequent recovery have separate hypotheses;
124+
neither selects the event or its time.
125+
- Joint resets retain simultaneous nodal/support changes. Actual UM and
126+
RA-then-UM witnesses are conditional budget results, not autonomous birth.
127+
The all-operator map owns configured actions and activation boundaries.
128+
- Mediation retains joint form/phase memory and hidden initial information.
129+
A frozen intermediary can restore geometry without transmitting changes;
130+
a causal-null control is therefore necessary for an effective relation.
131+
- Effective links combine mutual influence with local restoring geometry on
132+
supplied fine support. Return paths and damped modes add scoped geometric
133+
information; a visible or permanent pulse is not required.
134+
- Fast and series reductions retain selected phase lifts, original port
135+
normalization, inherited storage and the initial transient. Stationary
136+
composition and finite-capacity evolution have distinct error obligations.
137+
- Three-port reduction retains genuinely collective phase information;
138+
independent pair interactions cannot generally replace the whole law.
139+
- Pressure-state counterexamples retain the environment's hidden coordinates.
140+
Zero pressure is not absence of structure, and a physical vacuum remains
141+
an unestablished interpretation.
142+
143+
These results are linked from their owners below and the theory-to-execution
144+
map, rather than copied into a delivery chronology. Primitive support origin,
145+
unrestricted nonlinear composition and changes to another winding identity
146+
remain separate open/deferred questions. Physical analogies are prompts, not
147+
validated constituents or additional campaigns. The current coefficient and
148+
same-jet-law distinction uses these observation lessons without reopening
149+
their completed producers.
115150
Precise obligations and acceptance criteria belong only to:
116151
theory/research/FIVE_STAGE_EXECUTION_PLAN.md#current-g3-gate
117152

@@ -220,7 +255,9 @@ Preserve original model, inputs, source, precision, clock and frozen outcomes.
220255
A later theorem or code correction does not rewrite an earlier verdict.
221256

222257
Autonomous support/capacity selection, unrestricted nonlinear composition and
223-
physical identification remain open. A restricted positive result need not
258+
physical identification remain open. The completed support-selection audit
259+
does not reopen an event-law search without an independently justified premise.
260+
A restricted positive result need not
224261
explain creation from nothing, prove infinite lifetime for every pattern or
225262
select every operator universally. Resume at the plan's current gate, using
226263
the substantive owners above and the archive as evidence, not as instructions.

0 commit comments

Comments
 (0)