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/remesh_infinity_riemann_spectral_basis.py

remesh_infinity_riemann_spectral_basis.py

R-inf-1b: Spectrum of T_spec = S_IL^spec . M_REMESH on the P14 internal Hilbert space {|p,k>} vs the GUE Wigner surmise.

Pre-registered milestone (§13vicies-novies.14). Tests whether the canonical tensor-product lift of the spectral IL contraction S_IL^spec = I_{tau_g+1} (x) exp(-eta H_P14) composed with the canonical REMESH echo matrix M_REMESH = M (x) I_N encodes Riemann-zero content in its iteration-matrix spectrum -- i.e. whether breaking hypothesis (i) of the Euler-Orthogonality Lemma (§13vicies-novies.11) by moving from edge-channel (graph Laplacian) to spectral-channel (P14 Hamiltonian) suffices to recover Riemann level statistics.

This is a pre-registration commit. The methodology, parameters, seeds, and decision thresholds are locked here. No data is collected at commit time. First execution will append the Results block as §13vicies-novies.15.

Construction

  • Graph: canonical P14 prime-ladder (src/tnfr/riemann/prime_ladder_hamiltonian.py::build_prime_ladder_graph) with n_primes=10, max_power=4, coupling=0. N = 40 nodes = 10 disjoint P_4.
  • Hamiltonian: full canonical P14 internal Hamiltonian H_P14 = H_int via tnfr.operators.hamiltonian.InternalHamiltonian on the canonical graph; H_int = H_coh + H_freq + H_coupling with H_coupling = 0 here (coupling=0 in build_prime_ladder_hamiltonian), so H_freq carries the prime-ladder spectrum (eigenvalues k * log p_i) on its diagonal.
  • REMESH delay window: tau_g + 1 = 17 slots.
  • Joint state dim: N * (tau_g + 1) = 680.
  • Index convention: index = slot * N + node. Then M_REMESH = kron(M, I_N) S_IL^spec = kron(I_{tau_g+1}, expm(-eta * H_P14)) T_spec = S_IL^spec @ M_REMESH

The spectral IL lift is uniform across all slots (not slot-0-only as in §13vicies-novies.9 / §13vicies-novies.12), matching the canonical spectral-space construction of §13vicies-novies.10.

F7-A statistic (pre-registered)

  1. Remove trivial fixed-point cluster: |lambda - 1| < 1e-9.
  2. Project to 1-D: Im(lambda) for upper-half-plane subset (Im >= 1e-12), sorted ascending. Fallback Re(lambda) sorted ascending if projection is empty (real spectrum).
  3. Normalised consecutive spacings: delta_k = (s_{k+1} - s_k) / mean.
  4. KS distance D_GUE = sup_x |F_emp(x) - F_GUE(x)| with P_GUE(s) = (32/pi^2) s^2 exp(-4 s^2 / pi).

F8 structural condition (pre-registered, necessary)

  • F8 SATISFIED: |D_canonical - D_shuffled| >= 0.01 (spectral-space composition genuinely breaks S_n-equivariance under prime relabelling).
  • F8 FAILED: |D_canonical - D_shuffled| < 0.01 (spectral equivalence persists; canonical tensor-product lift extends the Euler-Orthogonality obstruction to the spectral channel -> INDETERMINATE construction).

Pre-registered F7 verdict

  • SUPPORTED : D_canonical < 0.15 AND D_canonical < D_shuffled - 0.05 AND D_canonical < D_N5 - 0.05.
  • REFUTED : D_canonical > 0.30 OR (D_canonical >= D_shuffled - 0.05 AND F8 SATISFIED).
  • INDETERMINATE_DEGENERATE_CONSTRUCTION : F8 FAILED.
  • INDETERMINATE_OTHER : F8 SATISFIED and neither SUPPORTED nor REFUTED.

