Skip to content

Commit 4ba8823

Browse files
author
TNFR AI Agent
committed
Merge relational foundations and research consolidation
2 parents f27413a + bf8ed08 commit 4ba8823

189 files changed

Lines changed: 261773 additions & 6801 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: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,32 @@
11
# Frozen raw archives preserve original bytes, including historical whitespace.
22
# Live source and documentation retain the normal whitespace checks.
3+
docs/assets/source_relative_form_response/producer.v1.py.txt -text -whitespace
4+
docs/assets/source_relative_form_response/result.prediction.json -text
5+
docs/assets/source_relative_form_response/result.json -text
6+
docs/assets/phase_form_exchange_comparison/result.prediction.json -text
7+
docs/assets/phase_form_exchange_comparison/result.json -text
8+
docs/assets/relational_capacity_response/result.prediction.json -text
9+
docs/assets/relational_capacity_response/result.json -text
10+
docs/assets/relational_local_recovery/result.prediction.json -text
11+
docs/assets/relational_local_recovery/result.json -text
12+
docs/assets/relational_region_interaction/result.prediction.json -text
13+
docs/assets/relational_region_interaction/result.json -text
14+
docs/assets/relational_formation_response/result.prediction.json -text
15+
docs/assets/relational_formation_response/result.json -text
16+
docs/assets/relational_capture_response/result.prediction.json -text
17+
docs/assets/relational_capture_response/result.json -text
18+
docs/assets/relational_capture_response/endpoint-capture.audit.json -text
19+
docs/assets/relational_capture_response/continuous-transit.audit.json -text
20+
docs/assets/relational_capture_response/continuous-transit.audit.protocol.json -text
21+
docs/assets/relational_zero_form_response/result.json -text
22+
docs/assets/relational_zero_form_response/result.protocol.json -text
23+
docs/assets/relational_reversed_form_response/result.json -text
24+
docs/assets/relational_reversed_form_response/result.protocol.json -text
25+
docs/assets/relational_memory_response/result.prediction.json -text
26+
docs/assets/relational_memory_response/result.json -text
27+
docs/assets/relational_memory_response/result.sources.zip binary
28+
theory/research/archive/EXECUTION_PLAN_PRE_FOUR_FOUNDATIONS_2026-09-26.txt -text -whitespace
29+
theory/research/archive/PORTFOLIO_PRE_FOUR_FOUNDATIONS_2026-09-26.txt -text -whitespace
330
theory/research/archive/ROADMAP_PRE_FIVE_STAGE_2026-09-17.txt -text -whitespace
431
theory/research/archive/PORTFOLIO_PRE_COHORT_CONSOLIDATION_2026-09-19.txt -text -whitespace
532
theory/research/archive/EXECUTION_PLAN_PRE_DOCUMENTATION_CLEANUP_2026-09-19.txt -text -whitespace

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

Lines changed: 190 additions & 9 deletions
Large diffs are not rendered by default.

‎AGENTS.md‎

Lines changed: 190 additions & 9 deletions
Large diffs are not rendered by default.

‎ARCHITECTURE.md‎

Lines changed: 82 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ fresh computations; concurrent mutation during a read is unsupported.
2727
| Operator-role derivation | [`physics_derivation.py`](src/tnfr/config/physics_derivation.py) |
2828
| Grammar specification | [`grammar_canon.py`](src/tnfr/operators/grammar_canon.py) |
2929
| Grammar validation facade | [`grammar.py`](src/tnfr/operators/grammar.py) |
30-
| Canonical and operational constants | [`constants/`](src/tnfr/constants/) |
30+
| Canonical and operational constants | [`constants/`](src/tnfr/constants) |
3131
| Shared selector and Si threshold resolution | [`selector_thresholds.py`](src/tnfr/config/selector_thresholds.py) |
3232
| U3 admission limits and phase-neighbor selection | [`_phase_gate.py`](src/tnfr/operators/_phase_gate.py) |
3333
| Resonance capacity proposal and identity predicates | [`_resonance_identity.py`](src/tnfr/operators/_resonance_identity.py) |
@@ -41,6 +41,12 @@ fresh computations; concurrent mutation during a read is unsupported.
4141
| All-node THOL eligibility and explicit finite dispatch | [`self_organization_selection.py`](src/tnfr/operators/self_organization_selection.py) |
4242
| Simultaneous stage execution and graph transactions | [`network_stage.py`](src/tnfr/operators/network_stage.py) |
4343
| Structural fields | [`fields.py`](src/tnfr/physics/fields.py) |
44+
| Regional form observations and affine mean/Gram closure | [`form_geometry.py`](src/tnfr/physics/form_geometry.py); the SDK delegates rather than defining another reduction |
45+
| Regional orientation relative to a supplied rate source | [`source_relative_form.py`](src/tnfr/physics/source_relative_form.py); reuses the regional form observer |
46+
| Conditional relational phase/form execution | [`dynamics/relational.py`](src/tnfr/dynamics/relational.py); one admitted field and atomic Euler step, reused by the SDK |
47+
| Prepared relational pattern observations | [`physics/relational_observations.py`](src/tnfr/physics/relational_observations.py); supplied regions/reference lifts, shared winding and regional support accounting |
48+
| 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 |
49+
| 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 |
4450
| Coherence and equilibrium kernel | [`common.py`](src/tnfr/metrics/common.py) |
4551
| Public high-level API | [`sdk/simple.py`](src/tnfr/sdk/simple.py) |
4652

