Skip to content

docs(classical-field): add gauge theory API map#1438

Merged
jstoobysmith merged 1 commit into
leanprover-community:masterfrom
Robby955:api-map-classical-field
Jul 20, 2026
Merged

docs(classical-field): add gauge theory API map#1438
jstoobysmith merged 1 commit into
leanprover-community:masterfrom
Robby955:api-map-classical-field

Conversation

@Robby955

Copy link
Copy Markdown
Contributor

Motivation

Related to #1414, and a tracking map for the gauge-theory API in #859. An API map records the implemented status and source location of each requirement for an API, so the gap between a planned API and the current library stays visible in-tree.

Changes

Adds Physlib/ClassicalFieldTheory/GaugeTheory/API-map.yaml.

The library has no general or non-abelian gauge-theory framework yet, so those requirements (an abstract structure group, the connection, the covariant derivative, Yang-Mills curvature and action, Wilson lines, and a principal-bundle formulation) are marked not done with location N/A. The completed requirements point at the two concrete pieces that do exist: the abelian U(1) case in Physlib/Electromagnetism/Kinematics (potential, field strength, the gauge transformation and its invariance, and equivariance under the Lorentz action), and the Standard Model gauge group in Physlib/Particles/StandardModel/Basic.lean.

Testing

Ran the API-map linter:

python3 scripts/api_map_linter.py --repo .

The map passes: every declared source file and name resolves, and no completed entry is missing a location.

@github-actions

Copy link
Copy Markdown
Contributor

Thank you for this PR, which will now be reviewed. If submitting to ./Physlib or ./QuantumInfo, please see our review guidelines if you are not familiar with the process. You should expect a back and forth with a reviewer before your PR is merged. See also that link for how to add appropriate labels to your PR. The PR will also go through a number of automated checks. You can learn more about these here, including how to run them locally.

If you are submitting to ./PhyslibAlpha there will be a lighter review process, though your PR must still pass the automated checks.

If you want to bring attention to this PR, please write a message on this thread of the Lean Zulip.

Important: If a reviewer adds an awaiting-author label to your PR, once you have addressed the review comments, please remove that label by adding a comment with -awaiting-author. This helps us keep track of reviews.

@Robby955
Robby955 marked this pull request as ready for review July 18, 2026 17:49

@jstoobysmith jstoobysmith left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved - many thanks

@jstoobysmith jstoobysmith added the ready-to-merge This PR is approved and will be merged shortly label Jul 19, 2026
@jstoobysmith
jstoobysmith merged commit 240e100 into leanprover-community:master Jul 20, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-to-merge This PR is approved and will be merged shortly t-classical-field-theory

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants