TNFR Logo
TheoryLearnSoftwareResearch

On this page

TNFR

Resonant Fractal Nature Theory — a mathematical framework for coherent patterns on graph-coupled networks.

About
  • Project history
  • Editorial policy
  • Contact
Resources
  • GitHub
  • PyPI
  • DOI · Zenodo
Legal
  • MIT License
  • Citation
© 2026 TNFR project — MIT licensed.DOI 10.5281/zenodo.17602860
docs
grammar
PHYSICS_VERIFICATION.md
API_CONTRACTS.mdCANONICAL_OZ_SEQUENCES.mdEMPIRICAL_CONFRONTATION_EEG.mdREADME.mdSTRUCTURAL_FIELDS_TETRAD.mdSTRUCTURAL_INTERFACE_THEORY.md
theory
APPLIED_STRUCTURAL_ANALYSIS.mdCATALOG_TYPE_HYGIENE_PROGRAMME.mdDISSIPATIVE_AND_OPEN_SYSTEMS.mdEMERGENT_ONTOLOGY.mdEXTENDED_FIELDS_AND_DERIVED_QUANTITIES.mdFUNDAMENTAL_THEORY.mdGAUGE_SYMMETRY_AND_UNIFICATION.mdGLOSSARY.mdMATHEMATICAL_DYNAMICS_BASIS.mdMINIMAL_STRUCTURAL_DEGREES.mdNUCLEUS_A_PRIME_LADDER_ATLAS.mdNUCLEUS_B_EQUIVARIANCE_OBSTRUCTIONS.mdPHYSICAL_REGIME_CORRESPONDENCES.mdREADME.mdREMESH_INFINITY_DERIVATION.mdSTRUCTURAL_CONSERVATION_THEOREM.mdSTRUCTURAL_OPERATORS.mdSTRUCTURAL_STABILITY_AND_DYNAMICS.mdTNFR_BSD_RESEARCH_NOTES.mdTNFR_HODGE_RESEARCH_NOTES.mdTNFR_NAVIER_STOKES_RESEARCH_NOTES.mdTNFR_NUMBER_THEORY.mdTNFR_P_VS_NP_RESEARCH_NOTES.mdTNFR_RIEMANN_RESEARCH_NOTES.mdTNFR_VARIATIONAL_PRINCIPLE.mdTNFR_YANG_MILLS_RESEARCH_NOTES.mdTNFR.pdfUNIFIED_GRAMMAR_RULES.md
factorization-lab
analysis
analyze_patterns.pycertificate_manifest.py
benchmarks
benchmark_analysis.pybenchmark_expansion_suite.pyfull_spectrum_factorization.pypaley_gap_extended.pypaley_gap_smoke.pytest_benchmark_suite.py
demos
experiment_contexts
exp_0b1663cd19b7.jsonexp_0bf0054b7474.jsonexp_75a4c8ca616a.jsonexp_848ee0fd1857.jsonexp_f6fe00562193.jsonexp_fdf3da424e1e.json
failure_telemetry_batch.pyfeedback_integration_demo.pyintegration_demo_snapshots.dbseed_management_integration_demo.pysnapshot_integration_demo.pytrajectory_143.jsontrajectory_77.jsontrajectory_89.jsontrajectory_91.jsontrajectory_97.json
docs
FACTORING_PLAYBOOK.mdFALSE_POSITIVE_TEST_SUITE.mdOPERATOR_CERTIFICATES.mdROADMAP.mdSPECTRAL_ROUTE.md
experiment_contexts
exp_cebe1d9e7d8e.json
notebooks
spectral_history.ipynb
scripts
run_false_positive_tests.py
tests
run_false_positive_test_suite.pytest_cli.pytest_false_positive_methodology.pytest_false_positive_verifier.pytest_feedback_integration.pytest_partitioning.pytest_seed_management.pytest_self_opt_support.pytest_snapshot_system.pytest_spectral_paley.pytest_verification_robustness.py
tnfr_factorization
__init__.pyapi.pycli.pyfailure_telemetry.pyfeedback_adapter.pyfeedback_integration.pypartitioning.pyself_opt_support.pyspectral_paley.py
demo_snapshots.dbLICENSE_SNAPSHOT.mdPACKAGE_SUMMARY.mdREADME.mdseed_management.pysnapshot_system.pytest_certificate_hashing.pytest_installation.pyverification_trajectory_77.json
benchmarks
analyze_tetrad_universality.pyb0star_alpha_canonical_product_graphs.pybenchmark_optimization_tracks.pybenchmark_utils.pyboundary_vibration.pybridge_primes_riemann.pychiral_involution.pycli_utils.pycoherence_projector_sense_index.pycommutant_bridge.pycomposition_arithmetic.pyconfinement_zones_test.pyconservation_law_validation.pydirected_paley_bridge.pyemergent_arithmetic_pulse.pyemergent_atom_dynamics.pyemergent_atomic_shells.pyemergent_base_dimension.pyemergent_dimension_dynamics.pyemergent_fractal_pulse.pyemergent_fractal_simplex_dimension.pyemergent_integers_symmetry.pyemergent_musical_nfr.pyemergent_nfr_geometry.pyemergent_nfr_where.pyemergent_rationals.pyemergent_rhythm.pyemergent_screening.pyemergent_shell_cardinals.pyemergent_shell_ordering.pyemergent_simplex_dimension.pyemergent_substrate_symmetry.pyequivariance_wall.pyexternal_phase_gate_validation.pyfield_methods_battery.pygolden_residue_remesh_bridge.pyintegrated_force_regime_study.pyinverse_spectrum_to_symmetry.pyk_phi_safety_demo.pykuramoto_farey_bridge.pymissing_piece_bridge.pymultichannel_interface_benchmark.pynavier_stokes_recipe_bridge.pynodal_propagator_residue_bridge.pyns_moment_hierarchy_cascade.pyoperational_irreducibility.pypaley_bridge.pyphase_curvature_investigation.pyphase_wall.pyphi_s_confinement_investigation.pyprimes_as_consequence.pypulse_phase_coherence_budget.pyREADME.mdremesh_infinity_riemann_baseline.pyremesh_infinity_riemann_composed.pyremesh_infinity_riemann_modified_graph.pyremesh_infinity_riemann_operator.pyremesh_infinity_riemann_spectral_basis.pyremesh_infinity_riemann_spectral_robustness.pyremesh_infinity_riemann_spectral.pyresidue_phase_vs_riemann.pystructural_interface_benchmark.pytemporal_interface_benchmark.pytetrad_results_aggregate.pyu2_destabilization_irreversibility.pyuniversality_clusters.pyxi_c_fast_experiment.py
primality-test
benchmarks
comprehensive_benchmark.py
docs
ADVANCED_INTEGRATION.mdmathematical_foundation.mdperformance_analysis.md
examples
advanced_examples.pybasic_usage.py
tnfr_primality
__init__.py__main__.pyadvanced_cli.pyadvanced_core.pycli.pyconstants.pycore.pyoptimized.py
MANIFEST.inPACKAGE_SUMMARY.mdREADME.mdRELEASE_NOTES_v1.0.mdsetup.pytest_installation.py
tests
core_physics
__init__.pytest_conservation_laws.pytest_delta_nfr_computation_paths.pytest_delta_nfr.pytest_dispersion_coherence_sign_invariance.pytest_emergent_constants_guard.pytest_lyapunov_operators.pytest_nodal_equation.pytest_structural_triad.py
data
replay_manifests
sample_run
_manifest_summary.json_manifest.json_partition_files.txt.gz
self_opt_validation
seed_alpha
paley.json
seed_beta
integration.json
seed_gamma
unknown.json
self_optimization
test_run
partitioned
test_run
test_run_p0.jsontest_run_p1.json
_manifest_summary.json_manifest.json
engines
test_pattern_discovery_manifest.pytest_self_optimization_engine.py
mathematics
__init__.pytest_autodiff.pytest_backends.pytest_dissipative_dynamics.pytest_epi.pytest_factory_patterns.pytest_metrics.pytest_navier_stokes_refounded.pytest_number_theory_canonical.pytest_operators.pytest_residue_networks.pytest_riemann_nodal_pulse.pytest_riemann_pulse_coherence.pytest_spaces.pytest_transforms.pytest_validator.py
operators
test_canonical_operators_modern.pytest_grammar_canon.pytest_grammar_canonical_consistency.pytest_grammar_dynamics.pytest_operator_contracts.pytest_operator_strategies.py
parallel
test_fractal_partition_manifest.py
physics
test_conservation_gauge_unification.pytest_dissipative_conservation.pytest_emergent_chemistry.pytest_field_cache_invalidation.pytest_gauge.pytest_phase_transition.pytest_signatures.pytest_spectral_conservation.pytest_structural_diffusion.pytest_structural_integrity.pytest_symplectic_substrate.pytest_tetrad_bounds.pytest_variational.pytest_yang_mills_closure.pytest_yang_mills_derivability.pytest_yang_mills_scaling.pytest_yang_mills_structural_gap.pytest_yang_mills_u6_sweep.py
scripts
test_run_self_opt_validation.pytest_run_self_optimization.py
sdk
__init__.pytest_simple_advanced.py
__init__.pyconftest.pyREADME.mdtest_breast_cancer_phase_gate_demo.pytest_classical_mechanics.pytest_distributed_fft.pytest_external_phase_gate_validation.pytest_factorization_entrypoint.pytest_multichannel_interface.pytest_nodal_optimizer.pytest_phase_gate_api.pytest_replay_register_manifest.pytest_signal_confrontation.pytest_structural_interface_api.pytest_structural_interface_baselines.pytest_structural_interface_benchmark.pytest_temporal_interface.pytest_vectorized_coherence_length_regression.pytest_wine_quality_phase_gate_demo.pyutils.py
examples
01_foundations
01_hello_world.py02_musical_resonance.py03_network_formation.py04_operator_sequences.py05_coherence_evolution.py06_network_topologies.py07_phase_transitions.py08_emergent_phenomena.py09_visualization_suite.py10_simplified_sdk_showcase.py
02_physics_regimes
11_classical_limit_comparison.py115_operator_contract_audit.py12_classical_mechanics_demo.py13_quantum_mechanics_demo.py14_uncertainty_and_interference.py15_train_crossing_demo.py17_conservation_law_demo.py26_gauge_structure_demo.py27_variational_principle_demo.py28_dissipative_systems_demo.py29_lyapunov_stability_demo.py30_self_optimization_demo.py31_mathematical_constants_basis.py33_complex_field_unification.py34_conservation_protocol_suite.py35_tetrad_irreducibility.py36_grammar_violation_detector.py37_operator_tetrad_synergy.py38_grammar_energy_landscape.py39_nodal_equation_decomposition.py
03_riemann_zeta
157_nodal_pulse_phase_attack.py41_von_mangoldt_zeta_demo.py42_riemann_zeros_as_resonances.py43_prime_ladder_hamiltonian_demo.py44_weil_explicit_formula_demo.py45_li_keiper_demo.py46_weil_tnfr_positivity_demo.py47_alpha_sweep_demo.py48_admissible_family_sweep_demo.py49_nodeaware_gauge_sweep_demo.py50_uniform_coercivity_demo.py51_adaptive_coercivity_demo.py52_paley_gap_coercivity_demo.py53_lyapunov_spectral_positivity_demo.py54_hilbert_polya_demo.py55_structural_zero_density_demo.py56_spectral_emergence_demo.py57_admissible_rescaling_demo.py58_oscillatory_correction_demo.py
04_riemann_L_twisted
59_dirichlet_l_function_demo.py60_dirichlet_l_continuation_demo.py61_dirichlet_l_hamiltonian_demo.py62_dirichlet_weil_explicit_formula_demo.py63_dirichlet_li_keiper_demo.py64_twisted_weil_positivity_demo.py65_twisted_alpha_sweep_demo.py66_twisted_admissible_family_sweep_demo.py67_twisted_nodeaware_gauge_sweep_demo.py68_twisted_hermite_family_demo.py69_twisted_coercivity_uniform_demo.py70_twisted_paley_gap_coercivity_demo.py71_twisted_lyapunov_spectral_demo.py72_twisted_hilbert_polya_demo.py73_twisted_structural_zero_density_demo.py74_twisted_spectral_emergence_demo.py75_twisted_admissible_rescaling_demo.py76_twisted_oscillatory_correction_demo.py
05_type_hygiene
77_remesh_infinity_residue_split_demo.py78_nuf_type_signature_demo.py79_epi_type_signature_demo.py80_phi_type_signature_demo.py81_dnfr_type_signature_demo.py82_remesh_window_type_signature_demo.py83_delta_phi_max_type_signature_demo.py84_coupling_weights_type_signature_demo.py85_tetrad_closure_signature_demo.py86_currents_closure_signature_demo.py87_aggregates_closure_signature_demo.py88_urules_consistency_signature_demo.py89_operator_catalog_discipline_signature_demo.py
06_navier_stokes
158_navier_stokes_two_face_refounded.py
07_number_theory
100_prime_families_orbits.py101_numbers_as_coupled_network.py102_nodal_flow_primes_equilibria.py116_nuf_emergent_prime_visibility.py146_primality_grammatical_inertness.py147_numbers_as_free_monoid_words.py148_capacity_arm_carries_von_mangoldt.py149_p14_is_the_capacity_arm_operator.py153_structural_frequency_rank_cyclotomy.py40_arithmetic_number_theory.py94_generative_number_construction.py95_primes_from_spectral_waves.py96_spectral_vibration_of_coherence.py97_goldbach_additive_multiplicative.pyemergent_chemistry_particles_demo.py
08_emergent_geometry
103_emergent_substrate_meets_riemann.py106_per_node_polarization_geometry.py107_orthogonal_structure_emergent_geometry.py108_emergent_field_generating_structure.py112_structure_predicts_coherence_flow.py113_overdamped_projection_bridge.py114_substrate_conserved_quantities.py117_emergent_geometry_residue_graph.py118_emergent_vs_classical_operator.py119_phase_sector_directed_residue.py120_symmetry_wall_substrate_vs_spectrum.py121_canonical_symmetry_break_negative.py122_factorization_phase_sector.py123_symmetry_sector_decomposition.py124_emergent_metric_fractal_consistency.py125_node_is_the_emergent_substrate.py126_two_layers_base_fiber.py127_base_is_emergent_not_imposed.py128_base_substrate_coemergence.py129_spectral_gap_base_fiber_clock.py130_operators_break_substrate_charges.py131_coemergent_loop_convergence.py132_geometric_phase_holonomy.py133_psi_topological_defects.py134_spectral_dimension_heat_kernel.py135_arrow_of_time_h_theorem.py136_heat_kernel_coefficients.py137_synchronization_transition.py138_structure_frequency_synchronization.py139_grammar_formal_language.py140_grammar_automaton.py141_grammar_rule_decomposition.py142_grammar_operator_quotient.py143_glyphic_function_sublanguage.py144_branching_combinator.py145_syntactic_monoid_starfree.py150_emergent_grammatical_pattern_parry.py151_grammar_in_emergent_geometry.py152_operator_contract_tetrahedron.py154_conductor_annotated_qr_spectrum.py155_ontological_position_of_numbers.py156_emergence_directness_law.py98_emergent_symplectic_substrate.py99_structural_diffusion.pyunified_fields_showcase.py
09_millennium
109_p_vs_np_coherence_synthesis.py110_bsd_rank_structural_pressure.py111_hodge_discrete_and_honest_gap.py
10_applications
159_empirical_confrontation_pipeline.py90_phase_gate_monitor_demo.py91_breast_cancer_phase_gate_demo.py92_wine_quality_phase_gate_demo.py93_structural_interface_demo.pypytorch_cuda_demo.py
README.md
scripts
replay
__init__.pyregister_manifest.py
__init__.pyREADME.mdrebuild_failure_manifest.pyrun_reproducible_benchmarks.pyrun_self_opt_validation.pyrun_self_optimization.pytnfr_is_prime.pyvalidate_conservation_law.pyverify_internal_references.py
src
core
__init__.pyevaluation.py
tnfr
backends
__init__.pyjax_backend.pynumpy_backend.pyoptimized_numpy.pyREADME.mdtorch_backend.py
cli
__init__.py__init__.pyiarguments.pyarguments.pyiexecution.pyexecution.pyiinteractive_validator.pyREADME.mdutils.pyutils.pyi
compat
__init__.pydataclass.pyjsonschema_stub.pymatplotlib_stub.pynumpy_stub.pyREADME.md
config
__init__.py__init__.pyiconstants.pyconstants.pyidefaults_core.pydefaults_init.pydefaults_metric.pydefaults.pyfeature_flags.pyfeature_flags.pyiglyph_constants.pyoperator_names.pyoperator_names.pyiphysics_derivation.pyprecision_modes.pypresets.pypresets.pyiREADME.mdsecurity.pythresholds.pytnfr_config.py
constants
__init__.py__init__.pyialiases.pyaliases.pyicanonical.pymetric.pymetric.pyioperational.py
core
__init__.pycontainer.pydefault_implementations.pyexceptions.pyinterfaces.pyREADME.md
dynamics
__init__.py__init__.pyiadaptation.pyadaptation.pyiadaptive_sequences.pyadaptive_sequences.pyiadelic.pyadvanced_cache_optimizer.pyadvanced_fft_arithmetic.pyaliases.pyaliases.pyibifurcation.pycache_aware_fft_engine.pycanonical.pycanonical.pyicomputational_hub.pycoordination.pycoordination.pyidistributed_fft.pydnfr.pydnfr.pyidynamic_limits.pyemergent_centralization.pyemergent_integration_engine.pyfeedback.pyfeedback.pyifft_backend.pyfft_cache_coordinator.pyfft_dispatchers.pyfft_engine.pyfft_workers.pyfused_dnfr.pyhomeostasis.pyhomeostasis.pyiintegrators.pyintegrators.pyilearning.pylearning.pyimetabolism.pymulti_modal_cache.pynbody_tnfr.pynbody.pynodal_optimizer.pyoptimization_orchestrator.pypropagation.pyREADME.mdruntime.pyruntime.pyisampling.pysampling.pyiselectors.pyselectors.pyiself_optimizing_engine.pyspectral_structural_fusion.pystructural_cache.pystructural_clip.pysymplectic.pyunified_backend.pyunified_mathematical_cache_orchestrator.py
engines
computation
__init__.pyfft_engine.pyunified_fft_engine.pyunified_gpu_system.py
constants
__init__.pycanonical.pyoperational.py
integration
__init__.pyemergent_integration.py
pattern_discovery
__init__.pymathematical_patterns.pymulti_modal_cache.py
self_optimization
__init__.pyengine.py
__init__.pyREADME.md
errors
__init__.pycontextual.py
factorization
__init__.py
flatten
README.md
gamma
README.md
glyph_history
README.md
glyph_runtime
README.md
immutable
README.md
initialization
README.md
io
README.md
math
__init__.pyfields_symbolic.pygrammar_validators.pyoptimizer.pyREADME.mdsymbolic.py
mathematics
__init__.pybackend.pybackend.pyidynamics.pydynamics.pyiepi.pyepi.pyigenerators.pygenerators.pyiliouville.pymetrics.pymetrics.pyinumber_theory.pyoperators_factory.pyoperators_factory.pyioperators.pyoperators.pyioptimized_primality.pyprojection.pyprojection.pyiREADME.mdruntime.pyruntime.pyispaces.pyspaces.pyispectral.pytransforms.pytransforms.pyiunified_cache.pyunified_numerical.pyzeta.py
metrics
__init__.py__init__.pyibuffer_cache.pybuffer_cache.pyicache_utils.pycoherence.pycoherence.pyicommon.pycommon.pyicore.pycore.pyidiagnosis.pydiagnosis.pyiemergence.pyexport.pyexport.pyiglyph_timing.pyglyph_timing.pyilearning_metrics.pylearning_metrics.pyilocal_coherence.pyphase_coherence.pyphase_compatibility.pyREADME.mdreporting.pyreporting.pyisense_index.pysense_index.pyitelemetry.pytetrad.pytrig_cache.pytrig_cache.pyitrig.pytrig.pyi
multiscale
__init__.pyhierarchical.pyREADME.md
navier_stokes
__init__.pyconservative_face.pyoperator.py
node
README.md
observers
README.md
operators
network_analysis
__init__.pysource_detection.py
postconditions
__init__.pymutation.py
preconditions
__init__.pycoherence.pydissonance.pyemission.pymutation.pyreception.pyresonance.py
strategies
__init__.pydefaults.pygpu_strategies.pystrategy.py
__init__.py__init__.pyialgebra.pycanonical_patterns.pycascade.pycoherence.pycontraction.pycoupling.pycycle_detection.pydefinitions_base.pydefinitions.pydefinitions.pyidissonance.pyemission.pyexpansion.pygrammar_application.pygrammar_canon.pygrammar_context.pygrammar_core.pygrammar_dynamics.pygrammar_error_factory.pygrammar_memoization.pygrammar_patterns.pygrammar_telemetry.pygrammar_types.pygrammar_u6.pygrammar_validate.pygrammar.pygrammar.pyihamiltonian.pyhealth_analyzer.pyintrospection.pyjitter.pyjitter.pyilifecycle.pymetabolism.pymetrics_basic.pymetrics_core.pymetrics_network.pymetrics_structural.pymetrics_u6.pymetrics.pymutation.pynodal_equation.pyoperator_contracts.pypattern_detection.pypatterns.pyREADME.mdreception.pyrecursivity.pyregistry.pyregistry.pyiremesh.pyremesh.pyiresonance.pyself_organization.pysilence.pystructural_units.pytransition.py
parallel
__init__.pyauto_scaler.pydistributed.pyengine.pymonitoring.pypartitioner.pyREADME.md
performance
guardrails.py
physics
__init__.py_helpers.pycalibration.pycanonical.pycell.pyclassical_mechanics.pyconservation_gauge_unification.pyconservation.pydissipative_conservation.pyemergent_chemistry.pyemergent_particles.pyextended.pyfields.pygauge.pyintegrity.pyinteractions.pylife.pylyapunov.pypatterns.pyphase_transition.pyquantum_mechanics.pyREADME.mdsignatures.pyspectral_conservation.pyspectral_metrics.pystructural_diffusion.pysymplectic_substrate.pytelemetry.pyunified.pyvariational.pyvectorized_ops.py
primality
__init__.py
recipes
__init__.pycookbook.pyREADME.md
riemann
__init__.pyadmissible_family_sweep.pyadmissible_rescaling.pyaggregates_closure_signature.pyalpha_sweep.pyanalytic_continuation_dirichlet.pyanalytic_continuation.pycoercivity_uniform.pycoupling_weights_type_signature.pycurrents_closure_signature.pydelta_phi_max_type_signature.pydirichlet_l.pydnfr_type_signature.pyepi_type_signature.pyhilbert_polya.pyli_keiper.pylyapunov_spectral_positivity.pynodal_pulse.pynodeaware_gauge_sweep.pynuf_type_signature.pyoperator_catalog_discipline_signature.pyoperator.pyoscillatory_correction.pypaley_gap_coercivity.pyphi_type_signature.pyprime_ladder_hamiltonian.pypulse_coherence.pyremesh_infinity_residue_split.pyremesh_window_type_signature.pyspectral_emergence.pystructural_zero_density.pytelemetry.pytetrad_closure_signature.pytwisted_admissible_family_sweep.pytwisted_admissible_rescaling.pytwisted_alpha_sweep.pytwisted_coercivity_uniform.pytwisted_hermite_family.pytwisted_hilbert_polya.pytwisted_li_keiper.pytwisted_lyapunov_spectral_positivity.pytwisted_nodeaware_gauge_sweep.pytwisted_oscillatory_correction.pytwisted_paley_gap_coercivity.pytwisted_prime_ladder_hamiltonian.pytwisted_spectral_emergence.pytwisted_structural_zero_density.pytwisted_weil_explicit_formula.pytwisted_weil_positivity.pyurules_consistency_signature.pyvon_mangoldt.pyweil_explicit_formula.pyweil_positivity.py
schemas
__init__.pygrammar.jsonREADME.md
sdk
__init__.py__init__.pyiadaptive_system.pyadaptive_system.pyibuilders.pybuilders.pyifluent.pyfluent.pyiREADME.mdself_opt.pysimple.pytemplates.pytemplates.pyiutils.py
security
__init__.pycrypto.pydatabase.pyREADME.mdsubprocess.pyvalidation.py
sequencing
__init__.pypatterns.pyREADME.md
services
__init__.pyorchestrator.pyREADME.md
sparse
__init__.pyREADME.mdrepresentations.py
structural
README.md
telemetry
__init__.pycache_metrics.pycache_metrics.pyiconstants.pynu_f.pynu_f.pyiREADME.mdunified_telemetry_system.pyverbosity.pyverbosity.pyi
tools
__init__.pydomain_templates.pyREADME.mdsequence_generator.pytnfr_is_prime_cli_optimized.pytnfr_is_prime_cli.py
topology
__init__.pyasymmetry.pyREADME.md
utils
cache_layers.pycache.pycache.pyicallbacks.pycallbacks.pyichunks.pychunks.pyidata.pydata.pyifast_diameter.pygraph.pygraph.pyiinit.pyinit.pyiio.pyio.pyinumeric.pynumeric.pyiREADME.mdtopology.pyunified_cache.py
validation
__init__.py__init__.pyiaggregator.pybase.pycompatibility.pycompatibility.pyiconfig.pygraph.pygraph.pyihealth.pyinput_validation.pyinterface_baselines.pyinvariants.pymultichannel_interface.pyphase_gate.pyREADME.mdrules.pyrules.pyiruntime.pyruntime.pyisequence_validator.pysignal_confrontation.pysoft_filters.pysoft_filters.pyispectral.pyspectral.pyistructural_interface.pytemporal_interface.pyunified_validation_system.pyvalidator.pywindow.pywindow.pyi
visualization
__init__.pycascade_viz.pyhierarchy.pyREADME.mdsequence_plotter.py
yang_mills
__init__.pyclosure.pyderivability.pyscaling.pystructural_gap.pyu6_sweep.py
__init__.py__init__.pyi_compat.py_version.py_version.pyialias.pyalias.pyibackend_config.pycache.pycache.pyiexecution.pyexecution.pyiflatten.pyflatten.pyigamma.pygamma.pyiglyph_history.pyglyph_history.pyiglyph_runtime.pyglyph_runtime.pyiimmutable.pyimmutable.pyiinitialization.pyinitialization.pyiio.pyio.pyilocking.pylocking.pyinode.pynode.pyiobservers.pyobservers.pyiontosim.pyontosim.pyipy.typedrng.pyrng.pyisecure_config.pyselector.pyselector.pyisense.pysense.pyistructural.pystructural.pyitokens.pytokens.pyitrace.pytrace.pyitypes.pytypes.pyiunits.pyunits.pyi
tetrad_evaluator.py
.pre-commit-config.yaml.semgrep.yaml.zenodo.jsonARCHITECTURE.mdbandit.yamlCHANGELOG.mdCITATION.cffCONTRIBUTING.mdEMERGENT_CANON_AUDIT.mdEMERGENT_DERIVATION_PLAN.mdLICENSE.mdMakefileMANIFEST.inpyproject.tomlpyrightconfig.jsonPYTORCH_CUDA_INTEGRATION.mdREADME.mdSECURITY.mdTESTING.mdTNFR_Website_Content_Brief.md
FILE: EMERGENT_CANON_AUDIT.md

