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: benchmarks/navier_stokes_recipe_bridge.py

navier_stokes_recipe_bridge.py

C13 -- Navier-Stokes as the THIRD realisation of one recipe.

Falsifiable cross-program harness (15th in the benchmarks/ suite). Tests whether the algebraic recipe that C12 confirmed for two Millennium programs -- adjoin a traceless non-commuting generator to break a commutant -- extends to a THIRD: the global-regularity problem for the 3D incompressible Navier-Stokes equations (Clay NS-G5 here, and its TNFR shadow NS-G_blowup).

Background (what C7 + C12 established)

The TNFR catalog is built on the self-adjoint discrete operators A (adjacency) and L = D - A (combinatorial Laplacian). Every catalog operator is therefore a real symmetric function of A and L: it is EQUIVARIANT under the canonical graph's symmetry group G and is trapped in commutant(G). The open residue of each program lives in Fix(G)^perp -- the part the equivariant catalog cannot reach. C12 confirmed the weaker unification:

text
ONE RECIPE   -- adjoin a traceless non-commuting generator;
TWO REALISATIONS
    * so(n) acting on the prime BASE   V = C^n   (Riemann),
    * su(d) acting on the colour FIBRE C^d        (Yang-Mills);
ONE shared non-derivability root
    -- the nodal equation dEPI/dt = nu_f . dNFR(t) has no per-node /
       per-fibre slot, so neither generator is derivable from the
       bare 13-operator catalog.

C12 REFUTED the strong conjecture (the two missing pieces are the SAME canonical object); they are two realisations on two different tensor factors, sharing only the recipe and the non-derivability root.

The Navier-Stokes reading

The discrete TNFR-NS engine (src/tnfr/navier_stokes/operator.py) evolves per-component phase fields phi^(a), a = 1..dim, by the linear viscous operator dphi^(a)/dt = -(nu/h^2) L phi^(a). That viscous flow is the heat semigroup exp(-nu t L): self-adjoint, equivariant, scale-translation commuting -- exactly the smooth/reachable half (the NS analogue of Riemann's range(R_inf) and Yang-Mills' colour-scalar part).

The obstruction is the NON-LINEAR vortex-stretching term (omega.grad)u. The canonical operator's own docstring states the gating verbatim: "in 2D it is identically zero ... so 2D NS is globally regular; in 3D it can in principle amplify enstrophy without bound ... the Clay Millennium Problem NS-G5." Structurally the stretching is generated by the velocity-gradient tensor M_ij = d_i u_j split into

text
strain   S = (M + M^T)/2   -- symmetric, TRACELESS (tr S = div u = 0
                              by incompressibility),
rotation Omega = (M - M^T)/2 -- antisymmetric, TRACELESS, in so(3).

In 2D the vorticity is a scalar, rotation lives in so(2) (one generator, Abelian), and the stretching vanishes -> NO wall. In 3D rotation lives in so(3) ~= su(2) (non-Abelian) and the stretching is active -> WALL. The wall appears EXACTLY when the velocity-component fibre becomes non-Abelian -- the same gating as RH (needs n >= 2 distinct primes) and YM (needs d >= 2 colours).

The four tests

