leanprover-community / leanprover-community/physlib

Documentation claims support for RHNs in MSSM but code does not implement them

Open Beginner friendly
#1,535 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

good first issue help-wanted
Dominant language
Lean
Stars
749
Forks
189
Avg merge
1d 21h
Merged PRs (30d)
75

Description

⚠️ Found by a local LLM, not a human. This was flagged by an automated documentation-mistake finder (qwen3:14b) and passed 10/10 independent verification runs before filing, but it has not been reviewed by a person. Please check it's a genuine error before acting on it.


Summary

The documentation in Physlib/Particles/SuperSymmetry/MSSMNu/AnomalyCancellation/Basic.lean (around line 10) is incorrect.

Current text
# The MSSM with 3 families and RHNs

We define the system of ACCs for the MSSM with 3 families and RHNs.
We define the system of charges for 1-species. We prove some basic lemmas about them.
Why this is wrong

The file's documentation states it defines anomaly cancellation conditions for the MSSM with 3 families and right-handed neutrinos (RHNs). However, the code only implements charge definitions and ACCs for the standard MSSM without RHNs. The MSSMCharges structure and related lemmas like toSpecies split charges into SM fermions and MSSM Higgses but do not include any RHN-specific species or charges.

The correction removes mention of RHNs because the code lacks any definitions that would account for them, such as additional fermion species in MSSMSpecies or corresponding terms in anomaly equations. The current implementation aligns with the standard MSSM, which does not include right-handed neutrinos. This matches the actual Lean declarations, which define only 18 SM fermions plus 2 Higgses in toSMPlusH, without any RHN contributions.

Suggested correction
# The MSSM with 3 families

We define the system of ACCs for the MSSM with 3 families.
We define the system of charges for 1-species. We prove some basic lemmas about them.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open Physlib/Particles/SuperSymmetry/MSSMNu/AnomalyCancellation/Basic.lean around lines 10–13 and inspect the MSSMCharges, toSpecies, and toSMPlusH declarations to confirm the documentation matches the implemented species. Update the heading and summary so they no longer claim RHN support, then check that the file’s documentation accurately describes the existing MSSM content.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
85/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.