EMERGENT_CANON_AUDIT.md

Emergent Canon Audit — consolidating the post-φ/γ/e TNFR base

Status: COMPLETE — superseded by EMERGENT_DERIVATION_PLAN.md, which carried the φ/γ/e re-derivation through Stages 0–5 and now enforces it with a regression guard (tests/core_physics/test_emergent_constants_guard.py) · Started: 2026-06-27 · Completed: 2026-06-28 · Owner: TNFR refactor

0. Why this exists

The obsolete constants φ (golden ratio), γ (Euler–Mascheroni), e (Napier) were removed from the engine: only π is a genuine structural scale. But the prior purge only removed the φ/γ/e formulas from the code/comments — it left the numeric values frozen (e.g. K_TOP_FALLBACK = 2.803171 was φ/γ; MATH_DELTA_NFR_THRESHOLD = 0.067592 was γ/(eπ)). These frozen decimals are now magic numbers with no emergent meaning, and a few are outright non-physical (see below). Since all prior TNFR results depended on these constants and their interactions, the entire numeric base must be re-derived and reinterpreted so that every value either:

  1. emerges from TNFR structure/dynamics (π, the spectral gap λ₂, the nodal coherence C(t) = 1/(1+mean|ΔNFR|+mean|dEPI|), the operator contracts, the grammar U1–U6, the derivative-tower tetrad), or
  2. is an honest free parameter (a clean structural default — unit, π-fraction, 0, or a simple rational — explicitly labeled tunable), or
  3. is an operational engine knob (cache/speedup/scoring; not nodal physics) set to a plain round value, explicitly labeled, or
  4. is eliminated (meaningless / dead / redundant).