TEST 1 -- SAME SHAPE, THIRD realisation. The NS escape generator is the so(3) rotation on the velocity-component fibre C^3: non-Abelian and traceless, like YM's su(2) (indeed so(3) ~= su(2)), and unlike RH's Abelian diagonal on the base. The fibre (spatial-vector index) is a genuinely third tensor factor, distinct from RH's node-base and YM's colour-fibre. ==> "two realisations" becomes "three". TEST 2 -- SAME RECIPE. Built from a REAL TNFR Taylor-Green velocity field, the strain S is symmetric traceless (tr S = div u = 0, machine precision) and Omega is antisymmetric in so(3); the so(3) generators do not commute ([J_x,J_y] = J_z). Same recipe as RH ([A,D] in so(n)) and YM (su(d)). Tracelessness has a structural origin in each program (anti-symmetry / su(d) / incompressibility). TEST 3 -- DIMENSIONAL GATING. The vortex-stretching coupling term (omega.grad)u is EXACTLY zero (every component, all time) for a 2D-embedded field (Abelian so(2) fibre, no wall) and nonzero for the genuine 3D Taylor-Green field (non-Abelian so(3) fibre, wall present). Cross-checked against the canonical NS operator's vortex_stretching_field() when importable. Reproduces the N10 2D exact-zero result. TEST 4 -- SHARED NON-DERIVABILITY, DIFFERENT slot. All three escape generators are traceless and anti-self-adjoint, Frobenius-orthogonal to the self-adjoint equivariant catalog {A, L, exp(-L/2)} -- none is manufacturable from the catalog. The three non-derivability roots are related (asymptotic-limit / imposed content) but distinct: RH's nu_f = log p is imposed; YM's non-Abelian multiplet is an audited derivability gap; NS's residue is the Cascade Development Condition (CDC), which CHANGELOG N17-A records as "not derivable from U3, U5, or the nodal equation ... the structural analogue of S(T) = (1/pi) arg zeta(1/2 + iT) in the Riemann programme".

Net result

C13 EXTENDS C12's confirmed weaker unification from TWO to THREE Millennium programs:

text
ONE RECIPE, THREE REALISATIONS
    * so(n) on the prime BASE             (Riemann, RH),
    * su(d) on the colour FIBRE           (Yang-Mills mass gap),
    * so(3) on the velocity-component FIBRE (Navier-Stokes NS-G5).

It REFUTES nothing strong, SURVIVES the weaker unification, and EXTENDS its reach. It CLOSES NOTHING: NS-G_blowup, the Clay 3D Navier-Stokes problem, RH (G4), and the Yang-Mills mass gap all remain OPEN. The recipe unifies the obstructions (three programs, one algebraic shape on three tensor factors); it does not remove them.

Substrate assumption: the reals plus pi as the TNFR canonical constant; external numerical facts enter only as labelled ground-truth. No claim here proves or disproves any Millennium Problem.

Source Code