Controls

  • N1 GOE (dim 680, symmetric, real spectrum -> Re-projection fallback)
  • N2 Poisson (680 uniform points -> spacings of e^{-s} distribution)
  • N3 prime-ladder shuffled (primary discriminator for F8: primes permuted across the 10 P_4 components; H_P14 re-instantiated via InternalHamiltonian on the relabelled graph)
  • N4 REMESH-isolated (re-run of the 17-eigenvalue M matrix; reported as diagnostic baseline, expected to be degenerate)
  • N5 random-self-adjoint-replacement (replace H_P14 with a random symmetric 40 x 40 matrix of the same spectral radius; tests whether canonical P14 spectrum structure matters vs generic self-adjoint operator of comparable scale)

Reference

  • D_Riemann: KS distance for the first K_ref = 100 Riemann zero imaginary parts via mpmath.zetazero. External anchor.

Seeds & parameters

  • numpy default_rng(20260526) for N1/N2/N3/N5 stochastic draws (reused from §13vicies-novies.12 for cross-milestone reproducibility consistency).
  • mpmath dps = 30.
  • REMESH: alpha = 0.5, tau_l = 4, tau_g = 16.
  • Spectral IL coupling: eta = 0.3.
  • Graph: n_primes = 10, max_power = 4, coupling = 0.

Result of this milestone will be appended to theory/TNFR_RIEMANN_RESEARCH_NOTES.md as §13vicies-novies.15.

Source Code

python
"""R-inf-1b: Spectrum of T_spec = S_IL^spec . M_REMESH on the P14
internal Hilbert space {|p,k>} vs the GUE Wigner surmise.

Pre-registered milestone (§13vicies-novies.14). Tests whether the
canonical tensor-product lift of the spectral IL contraction
S_IL^spec = I_{tau_g+1} (x) exp(-eta H_P14) composed with the canonical
REMESH echo matrix M_REMESH = M (x) I_N encodes Riemann-zero content
in its iteration-matrix spectrum -- i.e. whether breaking hypothesis (i)
of the Euler-Orthogonality Lemma (§13vicies-novies.11) by moving from
edge-channel (graph Laplacian) to spectral-channel (P14 Hamiltonian)
suffices to recover Riemann level statistics.

This is a pre-registration commit. The methodology, parameters, seeds,
and decision thresholds are locked here. No data is collected at commit
time. First execution will append the Results block as
§13vicies-novies.15.

Construction
------------
* Graph: canonical P14 prime-ladder
  (src/tnfr/riemann/prime_ladder_hamiltonian.py::build_prime_ladder_graph)
  with n_primes=10, max_power=4, coupling=0. N = 40 nodes = 10 disjoint P_4.
* Hamiltonian: full canonical P14 internal Hamiltonian H_P14 = H_int
  via tnfr.operators.hamiltonian.InternalHamiltonian on the canonical
  graph; H_int = H_coh + H_freq + H_coupling with H_coupling = 0 here
  (coupling=0 in build_prime_ladder_hamiltonian), so H_freq carries the
  prime-ladder spectrum (eigenvalues k * log p_i) on its diagonal.
* REMESH delay window: tau_g + 1 = 17 slots.
* Joint state dim: N * (tau_g + 1) = 680.
* Index convention: index = slot * N + node. Then
      M_REMESH         = kron(M, I_N)
      S_IL^spec        = kron(I_{tau_g+1}, expm(-eta * H_P14))
      T_spec           = S_IL^spec @ M_REMESH

The spectral IL lift is *uniform across all slots* (not slot-0-only as
in §13vicies-novies.9 / §13vicies-novies.12), matching the canonical
spectral-space construction of §13vicies-novies.10.

F7-A statistic (pre-registered)
-------------------------------
1. Remove trivial fixed-point cluster: |lambda - 1| < 1e-9.
2. Project to 1-D: Im(lambda) for upper-half-plane subset (Im >= 1e-12),
   sorted ascending. Fallback Re(lambda) sorted ascending if projection
   is empty (real spectrum).
3. Normalised consecutive spacings: delta_k = (s_{k+1} - s_k) / mean.
4. KS distance D_GUE = sup_x |F_emp(x) - F_GUE(x)| with
       P_GUE(s) = (32/pi^2) s^2 exp(-4 s^2 / pi).

F8 structural condition (pre-registered, necessary)
---------------------------------------------------
* F8 SATISFIED: |D_canonical - D_shuffled| >= 0.01
  (spectral-space composition genuinely breaks S_n-equivariance under
  prime relabelling).
* F8 FAILED:    |D_canonical - D_shuffled| < 0.01
  (spectral equivalence persists; canonical tensor-product lift extends
  the Euler-Orthogonality obstruction to the spectral channel ->
  INDETERMINATE construction).

Pre-registered F7 verdict
-------------------------
* SUPPORTED       : D_canonical < 0.15 AND
                    D_canonical < D_shuffled - 0.05 AND
                    D_canonical < D_N5      - 0.05.
* REFUTED         : D_canonical > 0.30 OR
                    (D_canonical >= D_shuffled - 0.05 AND F8 SATISFIED).
* INDETERMINATE_DEGENERATE_CONSTRUCTION : F8 FAILED.
* INDETERMINATE_OTHER : F8 SATISFIED and neither SUPPORTED nor REFUTED.

Controls
--------
* N1 GOE (dim 680, symmetric, real spectrum -> Re-projection fallback)
* N2 Poisson (680 uniform points -> spacings of e^{-s} distribution)
* N3 prime-ladder shuffled (primary discriminator for F8: primes
  permuted across the 10 P_4 components; H_P14 re-instantiated via
  InternalHamiltonian on the relabelled graph)
* N4 REMESH-isolated (re-run of the 17-eigenvalue M matrix; reported as
  diagnostic baseline, expected to be degenerate)
* N5 random-self-adjoint-replacement (replace H_P14 with a random
  symmetric 40 x 40 matrix of the same spectral radius; tests whether
  canonical P14 spectrum structure matters vs generic self-adjoint
  operator of comparable scale)

Reference
---------
* D_Riemann: KS distance for the first K_ref = 100 Riemann zero
  imaginary parts via mpmath.zetazero. External anchor.

Seeds & parameters
------------------
* numpy default_rng(20260526) for N1/N2/N3/N5 stochastic draws
  (reused from §13vicies-novies.12 for cross-milestone reproducibility
  consistency).
* mpmath dps = 30.
* REMESH: alpha = 0.5, tau_l = 4, tau_g = 16.
* Spectral IL coupling: eta = 0.3.
* Graph: n_primes = 10, max_power = 4, coupling = 0.

Result of this milestone will be appended to
theory/TNFR_RIEMANN_RESEARCH_NOTES.md as §13vicies-novies.15.
"""