This file tracks what is done and what remains. Hold commit/push until a green milestone is confirmed by the user. Test command:

powershell
$env:PYTHONIOENCODING="utf-8"; $env:PYTHONPATH=(Resolve-Path -Path ./src).Path; & ".\.venv312\Scripts\python.exe" -m pytest -q --no-header -p no:cacheprovider

Baseline before this audit: 2201 passed, 12 skipped, 0 failed.

1. Decoder — the frozen φ/γ/e decimals (the "tell")

These recurring decimals across constants/canonical.py reveal a φ/γ/e origin and must be replaced. (Non-exhaustive; any 6-decimal value tied to these is suspect.)

Frozen decimalWas (φ/γ/e)Frozen decimalWas (φ/γ/e)
0.041774γ/(π·e·φ)0.737061φ/(φ+γ)
0.067592γ/(e·π)0.750575(e·φ)/(π+e)
0.098503γ/(π+e)0.6180341/φ
0.1351842γ/(eπ)0.3819661/φ² (= 2−φ)
0.155215γ/(π+γ)1.618034φ
0.183733γ/π2.718282e
0.463881e/(π+e)2.803171φ/γ
0.490983~γ·φ/…3.025733(φ+1)·π/e
0.933955~π·e/…5.083204φ·π
0.330365~1/(e+γ)8539.734223large φ/γ/e artifact

2. Categories (counts approximate)

  • A — Emergent / clean (KEEP, ~40): π-derived (π/2, π/4, 0.9π, 1/(π+1), π/(π+1), 1/(2π), 1/(4π), 1/(8π), 2π, sin/cos of π-multiples, exp(LN_2)=2), unit/integer free params (0.9, 1.05, 0.10, 0.5, ±1, 1.0, 2, 6, 50, 100, 256), honest tolerances (1e-10, 1e-8, 1e-6).
  • B — Frozen φ/γ/e PHYSICS values (RE-DERIVE, ~25): enter the nodal eq / operators / grammar / fields / telemetry. Top priority — these define the paradigm. (Table in §4.)
  • C — Frozen φ/γ/e ENGINE knobs (CLEAN VALUES, ~200): scoring weights, cache sizes, speedups, prediction horizons, domain (medical/business/viz/example/cli) thresholds. Not nodal physics → plain round values or relocation/elimination.
  • D — Inline magic numbers in physics/, dynamics/, operators/, metrics/ modules (not named constants): audit separately.

3. Staged plan

  • Stage 0 — Full inventory + categorization + this tracking file.
  • Stage 1 — Tier-1 canonical physics re-derivation (§4). DONE (suite green 2201). All Tier-1 rows re-derived or eliminated; the PHYSICS_*_DEPENDENCY empirical-fit coefficients were reclassified to Tier-2 (Stage 2). The canonical physics base is now emergent.
  • Stage 2 — Tier-2 engine-knob clean-up (§5): DONE. 180 frozen φ/γ/e decimals rounded to clean operational values; all dead domain constants (MEDICAL_/BUSINESS_/VIZ_/EXAMPLE_/BENCH_/THERAP_/CLI_/SCRIPT_/TOOL_/UTILS_) and the dead CANONICAL_CONSTANTS registry + PHASE_8/9 dicts ELIMINATED; engine-used SDK_* relocated into sdk/builders.py. canonical.py ~770 → ~565 lines. Suite green 2201.
  • Stage 3 — Inline magic-number audit in modules (Category D). DONE (core modules were ~95% clean). Fixed the residual φ/γ/e artifacts + operator-gain inconsistencies; suite green 2201.
  • Stage 4 — Reinterpretation: updated theory/TNFR_NUMBER_THEORY.md §7.5 (the stale arith-trio "recalibration" table → the canonical π-derived tetrad thresholds) and added a CHANGELOG [Unreleased] consolidation entry. DONE.