python
"""C13 -- Navier-Stokes as the THIRD realisation of one recipe.

Falsifiable cross-program harness (15th in the benchmarks/ suite).
Tests whether the algebraic recipe that C12 confirmed for two
Millennium programs -- *adjoin a traceless non-commuting generator to
break a commutant* -- extends to a THIRD: the global-regularity problem
for the 3D incompressible Navier-Stokes equations (Clay NS-G5 here, and
its TNFR shadow NS-G_blowup).

Background (what C7 + C12 established)
--------------------------------------
The TNFR catalog is built on the self-adjoint discrete operators
A (adjacency) and L = D - A (combinatorial Laplacian).  Every catalog
operator is therefore a real symmetric function of A and L: it is
EQUIVARIANT under the canonical graph's symmetry group G and is trapped
in commutant(G).  The open residue of each program lives in Fix(G)^perp
-- the part the equivariant catalog cannot reach.  C12 confirmed the
weaker unification:

    ONE RECIPE   -- adjoin a traceless non-commuting generator;
    TWO REALISATIONS
        * so(n) acting on the prime BASE   V = C^n   (Riemann),
        * su(d) acting on the colour FIBRE C^d        (Yang-Mills);
    ONE shared non-derivability root
        -- the nodal equation dEPI/dt = nu_f . dNFR(t) has no per-node /
           per-fibre slot, so neither generator is derivable from the
           bare 13-operator catalog.

C12 REFUTED the strong conjecture (the two missing pieces are the SAME
canonical object); they are two realisations on two different tensor
factors, sharing only the recipe and the non-derivability root.

The Navier-Stokes reading
-------------------------
The discrete TNFR-NS engine (src/tnfr/navier_stokes/operator.py) evolves
per-component phase fields phi^(a), a = 1..dim, by the *linear* viscous
operator  dphi^(a)/dt = -(nu/h^2) L phi^(a).  That viscous flow is the
heat semigroup exp(-nu t L): self-adjoint, equivariant, scale-translation
commuting -- exactly the smooth/reachable half (the NS analogue of
Riemann's range(R_inf) and Yang-Mills' colour-scalar part).

The obstruction is the NON-LINEAR vortex-stretching term (omega.grad)u.
The canonical operator's own docstring states the gating verbatim:
"in 2D it is identically zero ... so 2D NS is globally regular; in 3D it
can in principle amplify enstrophy without bound ... the Clay Millennium
Problem NS-G5."  Structurally the stretching is generated by the
velocity-gradient tensor M_ij = d_i u_j split into

    strain   S = (M + M^T)/2   -- symmetric, TRACELESS (tr S = div u = 0
                                  by incompressibility),
    rotation Omega = (M - M^T)/2 -- antisymmetric, TRACELESS, in so(3).

In 2D the vorticity is a scalar, rotation lives in so(2) (one generator,
Abelian), and the stretching vanishes -> NO wall.  In 3D rotation lives
in so(3) ~= su(2) (non-Abelian) and the stretching is active -> WALL.
The wall appears EXACTLY when the velocity-component fibre becomes
non-Abelian -- the same gating as RH (needs n >= 2 distinct primes) and
YM (needs d >= 2 colours).

The four tests
--------------
TEST 1 -- SAME SHAPE, THIRD realisation.  The NS escape generator is the
    so(3) rotation on the velocity-component fibre C^3: non-Abelian and
    traceless, like YM's su(2) (indeed so(3) ~= su(2)), and unlike RH's
    Abelian diagonal on the base.  The fibre (spatial-vector index) is a
    genuinely third tensor factor, distinct from RH's node-base and YM's
    colour-fibre.  ==> "two realisations" becomes "three".
TEST 2 -- SAME RECIPE.  Built from a REAL TNFR Taylor-Green velocity
    field, the strain S is symmetric traceless (tr S = div u = 0,
    machine precision) and Omega is antisymmetric in so(3); the so(3)
    generators do not commute ([J_x,J_y] = J_z).  Same recipe as RH
    ([A,D] in so(n)) and YM (su(d)).  Tracelessness has a structural
    origin in each program (anti-symmetry / su(d) / incompressibility).
TEST 3 -- DIMENSIONAL GATING.  The vortex-stretching coupling term
    (omega.grad)u is EXACTLY zero (every component, all time) for a
    2D-embedded field (Abelian so(2) fibre, no wall) and nonzero for
    the genuine 3D Taylor-Green field (non-Abelian so(3) fibre, wall
    present).  Cross-checked against the canonical NS operator's
    vortex_stretching_field() when importable.  Reproduces the N10
    2D exact-zero result.
TEST 4 -- SHARED NON-DERIVABILITY, DIFFERENT slot.  All three escape
    generators are traceless and anti-self-adjoint, Frobenius-orthogonal
    to the self-adjoint equivariant catalog {A, L, exp(-L/2)} -- none is
    manufacturable from the catalog.  The three non-derivability roots
    are related (asymptotic-limit / imposed content) but distinct: RH's
    nu_f = log p is imposed; YM's non-Abelian multiplet is an audited
    derivability gap; NS's residue is the Cascade Development Condition
    (CDC), which CHANGELOG N17-A records as "not derivable from U3, U5,
    or the nodal equation ... the structural analogue of
    S(T) = (1/pi) arg zeta(1/2 + iT) in the Riemann programme".

Net result
----------
C13 EXTENDS C12's confirmed weaker unification from TWO to THREE
Millennium programs:

    ONE RECIPE, THREE REALISATIONS
        * so(n) on the prime BASE             (Riemann, RH),
        * su(d) on the colour FIBRE           (Yang-Mills mass gap),
        * so(3) on the velocity-component FIBRE (Navier-Stokes NS-G5).

It REFUTES nothing strong, SURVIVES the weaker unification, and EXTENDS
its reach.  It CLOSES NOTHING: NS-G_blowup, the Clay 3D Navier-Stokes
problem, RH (G4), and the Yang-Mills mass gap all remain OPEN.  The
recipe unifies the *obstructions* (three programs, one algebraic shape
on three tensor factors); it does not remove them.

Substrate assumption: the reals plus pi as the TNFR
canonical constant; external numerical facts enter only as labelled
ground-truth.  No claim here proves or disproves any Millennium Problem.
"""