from __future__ import annotations

import argparse
import json
import sys
from pathlib import Path
from typing import Any

import numpy as np
from scipy.linalg import eig, eigvalsh, expm

REPO_ROOT = Path(__file__).resolve().parent.parent
SRC = REPO_ROOT / "src"
if str(SRC) not in sys.path:
    sys.path.insert(0, str(SRC))

import mpmath as mp

from tnfr.riemann.prime_ladder_hamiltonian import build_prime_ladder_hamiltonian

mp.mp.dps = 30


# -- pre-registered canonical parameters ---------------------------------
ALPHA: float = 0.5
TAU_LOCAL: int = 4
TAU_GLOBAL: int = 16
ETA_IL: float = 0.3
N_PRIMES: int = 10
MAX_POWER: int = 4
PERM_SEED: int = 20260526
K_REF_RIEMANN: int = 100

# F7-A thresholds (pre-registered, identical to §13vicies-novies.12)
D_SUPPORTED_MAX: float = 0.15
D_REFUTED_MIN: float = 0.30
D_SHUFFLE_MARGIN: float = 0.05
D_N5_MARGIN: float = 0.05
F8_FLOOR: float = 0.01

TRIVIAL_TOL: float = 1e-9
IM_TOL: float = 1e-12
SELF_ADJOINT_TOL: float = 1e-12


# -- canonical building blocks -------------------------------------------
def build_remesh_iteration_matrix(alpha: float, tau_l: int, tau_g: int) -> np.ndarray:
    """Canonical REMESH (tau_g+1)x(tau_g+1) shift-augmented matrix.

    Mirror of remesh_infinity_riemann_composed.py and
    remesh_infinity_riemann_modified_graph.py to keep the milestones
    bit-comparable at the REMESH layer.
    """
    if tau_l < 1 or tau_g < 1 or tau_l > tau_g:
        raise ValueError("require 1 <= tau_l <= tau_g")
    if not (0.0 < alpha < 1.0):
        raise ValueError("require 0 < alpha < 1")
    dim = tau_g + 1
    M = np.zeros((dim, dim), dtype=np.float64)
    M[0, 0] = (1.0 - alpha) ** 2
    M[0, tau_l] = alpha * (1.0 - alpha)
    M[0, tau_g] = alpha
    for k in range(1, dim):
        M[k, k - 1] = 1.0
    return M


def build_p14_hamiltonian(primes: list[int] | None = None) -> np.ndarray:
    """Canonical P14 internal Hamiltonian H_int as a dense (40, 40) array.

    Uses tnfr.riemann.prime_ladder_hamiltonian.build_prime_ladder_hamiltonian
    with n_primes=10, max_power=4, coupling=0 (canonical P14 reference of
    §13quinquies). Returns the .hamiltonian.H_int matrix as float64.

    If `primes` is provided, the prime-ladder is instantiated on the
    given prime list (used by the N3 shuffled-prime control).
    """
    ph = build_prime_ladder_hamiltonian(
        N_PRIMES,
        max_power=MAX_POWER,
        coupling=0.0,
        primes=primes,
    )
    H = np.asarray(ph.hamiltonian.H_int, dtype=np.float64)
    if H.shape != (N_PRIMES * MAX_POWER, N_PRIMES * MAX_POWER):
        raise RuntimeError(
            f"unexpected H_int shape {H.shape}; "
            f"expected ({N_PRIMES * MAX_POWER}, {N_PRIMES * MAX_POWER})"
        )
    asym = float(np.max(np.abs(H - H.T)))
    if asym > SELF_ADJOINT_TOL:
        raise RuntimeError(
            f"H_P14 not self-adjoint to tolerance {SELF_ADJOINT_TOL}: "
            f"||H - H^T||_inf = {asym:.3e}"
        )
    return H


def build_spectral_il_smoother(H: np.ndarray, eta: float) -> np.ndarray:
    """S_IL^spec on H_N: exp(-eta * H_P14). Self-adjoint by construction."""
    return expm(-eta * H)


def build_spectral_iteration_matrix(
    M: np.ndarray,
    S_N: np.ndarray,
) -> np.ndarray:
    """T_spec = S_IL^spec . M_REMESH in slot-major ordering.

    Index convention: index = slot * N + (p,k). Then
        M_REMESH    = kron(M, I_N)
        S_IL^spec   = kron(I_{tau_g+1}, S_N)     where S_N = exp(-eta H_P14)
                      (uniform across all slots)
    """
    N = S_N.shape[0]
    dim_slot = M.shape[0]  # tau_g + 1
    I_N = np.eye(N)
    I_slot = np.eye(dim_slot)
    M_REMESH = np.kron(M, I_N)
    S_IL_spec = np.kron(I_slot, S_N)
    return S_IL_spec @ M_REMESH


# -- F7-A: KS distance vs GUE Wigner surmise -----------------------------
def gue_wigner_pdf(s: np.ndarray) -> np.ndarray:
    return (32.0 / np.pi**2) * s**2 * np.exp(-4.0 * s**2 / np.pi)


def gue_wigner_cdf(s: np.ndarray) -> np.ndarray:
    """CDF by trapezoidal quadrature on a dense grid (matches the
    convention of remesh_infinity_riemann_composed.py and
    remesh_infinity_riemann_modified_graph.py)."""
    s = np.asarray(s, dtype=np.float64)
    grid = np.linspace(0.0, max(float(s.max()) + 1e-9, 1.0), 4001)
    pdf = gue_wigner_pdf(grid)
    cdf_grid = np.concatenate(
        [[0.0], np.cumsum(0.5 * (pdf[1:] + pdf[:-1]) * np.diff(grid))]
    )
    cdf_grid = cdf_grid / cdf_grid[-1]
    return np.interp(s, grid, cdf_grid)


