The unit of reproducibility.
An Invariant Evidence Bundle is the portable artifact that records a candidate invariant claim, the transformation loop used to test it, the holonomy defect, persistence information, prediction tests, provenance, assumptions, and status.
What a bundle contains
Claim identity
Invariant ID, claim ID, and bundle ID make the evidence addressable and versionable.
Transformation loop
The ordered path around which the candidate is transported and tested.
Defect score
The scalar defect, trace, and spectrum summarize closed-loop transport behavior.
Persistence
Birth, death, filtration variable, and persistence score reduce single-threshold cherry-picking.
Prediction tests
Held-out accuracy, baseline comparison, or other declared task metrics.
Reproducibility
Code commit, dataset hash, environment hash, random seed, and container image.
Minimal example
{
"invariant_id": "MI-DEMO-SCALE-LAW-0001",
"claim_id": "IC-0001",
"bundle_id": "IEB-0001",
"loop": ["baseline", "scaled", "coordinate_shift", "baseline"],
"transformation_family": ["scale", "coordinate"],
"threshold": 0.05,
"defect": 0.00012,
"trace": 1.99998,
"spectrum": [1.0001, 0.99988],
"persistence": {
"filtration_variable": "synthetic_noise_level",
"birth": 0.02,
"death": 0.89,
"persistence_score": 0.87
},
"status": "PASS"
}Verification commands
The scaffold keeps the CLI intentionally small. It validates schema conformance and checks whether the declared status matches the stated defect threshold.
mech-invariant demo scale-law mech-invariant validate examples/toy_scale_invariant/evidence_bundle.json mech-invariant verify examples/toy_scale_invariant/evidence_bundle.json
What a PASS means
PASS does not mean "true law."
A PASS means the evidence bundle satisfies the declared protocol checks under the declared assumptions, data, thresholds, and transformation loop. Physical truth requires domain validation, replication, and appropriate experimental support.