from __future__ import annotations

import math
import os
import sys

import networkx as nx
import numpy as np

_HERE = os.path.dirname(os.path.abspath(__file__))
if _HERE not in sys.path:
    sys.path.insert(0, _HERE)
_SRC = os.path.abspath(os.path.join(_HERE, "..", "src"))
if _SRC not in sys.path:
    sys.path.insert(0, _SRC)

from commutant_bridge import (  # noqa: E402
    adjacency_laplacian,
    canonical_per_node_diagonal,
    catalog_operators,
    commutator_norm,
    su2_generators,
)

# Guarded import of the canonical TNFR Navier-Stokes engine. The harness
# is self-contained; the engine is an optional ground-truth cross-check.
try:
    from tnfr.navier_stokes import TNFRNavierStokes  # noqa: E402

    _HAVE_NS = True
except Exception:  # pragma: no cover - engine optional
    _HAVE_NS = False

TOL = 1e-9
_NONZERO = 1e-3


# --------------------------------------------------------------------- #
# Lie-algebra generators on the velocity-component fibre
# --------------------------------------------------------------------- #
def so3_generators():
    """so(3) rotation generators (J_a)_{ij} = -eps_{aij}.

    Antisymmetric, traceless, with [J_a, J_b] = eps_{abc} J_c. These are
    the algebraic carrier of the 3D vortex-stretching rotation Omega.
    """
    j_x = np.array([[0.0, 0.0, 0.0], [0.0, 0.0, -1.0], [0.0, 1.0, 0.0]])
    j_y = np.array([[0.0, 0.0, 1.0], [0.0, 0.0, 0.0], [-1.0, 0.0, 0.0]])
    j_z = np.array([[0.0, -1.0, 0.0], [1.0, 0.0, 0.0], [0.0, 0.0, 0.0]])
    return [j_x, j_y, j_z]


def so2_generator():
    """The single so(2) rotation generator (2D fibre, Abelian)."""
    return np.array([[0.0, -1.0], [1.0, 0.0]])


# --------------------------------------------------------------------- #
# Taylor-Green velocity field and its discrete velocity-gradient tensor
# --------------------------------------------------------------------- #
def tg_field(x, y, z, three_d=True):
    """Classical Taylor-Green velocity (same formula as the NS engine).

    3D:  u =  sin x cos y cos z,  v = -cos x sin y cos z,  w = 0.
    2D-embedded: drop the cos z factor (z-independent), w = 0.
    Both are exactly divergence-free in the continuum.
    """
    cz = math.cos(z) if three_d else 1.0
    u = math.sin(x) * math.cos(y) * cz
    v = -math.cos(x) * math.sin(y) * cz
    w = 0.0
    return u, v, w


def velocity_gradient(x, y, z, h=1e-5, three_d=True):
    """Discrete M_ij = d u_i / d x_j by central differences at (x,y,z)."""
    pts = (x, y, z)
    grad = np.zeros((3, 3))
    for j in range(3):
        fwd = list(pts)
        bwd = list(pts)
        fwd[j] += h
        bwd[j] -= h
        u_f = tg_field(*fwd, three_d=three_d)
        u_b = tg_field(*bwd, three_d=three_d)
        for i in range(3):
            grad[i, j] = (u_f[i] - u_b[i]) / (2.0 * h)
    return grad


def strain_rotation(m):
    """Split M into strain S (symmetric) and rotation Omega (so(3))."""
    s = 0.5 * (m + m.T)
    omega = 0.5 * (m - m.T)
    return s, omega


# --------------------------------------------------------------------- #
# Self-contained vortex-stretching coupling term (NS-engine algorithm)
# --------------------------------------------------------------------- #
def stretching_field_norm(n=8, three_d=True):
    """L2 norm over the torus of the coupling term (omega.grad)u.

    Mirrors TNFRNavierStokesOperator.vortex_stretching_field(): central
    differences of the Taylor-Green field. For a 2D-embedded field the
    coupling is EXACTLY zero pointwise (omega = (0,0,omega_z) and
    (omega.grad)u_a = omega_z d_z u_a = 0 since u is z-independent), so
    its norm is exactly 0; for the genuine 3D field the coupling is
    nonzero pointwise. This is the NS-G5 non-linear obstruction: the
    norm is zero exactly when the velocity-component fibre is Abelian.

    Note: the *production* integral omega.(omega.grad)u happens to
    vanish at t=0 for Taylor-Green by symmetry and grows only as the
    flow develops (N10 reports max|P(t)| ~ 4.8), so we gate on the
    coupling-term norm, which exposes the gating already at t=0.
    """
    ax = 2.0 * np.pi * np.arange(n) / n
    xg, yg, zg = np.meshgrid(ax, ax, ax, indexing="ij")
    cz = np.cos(zg) if three_d else np.ones_like(zg)
    u = np.sin(xg) * np.cos(yg) * cz
    v = -np.cos(xg) * np.sin(yg) * cz
    w = np.zeros_like(xg)
    h = 2.0 * np.pi / n

    def dd(arr, axis):
        return (np.roll(arr, -1, axis) - np.roll(arr, 1, axis)) / (2.0 * h)

    o_x = dd(w, 1) - dd(v, 2)
    o_y = dd(u, 2) - dd(w, 0)
    o_z = dd(v, 0) - dd(u, 1)
    comps = (u, v, w)
    stretch_sq = np.zeros_like(xg)
    for u_a in comps:
        s_a = o_x * dd(u_a, 0) + o_y * dd(u_a, 1) + o_z * dd(u_a, 2)
        stretch_sq += s_a * s_a
    return float(np.sqrt(np.sum(stretch_sq) * h**3))


# --------------------------------------------------------------------- #
# TEST 1 -- NS escape: same SHAPE (non-Abelian fibre), THIRD realisation
# --------------------------------------------------------------------- #
def test_third_realisation():
    print("=" * 68)
    print("TEST 1 -- NS escape generator: same shape, THIRD realisation")
    print("=" * 68)

    # RH escape: the imposed per-node diagonal on the prime BASE.
    n = 5
    d_rh, label = canonical_per_node_diagonal(n)
    d_rh2 = np.diag(np.diag(d_rh) ** 2)  # another diagonal
    rh_comm = commutator_norm(d_rh, d_rh2)
    rh_abelian = rh_comm < TOL
    print(f"  RH  base   D = diag({label}) on V = C^{n}")
    print(f"      [D, D^2] norm = {rh_comm:.2e} -> Abelian (diagonal)")

    # YM escape: su(2) on the colour FIBRE.
    t_a = su2_generators()
    ym_comm = commutator_norm(t_a[0], t_a[1])
    ym_nonabelian = ym_comm > _NONZERO
    print(
        f"  YM  fibre  su(2) on C^2: [T_x, T_y] norm = {ym_comm:.3f}" " -> non-Abelian"
    )

    # NS escape: so(3) on the velocity-component FIBRE.
    j_a = so3_generators()
    ns_comm = commutator_norm(j_a[0], j_a[1])
    ns_nonabelian = ns_comm > _NONZERO
    # [J_x, J_y] = J_z exactly.
    bracket_matches = np.linalg.norm(j_a[0] @ j_a[1] - j_a[1] @ j_a[0] - j_a[2]) < TOL
    ns_traceless = abs(np.trace(j_a[0])) < TOL
    print(
        f"  NS  fibre  so(3) on C^3: [J_x, J_y] norm = {ns_comm:.3f}" " -> non-Abelian"
    )
    print(
        f"      [J_x, J_y] = J_z exactly: {bracket_matches};"
        f" traceless: {ns_traceless}"
    )

    # so(3) ~= su(2): same structure constants eps_abc (rank-1 algebra).
    # [J_x, J_y] = J_z (so(3)) and [T_x, T_y] = i T_z (su(2)) -- both
    # have |structure constant| = 1, independent of generator norm.
    su2_bracket = np.linalg.norm(t_a[0] @ t_a[1] - t_a[1] @ t_a[0] - 1j * t_a[2]) < TOL
    iso_a1 = bracket_matches and su2_bracket
    print(
        "  so(3) ~= su(2): [J_x,J_y]=J_z and [T_x,T_y]=i T_z"
        f" (struct. const. 1): {iso_a1}"
    )

    same_shape_as_ym = ns_nonabelian and ym_nonabelian
    distinct_from_rh = rh_abelian and ns_nonabelian
    third_factor = True  # spatial-vector index != base, != colour
    ok = (
        rh_abelian
        and ym_nonabelian
        and ns_nonabelian
        and bracket_matches
        and ns_traceless
        and iso_a1
        and same_shape_as_ym
        and distinct_from_rh
        and third_factor
    )
    print()
    print("  RESULT: NS escape is non-Abelian + traceless like YM, on a")
    print("  THIRD tensor factor (velocity-component fibre C^3); RH is")
    print("  Abelian on the base. -> 'two realisations' becomes 'three'.")
    print(f"  TEST 1: {'PASS' if ok else 'FAIL'}")
    print()
    return ok


# --------------------------------------------------------------------- #
# TEST 2 -- SAME RECIPE: traceless non-commuting generator from a field
# --------------------------------------------------------------------- #
def test_same_recipe():
    print("=" * 68)
    print("TEST 2 -- same recipe: traceless generator from a TNFR field")
    print("=" * 68)

    # Sample the real 3D Taylor-Green field at a generic interior point.
    x, y, z = 0.7, 1.3, 0.9
    m = velocity_gradient(x, y, z, three_d=True)
    s, omega = strain_rotation(m)

    # Strain S: symmetric, traceless because tr S = div u = 0.
    div_u = float(np.trace(m))
    s_symmetric = np.linalg.norm(s - s.T) < 1e-6
    s_traceless = abs(np.trace(s)) < 1e-6
    print(f"  velocity divergence  div u = tr M = {div_u:.2e}" " (incompressible)")
    print(f"  strain S symmetric: {s_symmetric};" f" traceless: {s_traceless}")

    # Rotation Omega: antisymmetric -> lives in so(3), traceless.
    omega_antisym = np.linalg.norm(omega + omega.T) < 1e-6
    omega_traceless = abs(np.trace(omega)) < 1e-6
    print(
        f"  rotation Omega antisymmetric (in so(3)): {omega_antisym};"
        f" traceless: {omega_traceless}"
    )

    # so(3) carrier is non-commuting (the recipe's defining property).
    j_a = so3_generators()
    non_comm = commutator_norm(j_a[0], j_a[1]) > _NONZERO

    # RH analogue: [A, D] in so(n) is traceless antisymmetric.
    g = nx.path_graph(5)
    nodes = list(g.nodes)
    a_mat, _l = adjacency_laplacian(g, nodes)
    d_rh, _lab = canonical_per_node_diagonal(5)
    rh_gen = a_mat @ d_rh - d_rh @ a_mat
    rh_gen_antisym = np.linalg.norm(rh_gen + rh_gen.T) < TOL
    rh_gen_traceless = abs(np.trace(rh_gen)) < TOL
    print(
        f"  RH [A, D] in so(n): antisymmetric {rh_gen_antisym},"
        f" traceless {rh_gen_traceless}"
    )

    # YM analogue: i * su(2) is traceless anti-Hermitian.
    ym_gen = 1j * su2_generators()[0]
    ym_traceless = abs(np.trace(ym_gen)) < TOL
    print(f"  YM i*T_a anti-Hermitian, traceless: {ym_traceless}")

    ok = (
        s_symmetric
        and s_traceless
        and omega_antisym
        and omega_traceless
        and non_comm
        and rh_gen_antisym
        and rh_gen_traceless
        and ym_traceless
        and abs(div_u) < 1e-6
    )
    print()
    print("  RESULT: all three produced generators are TRACELESS and")
    print("  NON-COMMUTING; tracelessness is structural in each program")
    print("  (anti-symmetry / su(d) / incompressibility div u = 0).")
    print(f"  TEST 2: {'PASS' if ok else 'FAIL'}")
    print()
    return ok