def normalised_spacings(values_sorted: np.ndarray) -> np.ndarray:
    if values_sorted.size < 2:
        return np.array([], dtype=np.float64)
    diffs = np.diff(values_sorted)
    mean = diffs.mean()
    if mean <= 0.0:
        return np.zeros_like(diffs)
    return diffs / mean


def ks_distance_vs_gue(spacings: np.ndarray) -> float:
    if spacings.size == 0:
        return float("nan")
    sorted_s = np.sort(spacings)
    n = sorted_s.size
    emp_cdf_at_points = np.arange(1, n + 1) / n
    gue_at_points = gue_wigner_cdf(sorted_s)
    d_plus = float(np.max(emp_cdf_at_points - gue_at_points))
    d_minus = float(np.max(gue_at_points - (np.arange(n) / n)))
    return max(d_plus, d_minus)


def project_spectrum_1d(eigvals: np.ndarray) -> tuple[np.ndarray, str]:
    nontrivial = eigvals[np.abs(eigvals - 1.0) > TRIVIAL_TOL]
    upper = nontrivial[np.imag(nontrivial) >= IM_TOL]
    if upper.size >= 2:
        return np.sort(np.imag(upper).astype(np.float64)), "Im_upper"
    return np.sort(np.real(nontrivial).astype(np.float64)), "Re_fallback"


def f7a_diagnostic(eigvals: np.ndarray, label: str) -> dict[str, Any]:
    projection, projection_kind = project_spectrum_1d(eigvals)
    spacings = normalised_spacings(projection)
    d_gue = ks_distance_vs_gue(spacings)
    return {
        "label": label,
        "projection_kind": projection_kind,
        "n_projected_values": int(projection.size),
        "n_spacings": int(spacings.size),
        "D_GUE": float(d_gue) if np.isfinite(d_gue) else None,
        "spacings_mean": float(spacings.mean()) if spacings.size else None,
        "spacings_std": float(spacings.std()) if spacings.size else None,
    }


# -- controls -------------------------------------------------------------
def control_goe(dim: int, rng: np.random.Generator) -> dict[str, Any]:
    X = rng.standard_normal((dim, dim))
    A = (X + X.T) / np.sqrt(2.0 * dim)
    eigvals = eigvalsh(A).astype(np.complex128)
    return f7a_diagnostic(eigvals, "N1_GOE")


def control_poisson(n_points: int, rng: np.random.Generator) -> dict[str, Any]:
    pts = np.sort(rng.uniform(0.0, 1.0, n_points))
    spacings = normalised_spacings(pts)
    d_gue = ks_distance_vs_gue(spacings)
    return {
        "label": "N2_Poisson",
        "projection_kind": "uniform_iid",
        "n_projected_values": int(pts.size),
        "n_spacings": int(spacings.size),
        "D_GUE": float(d_gue) if np.isfinite(d_gue) else None,
        "spacings_mean": float(spacings.mean()),
        "spacings_std": float(spacings.std()),
    }


def control_shuffled_prime(
    M: np.ndarray,
    rng: np.random.Generator,
) -> dict[str, Any]:
    """N3: rebuild H_P14 with primes permuted across the 10 ladders.

    H_P14 is re-instantiated via InternalHamiltonian on the relabelled
    graph (the prime ordering enters via H_freq diagonal entries
    k * log p_i; this is the *primary discriminator* for F8).
    """
    from sympy import primerange

    primes = list(primerange(2, 100))[:N_PRIMES]
    perm = rng.permutation(N_PRIMES)
    primes_shuffled = [primes[int(i)] for i in perm]
    H_shuffled = build_p14_hamiltonian(primes=primes_shuffled)
    S_N_shuffled = build_spectral_il_smoother(H_shuffled, ETA_IL)
    T_shuffled = build_spectral_iteration_matrix(M, S_N_shuffled)
    eigvals_shuffled, _ = eig(T_shuffled)
    diag = f7a_diagnostic(eigvals_shuffled, "N3_shuffled_prime")
    diag["primes_canonical"] = primes
    diag["primes_shuffled"] = primes_shuffled
    diag["H_shuffled_spectral_radius"] = float(np.max(np.abs(eigvalsh(H_shuffled))))
    return diag