@@ -146,6 +152,81 @@ These are diagnostic consistency requirements, not a complete state basis or
146152
a stability proof. Numerical precision settings preserve intended definitions
147153
but do not guarantee identical rounded decisions at every strict threshold.
148154

155+
Regional form observations have a separate shared owner in
156+
[`form_geometry.py`](src/tnfr/physics/form_geometry.py). The supplied ordered
157+
triples define Cartesian contrasts, their Gram matrix and instantaneous rates
158+
from the same admitted `nu_f * stored_DeltaNFR` product used by the nodal
159+
kernel. Exact represented quantities retain the rate-rounding defect; polar
160+
estimates retain their own availability. No pressure refresh, graph mutation,
161+
primitive phase substitution or reduced evolution occurs in the observer.
162+
`Network.regional_form` is the public adapter.
163+
164+
The same module's `derive_regional_affine_closure` checks an independently
165+
supplied fixed affine law on the full real fine-state domain. Source terms are
166+
rates; only sources constant within each region preserve the all-state
167+
mean/Gram closure when the generator passes its block-circulant test. A failed
168+
reduction retains defects and leaves the fine law usable. The report is not
169+
proof that runtime policy holds support, capacity, coefficients and primitive
170+
phase fixed. The [derived-form note](theory/nodal/DERIVED_FORM_PHASE.md) owns
171+
the proof and source-relative response; the
172+
[SDK guide](docs/CLI_AND_SDK.md#observe-regional-form-and-its-nodal-response)
173+
owns usage and representation conventions.
174+
175+
[`source_relative_form.py`](src/tnfr/physics/source_relative_form.py) composes
176+
that observer with an independently supplied held source in form-rate units.
177+
It retains `W=z*c^dagger`, where `c` is the source's regional contrast, and its
178+
instantaneous held-source rate. A nonzero vector `c` makes regional contrast
179+
recoverable from `W`; a zero vector does not define a reference orientation.
180+
`Network.source_relative_form` delegates to this read-only owner. The observer
181+
does not derive the source, authenticate its future constancy or add a phase
182+
law to the engine.
183+
184+
The opt-in relational execution owner also supplies the joint law used by the
185+
[local-recovery and paired-region studies](theory/nodal/RELATIONAL_EXCHANGE_ADMISSION.md#relational-local-recovery).
186+
Their continuous hypotheses and finite controls are distinct from step admission.
187+
The default acute domain and opt-in positive-resultant chamber share this
188+
owner. The latter uses the private rational cosine/resultant helper in
189+
`mathematics/_phase_resultant_chamber.py`, with the existing certified pi
190+
enclosure, to admit complete represented Euler chords. It retains exact
191+
margins without claiming an exact-flow enclosure or a new phase law.
192+
[`relational_observations.py`](src/tnfr/physics/relational_observations.py) reads a
193+
fresh detached field from that owner and projects supplied regions against an
194+
explicit phase reference. It keeps offsets and separate form/phase norms,
195+
delegates winding to `winding_certificates.py`, and reuses
196+
`support_transport.py` for admitted regional accounting. The dynamics field
197+
retains exact nodal dissipation/exchange/work and sums them for its global
198+
balance. Regional observations sum those same contributions and pair form/phase
199+
rates through a single shared outward-cut definition, retaining numerical
200+
defects and explicit divided-rate availability. The engine also retains exact
201+
phase mobility and phase-rate materialization defects. Regional unweighted
202+
phase response uses that same evidence and cut to separate mean-mobility
203+
boundary response from mobility/form covariance, with an exact squared bound.
204+
It remains available at zero capacity and adds no evolution,
205+
region selector or formation mechanism. `Network.relational_pattern` is a
206+
thin adapter; the SDK's `relational_report_to_dict` supplies the exact rational
207+
JSON projection for the existing writer. Reports are observations, not live
208+
checkpoints or authenticated execution histories.
209+
210+
[`mathematics/linear_observation.py`](src/tnfr/mathematics/linear_observation.py)
211+
owns exact invariant-row realization for any supplied finite rational
212+
generator `z'=Jz`. The diffusion-specific `physics/epi_memory.py` wrapper
213+
retains its independently admitted `x'=-Ax+b` model and existing outputs;
214+
it delegates algebra without transferring diffusion premises to joint phase
215+
and form dynamics. Shared exact matrix products/inverses now live in
216+
`mathematics/_exact_linear_algebra.py`, with historical physics import paths
217+
preserved. The [composition study](theory/nodal/RELATIONAL_PATTERN_COMPOSITION.md)
218+
separates that reusable computation from its exact analytic rank proof and
219+
nonlinear counterexample.
220+
The counterexample also rules out closing that coarse state by adding its
221+
instantaneous rate. Full centered nodal coordinates already retain the
222+
responsible internal contrast; the engine does not replace them with a coarse
223+
autonomous model. Static derivative controls check the existing field.
224+
The same composition instrument now verifies the complete visible/hidden
225+
split and quadratic energy balance. The
226+
[joint memory theorem](theory/nodal/RELATIONAL_PATTERN_MEMORY.md) owns its
227+
nonlinear initial-state dependence and conditional finite-time approximation
228+
orders. No new solver or autonomous regional state is installed.
229+
149230
The unforced product, conditional diffusion identities, named operator
150231
contracts and coherent diagnostics are implemented foundations. Unique phase,
151232
capacity, support-formation and autonomous operator-selection laws remain

0 commit comments

Comments
 (0)