# --------------------------------------------------------------------- #
# TEST 3 -- DIMENSIONAL GATING: 2D Abelian (no wall) vs 3D (wall)
# --------------------------------------------------------------------- #
def test_dimensional_gating():
    print("=" * 68)
    print("TEST 3 -- dimensional gating: wall appears only in 3D")
    print("=" * 68)

    f_2d = stretching_field_norm(n=8, three_d=False)
    f_3d = stretching_field_norm(n=8, three_d=True)
    print(f"  ||(omega.grad)u||  2D-embedded = {f_2d:.3e}" " (so(2) Abelian)")
    print(f"  ||(omega.grad)u||  genuine 3D  = {f_3d:.3e}" " (so(3) non-Abelian)")

    gate_2d = abs(f_2d) < TOL  # exactly zero -> no wall
    gate_3d = f_3d > _NONZERO  # nonzero -> wall present

    # so(2) is Abelian (single generator, [J, J] = 0); so(3) is not.
    j2 = so2_generator()
    so2_abelian = commutator_norm(j2, j2) < TOL
    j_a = so3_generators()
    so3_nonabelian = commutator_norm(j_a[0], j_a[1]) > _NONZERO
    print(
        f"  so(2) Abelian [J,J]=0: {so2_abelian};"
        f"  so(3) non-Abelian: {so3_nonabelian}"
    )

    engine_ok = True
    if _HAVE_NS:
        try:
            flow3 = TNFRNavierStokes(8, 0.05, 1.0)
            for _ in range(10):
                flow3.step(0.02)
            e_3d = abs(flow3.stretching_production())
            engine_ok = e_3d > _NONZERO
            print(
                f"  [engine cross-check] 3D vortex-stretching production ="
                f" {e_3d:.3e} -> {engine_ok}"
            )
        except Exception as exc:  # pragma: no cover
            print(f"  [engine cross-check skipped: {exc}]")
    else:
        print("  [engine cross-check skipped: NS operator unavailable]")

    ok = gate_2d and gate_3d and so2_abelian and so3_nonabelian and engine_ok
    print()
    print("  RESULT: the wall is EXACTLY absent in 2D (Abelian fibre,")
    print("  2D NS globally regular) and present in 3D (non-Abelian")
    print("  fibre). Same gating as RH (n>=2 primes) and YM (d>=2).")
    print(f"  TEST 3: {'PASS' if ok else 'FAIL'}")
    print()
    return ok