4. Tier-1 PHYSICS constants — derivation table (Stage 1)

Legend: ☐ pending · ☑ done. "Derivation" = the emergent/honest replacement.

ConstantWas→ Derivation (emergent / honest)Status
K_PHI_THRESHOLD (arith)3.227450NON-PHYSICAL (>π, unreachable) → π (or eliminate the arith-recalibrated trio)☐
PHI_S_THRESHOLD (arith)0.745219π/4 (canonical) or eliminate☐
GRAD_PHI_THRESHOLD (arith)0.259117eliminate / canonical heuristic☐
MAX_STRUCTURAL_FREQUENCY5.083204 (φπ)2π (one phase cycle, = VF_MAX)☐
MIN_STRUCTURAL_FREQUENCY0.183733 (γ/π)0.0 floor (νf=0 death) or 1/(2π) tunable☐
MATH_DELTA_NFR_THRESHOLD0.067592 (γ/(eπ))0.5 separator (prime ⟺ ΔNFR=0 exact)☐
MATH_DELTA_NFR_THRESHOLD_2X0.1351841.0 (= 2×0.5) or eliminate☐
K_TOP_FALLBACK_CANONICAL2.803171 (φ/γ)clean spectral fallback (π-fraction or 1.0)☐
K_TOP_MIN_CANONICAL0.0417741/(8π) (= KL_MIN floor)☐
K_TOP_MAX_CANONICAL0.933955π-fraction near 1 (tunable)☐
GLYPH_SELECTOR_MARGIN_CANONICAL0.041774= KL_MIN (1/(8π)) (comment already claims this)☐
AU_CURVATURE_PERMISSIVE_THRESHOLD3.025733 ((φ+1)π/e)0.96·π (permissiveK_φ
CRITICAL_EXPONENT0.183733 (γ/π)honest heuristic regime scale (decouple from GRAD_PHI)☐
GRAD_PHI_CANONICAL_THRESHOLD0.183733 (γ/π)heuristic∇φ
INTEGRATORS_EPI_MARGIN_CANONICAL

Each row: verify consumers + run the suite for the affected group before moving on. Some thresholds are consumed in tests that pin the old value — update those tests to the new emergent value (documenting the structural rationale).

5. Tier-2 engine knobs — bulk rule (Stage 2)

For every Category-C constant (OPT_ORCH_, PATTERN_, FFT_, PATTERNS_, SELF_OPT_, MULTIMODAL_, CACHE_OPT_, INTEGRATION_, NODAL_OPT_, STRUCT_CACHE_, CYCLE_* frozen, ALGEBRA_, EMERGENT_, OPERATORS_PATTERN_, SDK_, MEDICAL_, BUSINESS_, VIZ_, UTILS_ frozen, EXAMPLE_, BENCH_, THERAP_, CLI_, SCRIPT_, TOOL_, MIN_BUSINESS_COHERENCE):

  • Replace the frozen φ/γ/e decimal with a plain round operational value that preserves the intended magnitude (e.g. 2.803171 → 2.8, 0.737061 → 0.75, 0.618034 → 0.6, 8.539734 → 8.5), keeping the # operational tuning (not TNFR physics) label. Drop the false precision.
  • Where a knob is already = π or = UM_COMPAT_THRESHOLD etc., keep it.
  • Eliminate dead/duplicate aliases and empty registry plumbing.
  • Consider relocating domain-application constants (MEDICAL_/BUSINESS_/ EXAMPLE_/THERAP_/CLI_/SCRIPT_/TOOL_/VIZ_) out of constants/canonical.py into their own modules — they are not TNFR canon. (Decide with user.)

6. Status log

  • 2026-06-27 — Stage 0 complete: full canonical.py inventory (~300 constants), categorized; this tracker created. Beginning Stage 1 (Tier-1 physics).
  • 2026-06-27 — Stage 1 COMPLETE (suite green 2201 passed / 0 failed, twice):
    • π-derived: MAX_STRUCTURAL_FREQUENCY=2π, MIN_STRUCTURAL_FREQUENCY=1/(2π), AU_CURVATURE_PERMISSIVE=0.96π, GLYPH_SELECTOR_MARGIN=1/(8π), CRITICAL_EXPONENT=π/16, GRAD_PHI_CANONICAL_THRESHOLD=π/16, DYNAMICS_SI_HI=π/(π+1), K_TOP_MIN=1/(8π), K_TOP_MAX=1.0, K_TOP_FALLBACK=π.
    • Genuine emergent derivation: MATH_DELTA_NFR_THRESHOLD=0.5 (the unit-gap midpoint — prime ⟺ ΔNFR=0 exactly, every composite ΔNFR>1, from the unit-coeff arithmetic ΔNFR formula ζ(ω−1)+η(τ−2)+θ(σ/n−(1+1/n))); _2X=2×base=1.0.
    • Clean free-params (tunable): INTEGRATORS_* (0.1/0.1/−0.15/0.75/0.5), FEEDBACK_* (0.15/0.1/1/3; DNFR auto), DYNAMICS_ADELIC_* (0.1, 1/16), MATH_COHERENCE_MIN=0.1, MATH_TOLERANCE=1e4 (→PRECISION=100), PHYSICS_HOTSPOT_FRACTION=0.1, CONFIG_* (0.5/0.15/0.5/0.5/0.1).
    • Eliminated vestigial arith trio (PHI_S_THRESHOLD/GRAD_PHI_THRESHOLD/ K_PHI_THRESHOLD; the last was 3.2275 > π — non-physical/unreachable).
    • No tests pinned values (verified via consumer map); CRITICAL_EXPONENT's zeta-bridge test is self-consistent. Stale theory/TNFR_NUMBER_THEORY.md table (lines ~311-313) referencing the removed arith trio → fix in Stage 4.
  • Beginning Stage 2 (Tier-2 engine knobs, ~200 frozen φ/γ/e decimals).
  • 2026-06-27 — Stage 2 value-cleanup COMPLETE (suite green 2201 / 0 failed): 180 frozen φ/γ/e engine-knob decimals rounded to clean ≤2-decimal operational values (e.g. 2.803171→2.8, 0.737061→0.74, 0.618034→0.62, 0.098503→0.1, −0.155215→−0.16, 8.539734→8.5). 3 tiny measured values (1.8e-05, 0.00147, 0.001352) correctly left. Aliases auto-followed their rounded bases. ZERO test changes needed. Remaining: Stage 2b relocation (domain constants — needs user decision), Stage 3 (inline magic numbers in modules), Stage 4 (doc reinterpretation incl. the stale TNFR_NUMBER_THEORY arith-trio table).
  • 2026-06-27 — Stage 2b COMPLETE (suite green 2201 / 0 failed): domain constants were all DEAD (no imports anywhere) → eliminated MEDICAL_/BUSINESS_/ VIZ_/EXAMPLE_/BENCH_/THERAP_/CLI_/SCRIPT_/TOOL_/UTILS_ (~45 constants) + the dead registry and PHASE_8/9 dicts. (used only by sdk/builders.py) relocated into that module as plain locals; 4 unused SDK_ dropped. canonical.py ~770 → ~565 lines. Beginning Stage 3 (inline magic numbers in physics/dynamics/operators/metrics modules).
0.098503
0.1 (tunable margin)
☐
INTEGRATORS_J_PHI_SCALE_CANONICAL0.0985030.1 (tunable scale)☐
INTEGRATORS_SYNTHETIC_DIV_CANONICAL-0.155215clean (−1/(2π) or −0.15)☐
INTEGRATORS_FLUX_FALLBACK_CANONICAL0.737061UM_COMPAT = π/(π+1)☐
INTEGRATORS_SIGMOID_OFFSET_CANONICAL0.6180340.5 (unit midpoint)☐
FEEDBACK_COHERENCE_TOL_LOW0.139370.15 (tunable)☐
FEEDBACK_COHERENCE_TOL_HIGH0.0985030.1 (tunable)☐
FEEDBACK_EPI_THRESHOLD0.3303651/3 (tunable)☐
DYNAMICS_ADELIC_DRIFT_CANONICAL0.0985030.1☐
DYNAMICS_ADELIC_DT_STEP_CANONICAL0.041774DT_MIN = 1/16☐
DYNAMICS_SI_HI_THRESHOLD_CANONICAL0.618034π/(π+1) high-coherence (or 0.75 tunable)☐
MATH_COHERENCE_MIN_CANONICAL0.0985030.1☐
MATH_TOLERANCE_CANONICAL8539.734223honest tolerance (verify usage; likely a large cap)☐
PHYSICS_HOTSPOT_FRACTION_CANONICAL0.0985030.1☐
CONFIG_INIT_VF_MEAN / VF_STD / EPI_LATENT_MAX / VF_BASAL / EPSILON_MINvariousclean (0.5 / 0.15 / 0.5 / 0.5 / 0.1)☐
PHYSICS_*_DEPENDENCY (N_NODES/K_DEGREE/P_REWIRE/EXPECTED_CORR)variousreclassify → Tier-2 (empirical fits, not nodal physics)☐
CANONICAL_CONSTANTS
SDK_*
  • 2026-06-27 — Stage 3 COMPLETE (suite green 2201 / 0 failed): core modules were ~95% clean. Fixed residual artifacts: operators/__init__.py gains 0.9015/1.0676 → canonical SHA_VF_FACTOR/NUL_SCALE_FACTOR/VAL_SCALE_FACTOR; bifurcation.py vf/2.71828(e)→vf/2.0, epi/0.922442→epi/0.9, weights →0.46/0.26/0.14; cycle_detection.py 0.098503/0.167944→0.1/0.17; variational.py 16.18034(10·φ)→16.0; signatures.py Au drift 2.19525→0.7·π. Beginning Stage 4 (doc reinterpretation).
  • 2026-06-27 — Stage 4 COMPLETE / AUDIT CLOSED (suite green 2201 / 0 failed): rewrote theory/TNFR_NUMBER_THEORY.md §7.5 to the canonical π-derived tetrad thresholds (dropping the removed arith trio incl. the non-physical 3.2275); added the emergent-canon consolidation entry to CHANGELOG.md [Unreleased]. The engine's canonical base is now fully emergent (π / spectral / nodal) or honest free-parameters. Out of scope (flagged): the auxiliary primality-test/ and factorization-lab/ subprojects keep their own constants (some still reference φ/γ/e) — separate from the engine. Commit/push held pending user confirmation.
  • 2026-06-27 — Stage 5: THIRD AUDIT (errors / contradictions / redundancies / synergies; suite green 2201 / 0 failed). Found + fixed:
    • Contradiction (frequency bounds defined 4 ways): canonical's MIN/MAX_STRUCTURAL_FREQUENCY (2π, 1/(2π)) duplicated VF_MIN/VF_MAX and were misused in lifecycle.py as the mutation_dnfr ΔNFR threshold. Removed the pair; lifecycle.mutation_dnfr → plain 5.0 (½ collapse). (unified_numerical / validation keep a labeled loose practical [0, 1000] range, superseded by the 2π dynamics clamp — left as-is.)
    • Error (K_TOP fallback outside its own clamp): K_TOP_FALLBACK was π (3.14) but the clamp is [1/(8π), 1.0], so topology.py returned π unclamped in one path and 1.0 in another. Fixed: K_TOP_FALLBACK = K_TOP_MAX = 1.0 (consistent).
    • Stale comments (value ≠ comment): REMESH_SIMILARITY/FEEDBACK_TARGET ≈0.7371→0.7616; PHASE_GRADIENT_THRESHOLD ≈0.1837→0.196; MATH_PRECISION ≈85.4→100; defaults_core VF_MAX ≈5.0832→2π; the tetrad "three of four first-principles" header (Φ_s/K_φ are π-derived, |∇φ| is heuristic).
    • Example artifact: examples/.../97_goldbach hardcoded DELTA_PHI_MAX=0.1837 (=γ/π, also a naming error — canonical Δφ_max is π/2) → PHASE_MATCH_THRESHOLD=0.2.
    • Synergy (redundancy consolidation): introduced the single-sourced coherence band FRAGMENTATION_THRESHOLD = 1/(π+1) and HIGH_COHERENCE_THRESHOLD = π/(π+1); the six members of the 1/(π+1) / π/(π+1) families now reference them.
    • Flagged (not changed): ~120 operational engine knobs (CACHE_OPT_/INTEGRATION_/ SELF_OPT_/OPT_ORCH_/PATTERNS_/NODAL_OPT_/etc.) still live in canonical.py — they are engine-used (can't eliminate) but are NOT TNFR physics; relocating them to their consuming modules (like SDK) is the next optimization. The 0.1 value recurs ~18× as an operational neutral default (independent tunables — fine).
  • 2026-06-27 — Stage 6: OPERATIONAL-KNOB RELOCATION (suite green 2201 / 0 failed). Acted on the Stage-5 flag: split the ~150 operational engine-tuning knobs out of canonical.py into a new dedicated module src/tnfr/constants/operational.py (explicitly "engine tuning, NOT physics"; imports only PI from canonical — one-way dependency, canonical never imports operational). A parallel engines/constants/operational.py star-shim mirrors the existing canonical shim. Result: canonical.py 239 → 89 numeric constants (pure structural / physics); operational.py holds the 150 moved knobs; union reproduces the original snapshot exactly (0 leaks, 0 drift, verified via a name→value golden snapshot before/after). Families moved: OPT_ORCH_, MULTIMODAL_CACHE_, FFT_ (cutoffs/importance/engine/coordination), ARITHMETIC_FFT_, PATTERNS_, SELF_OPT_, EMERGENT_ (centralization), CACHE_OPT_, UNIFIED_CACHE_, INTEGRATION_, NODAL_OPT_, STRUCT_CACHE_, CYCLE_ (balance/fallback/min-health), PATTERN_WEIGHT, ALGEBRATOLERANCE, PHYSICS* (network-study), OPERATORS_* (pattern scoring), MIN_BUSINESS_COHERENCE. Kept in canonical (structural): the π-derived aliases PHYSICS_GRAD_THRESHOLD (π/16) / PHYSICS_CURVATURE_HOTSPOT (0.9π) / PHYSICS_HOTSPOT_FRACTION, CYCLE_OPTIMAL_BALANCE (1/(π+1)), THERAPEUTIC_EXCELLENT (sin π/3), INTEGRATORS_, FEEDBACK_, tetrad/phase/VF/EPI/KL/ DT bounds, operator gains. 26 consumers redirected (canonical→operational), mixed files split to preserve their structural imports (PI, CYCLE_OPTIMAL_BALANCE, tetrad aliases); backend_config.py and physics/interactions.py unchanged (they use only kept structural aliases). Bonus: consolidating the "one-import-per-block" style dropped dozens of now-wrong π/e / 4·φ²/π² era comments.
  • 2026-06-27 — Stage 7: THIRD DEEP AUDIT (frozen φ/γ/e residue + internal coherence; suite green 2201 / 0 failed). Method: diffed the committed pre-purge HEAD canonical.py (still φ/γ/e) against current to find values the purge froze (replaced a φ/γ/e expression with its evaluated decimal, mislabeled "tunable") and stale comments citing the old value. Findings + fixes:
    • Coherence violation (load-bearing) — NUL densification: canonical.py states NUL_DENSIFICATION_FACTOR = 1/λ ≈ 1.111 ("DERIVED, conserves the nodal-equation product νf·ΔNFR"), but operators/__init__.py hardcoded densification_default = 1.35 ("extra amplification beyond 1/λ") citing the stale 0.9015. Reconciled the operator to the canonical 1/λ and fixed the contradictory comment.
    • Frozen transcendentals → clean free values: FEEDBACK_LEARNING_RATE 0.043 (=e^(−π)) → 0.05; FEEDBACK_TAU_ADAPTIVE 0.155 (=γ/(π+γ)) → 0.15; AU_CURVATURE_PERMISSIVE 0.96·π (0.96=(φ+1)/e) → 0.95·π; STRESS_NORM 0.0985 (=γ/(π+e)) → 0.1; unified_numerical MIN_BUSINESS_COHERENCE 0.750575 (=(e·φ)/(π+e)) → 0.75 and PHASE_GRADIENT_STABILITY 0.183733 (=γ/π) → π/16; six RemeshDefaults/GLYPH_THRESHOLDS/SELECTOR_WEIGHTS round(0.92.., 3) frozen round-of-literal artifacts → plain decimals; the misleading _EXP_NEG_PI alias → _FEEDBACK_LR; the (e*phi)/(pi+e) strong-coherence formula in SDK docstrings removed.
    • De-obfuscation: STRUCTURAL_ESCAPE = math.exp(LN_2) → plain 2.0 (= EPI span).
    • VAL_MIN_EPI precondition fallback 0.2 → the canonical 1/(2π).
    • ~55 stale comments citing old φ/γ/e values updated to the current value across defaults_core, bifurcation (code/doc contradiction: docstring still said "νf/e", "EPI/0.922", old %), patterns, physics (interactions, signatures, phase_transition, canonical, integrity, calibration), riemann/zeta_bridge, telemetry, grammar, and the FFT/cache operational modules; the most pervasive was ≈ 0.1837 (γ/π) → ≈ 0.196 (π/16, ×~16).
    • Confirmed NOT used as an exponent: CRITICAL_EXPONENT (π/16) is a heuristic reference scale (function arg / spectral buffer), never x ** CRITICAL_EXPONENT.
    • Legitimately kept: the riemann/ golden-ratio / Euler-Mascheroni / Napier values are explicitly labeled non-resonant probe frequencies ("NOT TNFR structural scales"), the correct use of those numbers as negative controls.
    • Flagged (user decision): AGENTS.md §7 cites strong-coherence cut C > 0.7506 (= frozen (e·φ)/(π+e)); code now uses the clean operational 0.75. Recommend updating AGENTS.md to 0.75, or promoting the cut to the canonical band gate π/(π+1) ≈ 0.7616. Also PHI_S_GOLDEN_THRESHOLD (riemann alias for π/2) is a misnomer (no longer "golden").
  • 2026-06-27 — Stage 8: DOCUMENTATION → EMERGENT CANONICITY (suite green 2201 / 0 failed). Resolved the Stage-7 flag by promoting the documented values to the genuinely-emergent π-derived ones across AGENTS.md + the .github/agents/my-agent.md mirror + theory/docs/examples + code docstrings:
    • Arithmetic error fixed: π/(π+1) is 0.7585, not 0.7616 (the latter does not complement 1/(π+1)=0.2415 to 1). Corrected the comment value in canonical.py (×5) and defaults_core.py, and everywhere in the docs.
    • Strong-coherence cut → emergent band gate: 0.7506 (frozen (e·φ)/(π+e)) → π/(π+1) ≈ 0.7585. The SDK COHERENCE_STRONG was re-aliased from the operational MIN_BUSINESS_COHERENCE (0.75) to the emergent HIGH_COHERENCE_THRESHOLD = π/(π+1); MIN_BUSINESS_COHERENCE (0.75) stays the separate operational business-health knob. Fixed the now-self-contradictory CONTRIBUTING.md "correct vs arbitrary" example (it had MIN_BUSINESS_COHERENCE = the "correct" value but it now equals the "arbitrary" 0.75) → uses the emergent gate.
    • Φ_s confinement → π-derived (was φ-framed): drift Δ Φ_s < π/2 ≈ 1.571 (half phase-wrap, was φ ≈ 1.618), per-node |Φ_s| < π/4 ≈ 0.785 (quarter phase-wrap, was empirical 0.7711) — in AGENTS.md §3/§6/§7, GLOSSARY, PHYSICS_VERIFICATION (canonicity MODERATE→HIGH), physics/__init__ (+ its doctest), conservation, variational, grammar_u6, telemetry/constants, and the two physics-regime examples.
    • SPIRAL_ATTRACTORS_AND_LOGARITHMIC_DYNAMICS.md — DELETED (with its broken demo examples/02_physics_regimes/32_spiral_attractors_demo.py). It was a pre-purge φ/γ/e "four constants" thesis whose distinctive claims were false: the "golden ratio as dynamical attractor" check was circular (set b = 2·ln(φ)/π by hand, then "verified" ratios = φ), the demo imported the purged φ/γ/e constants (could not run — so §6.3 "Status: Validated" was false), and §7 ("the fourth constant γ") is pure pre-purge paradigm. The only true content (log spirals from rotation + growth, free b = νf·k/ω) is trivial and non-distinctive. References removed from theory/README.md, FUNDAMENTAL_THEORY.md, examples/README.md.
    • Verified-correct (left as-is): the website brief and several theory files (FUNDAMENTAL_THEORY, MINIMAL_STRUCTURAL_DEGREES, GLOSSARY §VON_KOCH) already document the π/2–π/4 supersession; the riemann/ probes stay.
  • 2026-06-27 — Stage 9: FULL theory/ DOC AUDIT (every theory/*.md checked for residual φ/γ/e false claims; yang_mills tests green 18/18; no engine code changed except cosmetic docstrings). Verdict: no further deletions needed — SPIRAL_ATTRACTORS (Stage 8) was the only doc whose thesis was false; all 26 remaining docs are genuinely emergent and only carried scattered stale φ/γ/e refs. Fixes applied (the code was already clean — these were doc-only, except 2 yang_mills docstrings):
    • FUNDAMENTAL_THEORY / EXTENDED_FIELDS / GAUGE_SYMMETRY / PHYSICAL_REGIME: Δ Φ_s < φ → π/2; Si < 1.5/(π+γ) → Si < 0.4; AU permissive curvature (φ+1)π/e → 0.95π; V < ½φ²·N → ½(π/2)²·N; heuristic γ/π → π/16.
    • STRUCTURAL_OPERATORS (≈23 refs): all operator-gain tables/formulas → the operational defaults_core.py values — IL φ/(φ+γ)≈0.737→0.75; OZ/NUL-dens φ/γ≈2.803→ OZ 2.0, NUL densification 1/λ≈1.111 (was wrongly 2.803); VAL 1+γ/(π·e)≈1.067→1.05; SHA/NUL scale 1−γ/(π+e)≈0.902→0.9; RA e^{−φ}≈0.198 and ZHIR φ/(e+γ)≈0.489 → labeled operational/free.
    • STRUCTURAL_CONSERVATION: IL/OZ Lyapunov proof ρ_IL 0.737→0.75, ρ_OZ 2.803→2.0 (product 1.5>1, argument preserved); |Φ_s|<φ→π/2; the full 13-operator energy table (VAL 1.05, AL 0.10, SHA 0.9, NUL-dens 1.111) + the sequence-contractiveness example (1+3.0)(1−0.438)⁴≈0.40<1.
    • STRUCTURAL_STABILITY / TNFR_VARIATIONAL_PRINCIPLE / TNFR_NUMBER_THEORY: IL/OZ rows → operational; Mutation ΔNFR φ×π≈5.083→5.0; γ_c=γ/π, noise floor, chirality → operational calibrated; |Φ_s|<φ→π/2; |∇φ| threshold γ/π→π/16; "Tetrahedral confinement" label → "U6 structural-potential confinement".
    • TNFR_YANG_MILLS (+ src/tnfr/yang_mills/structural_gap.py 2 docstrings): V_U6 "normalised by φ²" / "Φ_s²/φ²" / ρ_U6 = max|Φ_s|/φ → (π/2)² / U6_STRUCTURAL_POTENTIAL_LIMIT (the code already computed /(π/2)²; only the docstrings + note were stale).
    • CATALOG_TYPE_HYGIENE_PROGRAMME: removed the false "Universal Tetrahedral Correspondence γ ↔ |∇φ|" claim and the FUNDAMENTAL_THEORY — Universal Tetrahedral Correspondence cross-ref; stale canonical.py:506→:289.
    • TNFR_RIEMANN_RESEARCH_NOTES (20 refs — the subagent missed these): the refuted "Universal Tetrahedral Correspondence" (φ↔Φ_s, γ↔|∇φ|, π↔K_φ, e↔ξ_C) purged throughout — the explicit mapping → the minimal structural-field tetrad (only π structural); the three inter-prime kernels relabeled exploratory, not canonical; δ_coh derived from UTC → exploratory γ/π prefactor; U6 ΔΦ_s<φ→π/2; DNFR/SI weights (φ/γ/π/e-derived) → operational tunable (+ stale :57/:65/:150 line anchors → :85/:93/:186); SELECTOR_WEIGHTS {π/(π+e),1/(π+1),γ/(π+1)} → the operational {0.536, 1/(π+1)≈0.241, 0.139}; 8 narrative "nor from the Universal Tetrahedral Correspondence" tool-lists → "structural-field tetrad".
    • Confirmed clean (no changes): MINIMAL_STRUCTURAL_DEGREES, MATHEMATICAL_DYNAMICS_BASIS, GLOSSARY (§VON_KOCH deprecation honest), UNIFIED_GRAMMAR_RULES, DISSIPATIVE_AND_OPEN_SYSTEMS, EMERGENT_ONTOLOGY, REMESH_INFINITY_DERIVATION, APPLIED_STRUCTURAL_ANALYSIS, NUCLEUS_A/B, TNFR_BSD/HODGE/P_VS_NP/NAVIER_STOKES research notes (NAVIER_STOKES 2.803702 is simulation data; Riemann sin(γ_em·T) is an explicit non-resonant Euler-Mascheroni control — both legitimate). defaults_core.py/canonical.py already fully purged (weights labeled "tunable"; GAMMA/PHI/E intentionally absent).