def control_remesh_isolated(M: np.ndarray) -> dict[str, Any]:
    eigvals_M, _ = eig(M)
    return f7a_diagnostic(eigvals_M.astype(np.complex128), "N4_REMESH_isolated")


def control_random_self_adjoint(
    M: np.ndarray,
    target_radius: float,
    rng: np.random.Generator,
) -> dict[str, Any]:
    """N5: replace H_P14 with a random symmetric matrix of matching
    spectral radius.

    Tests whether the canonical P14 spectrum carries additional content
    beyond a generic self-adjoint operator of comparable scale.
    """
    N = N_PRIMES * MAX_POWER
    X = rng.standard_normal((N, N))
    H_rand = (X + X.T) / np.sqrt(2.0 * N)
    current_radius = float(np.max(np.abs(eigvalsh(H_rand))))
    if current_radius > 0:
        H_rand *= target_radius / current_radius
    S_N_rand = build_spectral_il_smoother(H_rand, ETA_IL)
    T_rand = build_spectral_iteration_matrix(M, S_N_rand)
    eigvals_rand, _ = eig(T_rand)
    diag = f7a_diagnostic(eigvals_rand, "N5_random_self_adjoint")
    diag["target_spectral_radius"] = float(target_radius)
    diag["realised_spectral_radius"] = float(np.max(np.abs(eigvalsh(H_rand))))
    return diag


def reference_riemann_d_gue(k_ref: int) -> dict[str, Any]:
    gammas = np.array([float(mp.im(mp.zetazero(k))) for k in range(1, k_ref + 1)])
    spacings = normalised_spacings(gammas)
    d_gue = ks_distance_vs_gue(spacings)
    return {
        "label": "Riemann_reference",
        "k_ref": k_ref,
        "n_spacings": int(spacings.size),
        "D_GUE": float(d_gue),
        "spacings_mean": float(spacings.mean()),
        "spacings_std": float(spacings.std()),
    }