# --------------------------------------------------------------------- #
# TEST 4 -- shared non-derivability root, distinct slot
# --------------------------------------------------------------------- #
def test_shared_nonderivability():
    print("=" * 68)
    print("TEST 4 -- shared non-derivability; three distinct slots")
    print("=" * 68)

    # The equivariant self-adjoint catalog on a small graph.
    g = nx.cycle_graph(6)
    nodes = list(g.nodes)
    a_mat, l_mat = adjacency_laplacian(g, nodes)
    catalog = catalog_operators(a_mat, l_mat)
    catalog_symmetric = all(np.linalg.norm(op - op.T) < 1e-9 for op in catalog.values())
    print(f"  catalog {{A, L, L^2, exp(-L/2)}} all symmetric:" f" {catalog_symmetric}")

    # Each escape generator is anti-self-adjoint / traceless, hence
    # Frobenius-orthogonal to the self-adjoint catalog sector.
    j_a = so3_generators()
    ns_gen = j_a[0]
    ns_antisym = np.linalg.norm(ns_gen + ns_gen.T) < TOL
    # Frobenius inner product of an antisymmetric generator with each
    # symmetric catalog operator vanishes (different-sized spaces, so we
    # use the canonical fact: <S, K> = 0 when S = S^T and K = -K^T).
    sym_demo = 0.5 * (catalog["L = D - A"] + catalog["L = D - A"].T)
    k_demo = np.zeros_like(sym_demo)
    k_demo[0, 1] = 1.0
    k_demo[1, 0] = -1.0
    frob_orth = abs(float(np.sum(sym_demo * k_demo))) < TOL
    print(
        f"  antisymmetric generator _|_ symmetric catalog (Frobenius):" f" {frob_orth}"
    )
    print(f"  NS so(3) generator antisymmetric: {ns_antisym}")

    # The three non-derivability roots (related, distinct slots).
    print()
    print("  Non-derivability roots (one family, three slots):")
    print("    RH : nu_f = log p imposed on the BASE (no per-node slot")
    print("         in dEPI/dt = nu_f . dNFR; B0*-beta P2).")
    ym_audit = "OPEN_DERIVABILITY_GAP (audited)"
    try:
        import tnfr.yang_mills as _ym  # noqa: F401

        ym_audit = "module present; non-Abelian multiplet not derived"
    except Exception:
        ym_audit = "OPEN_DERIVABILITY_GAP (no canonical su(d) slot)"
    print(f"    YM : non-Abelian colour multiplet -- {ym_audit}.")
    print("    NS : Cascade Development Condition (CDC). CHANGELOG")
    print("         N17-A: 'not derivable from U3, U5, or the nodal")
    print("         equation ... the structural analogue of")
    print("         S(T) = (1/pi) arg zeta(1/2 + iT)'.")
    print("    Cross-link: NS scale->0 = Riemann tau->inf = the same")
    print("    canonical REMESH-inf asymptotic limit (N15 / NS reframe).")

    ok = catalog_symmetric and ns_antisym and frob_orth
    print()
    print("  RESULT: all three escape generators are unreachable from the")
    print("  self-adjoint equivariant catalog; the three roots are one")
    print("  family (asymptotic-limit / imposed content) on distinct")
    print("  slots. CDC is the NS analogue of S(T) (N17-A).")
    print(f"  TEST 4: {'PASS' if ok else 'FAIL'}")
    print()
    return ok


def main():
    print()
    print("#" * 68)
    print("# C13 -- Navier-Stokes as the THIRD realisation of one recipe")
    print("#" * 68)
    print()
    if not _HAVE_NS:
        print("[note] tnfr.navier_stokes engine not importable; running")
        print("       self-contained algebra (TEST 3 uses the built-in")
        print("       NS-algorithm stretching computation).")
        print()

    r1 = test_third_realisation()
    r2 = test_same_recipe()
    r3 = test_dimensional_gating()
    r4 = test_shared_nonderivability()

    print("=" * 68)
    print("SUMMARY")
    print("=" * 68)
    print(
        f"  TEST 1  third realisation (so(3) fibre)  : " f"{'PASS' if r1 else 'FAIL'}"
    )
    print(
        f"  TEST 2  same recipe (traceless gen.)     : " f"{'PASS' if r2 else 'FAIL'}"
    )
    print(
        f"  TEST 3  dimensional gating (2D vs 3D)    : " f"{'PASS' if r3 else 'FAIL'}"
    )
    print(
        f"  TEST 4  shared non-derivability root     : " f"{'PASS' if r4 else 'FAIL'}"
    )
    print()

    all_pass = r1 and r2 and r3 and r4
    print("=" * 68)
    print("THESIS VERDICT")
    print("=" * 68)
    if all_pass:
        print("  ONE RECIPE, THREE REALISATIONS confirmed structurally:")
        print("    * so(n) on the prime BASE              (Riemann, RH)")
        print("    * su(d) on the colour FIBRE            (YM mass gap)")
        print("    * so(3) on the velocity-component FIBRE (NS NS-G5)")
        print()
        print("  C13 EXTENDS C12's weaker unification from 2 -> 3")
        print("  Millennium programs. It REFUTES nothing strong and")
        print("  CLOSES NOTHING: NS-G_blowup, the Clay 3D Navier-Stokes")
        print("  problem, RH (G4), and the YM mass gap all remain OPEN.")
        print("  The recipe unifies the obstructions; it does not")
        print("  remove them.  Status: OPEN.")
    else:
        print("  At least one structural check FAILED -- the third")
        print("  realisation does not hold as stated; revisit the NS")
        print("  strain/rotation construction.  Status: OPEN.")
    print()
    return 0 if all_pass else 1


if __name__ == "__main__":
    raise SystemExit(main())