# -- milestone driver -----------------------------------------------------
def run_milestone(out_path: Path) -> dict[str, Any]:
    rng = np.random.default_rng(PERM_SEED)

    # -- canonical construction
    H_canonical = build_p14_hamiltonian()
    spectral_radius_canonical = float(np.max(np.abs(eigvalsh(H_canonical))))
    S_N_canonical = build_spectral_il_smoother(H_canonical, ETA_IL)
    M = build_remesh_iteration_matrix(ALPHA, TAU_LOCAL, TAU_GLOBAL)
    T = build_spectral_iteration_matrix(M, S_N_canonical)
    N = H_canonical.shape[0]
    dim_joint = T.shape[0]
    eigvals_T, _ = eig(T)

    canonical = f7a_diagnostic(eigvals_T, "canonical_S_IL_spec_o_M_REMESH")
    canonical["dim_joint"] = int(dim_joint)
    canonical["N_basis"] = int(N)
    canonical["H_spectral_radius"] = float(spectral_radius_canonical)

    # -- controls
    goe = control_goe(dim_joint, rng)
    poisson = control_poisson(dim_joint, rng)
    shuffled = control_shuffled_prime(M, rng)
    remesh_iso = control_remesh_isolated(M)
    random_sa = control_random_self_adjoint(M, spectral_radius_canonical, rng)
    riemann_ref = reference_riemann_d_gue(K_REF_RIEMANN)

    # -- F8 structural condition
    d_can = canonical["D_GUE"]
    d_shuf = shuffled["D_GUE"]
    d_n5 = random_sa["D_GUE"]

    if d_can is None or d_shuf is None:
        f8_satisfied = False
        f8_delta = None
    else:
        f8_delta = abs(d_can - d_shuf)
        f8_satisfied = f8_delta >= F8_FLOOR

    # -- pre-registered F7 verdict
    if d_can is None or d_shuf is None or d_n5 is None:
        f7a_verdict = "INDETERMINATE_INVALID_PROJECTION"
    elif not f8_satisfied:
        f7a_verdict = "INDETERMINATE_DEGENERATE_CONSTRUCTION"
    elif (
        d_can < D_SUPPORTED_MAX
        and d_can < d_shuf - D_SHUFFLE_MARGIN
        and d_can < d_n5 - D_N5_MARGIN
    ):
        f7a_verdict = "SUPPORTED"
    elif d_can > D_REFUTED_MIN or d_can >= d_shuf - D_SHUFFLE_MARGIN:
        f7a_verdict = "REFUTED"
    else:
        f7a_verdict = "INDETERMINATE_OTHER"

    # -- pre-registered milestone verdict
    if f7a_verdict == "SUPPORTED":
        milestone_verdict = "B1_SPECTRAL_BASIS_POTENTIALLY_OPEN_REQUIRES_REPLICATION"
    elif f7a_verdict == "REFUTED":
        milestone_verdict = (
            "B1_SPECTRAL_BASIS_REFUTED_FOR_CANONICAL_TENSOR_PRODUCT_LIFT"
        )
    elif f7a_verdict == "INDETERMINATE_DEGENERATE_CONSTRUCTION":
        milestone_verdict = "B1_SPECTRAL_BASIS_INDETERMINATE_EULER_ORTHOGONALITY_EXTENDS_TO_SPECTRAL_CHANNEL"
    else:
        milestone_verdict = f"B1_SPECTRAL_BASIS_{f7a_verdict}"

    report = {
        "milestone": "R-inf-1b",
        "section_ref": "TNFR_RIEMANN_RESEARCH_NOTES.md §13vicies-novies.14",
        "canonical_config": {
            "graph": "P14 prime-ladder (canonical, unaugmented)",
            "hamiltonian": "InternalHamiltonian.H_int via build_prime_ladder_hamiltonian",
            "n_primes": N_PRIMES,
            "max_power": MAX_POWER,
            "coupling": 0.0,
            "N_basis": int(N),
            "alpha": ALPHA,
            "tau_l": TAU_LOCAL,
            "tau_g": TAU_GLOBAL,
            "tau_g_plus_1": TAU_GLOBAL + 1,
            "eta_IL_spec": ETA_IL,
            "dim_joint_state": int(dim_joint),
            "H_spectral_radius": float(spectral_radius_canonical),
            "lift": (
                "S_IL_spec = kron(I_{tau_g+1}, expm(-eta * H_P14)); "
                "M_REMESH = kron(M, I_N); T_spec = S_IL_spec @ M_REMESH"
            ),
        },
        "seed": PERM_SEED,
        "preregistration": {
            "statistic": "F7-A KS distance vs GUE Wigner surmise",
            "projection": "Im(lambda) upper-half-plane (fallback Re(lambda))",
            "thresholds": {
                "SUPPORTED": (
                    f"D_canonical < {D_SUPPORTED_MAX} AND "
                    f"D_canonical < D_shuffled - {D_SHUFFLE_MARGIN} AND "
                    f"D_canonical < D_N5      - {D_N5_MARGIN}"
                ),
                "REFUTED": (
                    f"D_canonical > {D_REFUTED_MIN} OR "
                    f"(D_canonical >= D_shuffled - {D_SHUFFLE_MARGIN} "
                    f"AND F8 SATISFIED)"
                ),
                "F8_SATISFIED": f"|D_canonical - D_shuffled| >= {F8_FLOOR}",
            },
            "theoretical_expectation": (
                "F8 FAILED (|D_can - D_shuf| at machine-precision floor); "
                "canonical tensor-product lift S_IL_spec = kron(I, exp(-eta H)) "
                "and M_REMESH = kron(M, I_N) commute with prime relabelling "
                "kron(I, P_sigma) up to unitary similarity, so spectra of "
                "T_spec_canonical and T_spec_shuffled coincide; would constitute "
                "a spectral-channel instantiation of the Euler-Orthogonality "
                "obstruction (§13vicies-novies.11)."
            ),
        },
        "f8_structural_condition": {
            "delta_D_can_minus_shuf_abs": (
                None if f8_delta is None else float(f8_delta)
            ),
            "floor": F8_FLOOR,
            "satisfied": bool(f8_satisfied),
        },
        "canonical": canonical,
        "controls": {
            "N1_GOE": goe,
            "N2_Poisson": poisson,
            "N3_shuffled_prime": shuffled,
            "N4_REMESH_isolated": remesh_iso,
            "N5_random_self_adjoint": random_sa,
        },
        "riemann_reference": riemann_ref,
        "f7a_verdict": f7a_verdict,
        "milestone_verdict": milestone_verdict,
    }

    out_path.parent.mkdir(parents=True, exist_ok=True)
    out_path.write_text(json.dumps(report, indent=2))
    return report


def _print_summary(report: dict[str, Any]) -> None:
    cfg = report["canonical_config"]
    print("=" * 72)
    print("R-inf-1b  (T_spec = S_IL^spec . M_REMESH on P14 internal Hilbert space)")
    print("=" * 72)
    print(f"Graph: {cfg['graph']}")
    print(f"Hamiltonian: {cfg['hamiltonian']}")
    print(
        f"  N_basis={cfg.get('N_basis', '?')}, "
        f"dim(joint)={cfg.get('dim_joint_state', '?')}"
    )
    print(f"  H_spectral_radius = {cfg['H_spectral_radius']:.6f}")
    print(
        f"REMESH: alpha={cfg.get('alpha', ALPHA)}, "
        f"tau_l={cfg.get('tau_l', TAU_LOCAL)}, "
        f"tau_g={cfg.get('tau_g', TAU_GLOBAL)}; "
        f"spectral IL: eta={cfg.get('eta_IL_spec', ETA_IL)}"
    )
    print()
    f8 = report.get("f8_structural_condition")
    if f8 is not None:
        d_str = (
            "N/A"
            if f8["delta_D_can_minus_shuf_abs"] is None
            else f"{f8['delta_D_can_minus_shuf_abs']:.4e}"
        )
        print(f"F8 structural condition (|D_can - D_shuf| >= {f8['floor']}):")
        print(f"  |Delta D|  = {d_str}   satisfied = {f8['satisfied']}")
        print()
    print("F7-A KS distance vs GUE Wigner surmise:")
    print(f"  {'label':36s} {'kind':14s} {'#spacings':>10s} {'D_GUE':>10s}")
    diags = [report["canonical"]]
    diags.extend(
        [
            report["controls"][k]
            for k in (
                "N1_GOE",
                "N2_Poisson",
                "N3_shuffled_prime",
                "N4_REMESH_isolated",
                "N5_random_self_adjoint",
            )
        ]
    )
    diags.append(report["riemann_reference"])
    for diag in diags:
        d_str = "N/A" if diag["D_GUE"] is None else f"{diag['D_GUE']:.4f}"
        kind = diag.get("projection_kind", "iid_or_zeros")
        print(
            f"  {diag['label']:36s} {kind:14s} "
            f"{diag['n_spacings']:>10d} {d_str:>10s}"
        )
    print()
    print(f"F7-A verdict      : {report['f7a_verdict']}")
    print(f"Milestone verdict : {report['milestone_verdict']}")
    print("=" * 72)


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument(
        "--out",
        type=Path,
        default=REPO_ROOT
        / "results"
        / "remesh_infinity"
        / "remesh_infinity_riemann_spectral_basis.json",
    )
    args = parser.parse_args()
    report = run_milestone(args.out)
    _print_summary(report)
    print(f"\nReport written: {args.out}")
    return 0


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