Claim classes

Every result in K4 Forge carries a claim class that says exactly how strong the guarantee is. These labels appear throughout the demo and in all run artifacts.

ClassMeaningProof requirement
[A]Algebraic exact. Integer identity via SymPy, unconditionalEvaluates to Integer(0). No geometry, no model, no tolerance.
[G]Geometry-dependent exact. Requires regular K4 + named field modelClosed-form derivation with explicit assumptions stated.
[G*]Model-limited. Valid within stated regime onlySame as [G] but with additional regime constraints.
[M]Numerical. Never promoted without a named proof pathVerified to stated tolerance. Not a proof — a measurement.
[H]Heuristic. Engineering guidance, not a proofExperience-based. No formal guarantee.
[C]Conjectural. Incomplete proofEvidence exists but proof chain is not closed.

Authoritative vs Exploratory

k4_frozen — Authoritative

Immutable algebraic core. 182 consistency checks. Contains the truth kernel (M, G, D, C_INT, S matrices), field engine, and Biot-Savart implementation. Never edited without a version bump and full audit.

If k4_frozen and k4_theory disagree, k4_frozen wins.

k4_theory — Exploratory Oracle

Independent theorem mining and proof engine. 47 registered theorems, S4 symmetry miner, candidate discovery. Uses only numpy, sympy, and stdlib — never imports from k4_frozen.

Cross-validated against k4_frozen in tests. The disagreement itself is valuable — it means something needs investigation.

Promotion path:A theorem proven in k4_theory at tier T0 (integer-exact) can be promoted to a verify_layer1() check in k4_frozen after independent review and explicit version bump.

Theorem inventory

47 registered theorems across 6 tiers. Each theorem is machine-verified on every test run.

T0

Integer Exact (DEC & Spectral)[A] Algebraic exact
T0.1L0 = 4I₄ − J₄Vertex Laplacian spectral decomposition
T0.2Cᵀ Dᵀ = 0DEC chain exactness
T0.3L1 = 4I₆Edge Laplacian is scalar identity
T0.4D M = 0Boundary operator kills cycles
T0.6D Cᵀ_T = 0Boundary of face = 0
T0.7Cᵀ Dᵀ = 0Transpose DEC chain
T0.8D_redᵀ = GReduced incidence = cut basis
T0.12Mᵀ(Δ− 2I)G = 0Hodge-Sigma orthogonality
T0.14Mᵀ A_opp G = rank-1Opposite-edge coupling structure
T0.15‖Mᵀ A_opp G‖²_F = 9Frobenius norm of opposite coupling

INT

Integer Field Structure[A] Algebraic exact
INT.CC_INT ∈ {-1,0,+1}³ˣ⁶Cross-product field matrix is integer
INT.CM_eq_neg2SC_INT·M = −2SField-cycle product is twice sign matrix
INT.CG_zeroC_INT·G = 0Cut annihilation to Integer(0)
INT.det_CM_32det(C_INT·M) = 32Controllability determinant
INT.gram_CM(C_INT·M)ᵀ(C_INT·M) = 4·GramControllability Gram, κ=2
INT.STS_gramSᵀS = GramSign matrix squared is 4I−J
INT.isotropyS·adj·Sᵀ = 16ICentroid isotropy via adjugate
INT.adj_checkGram·adj = 16IAdjugate correctness

T1

Algebraic Exact (Topology)[A] Algebraic exact
T1.1MᵀG = 0Hodge orthogonality — cycle ⊥ cut
T1.2D M = 0Kirchhoff compatibility
T1.3MᵀM = GᵀG = 4I−JGram identity
T1.4det(MᵀM) = 16Gram determinant
T1.5det([M|G]) = ±16Full-space determinant
T1.6M⁺G = G⁺M = 0Pseudoinverse orthogonality
T1.7P_cyc + P_cut = I₆Projector completeness
T1.8P_cyc·P_cut = 0Projector orthogonality

T2

Closed-form (Inductance & Ring-quiet)[G] Geometry-dependent exact
T2.1det(G_ring) = 0Ring solvability condition
T2.2null(G_ring) = span{1,1,1}Ring null space is uniform
T2.3Ring-quiet ⇔ J1+J2+J3=0Balanced cycle condition
T2.5M_opp = 0Opposite edges have zero mutual inductance
T2.6Mᵀ L G = 0Hodge-inductance decoupling
T2.7L eigenvalue degeneracy3-fold degenerate cycle and cut eigenvalues

T3 / SYM

Parametric (Electromagnetics)[G] Geometry-dependent exact
T3.1F·G = 0Cut annihilation at centroid (Biot-Savart)
T3.2det(F·M) ≠ 0Controllability determinant nonzero
T3.3rank(F·M) = 3Full 3D B-field control
SYM.F0GF₀·G = 0Symbolic cut annihilation (parametric in L)
SYM.signF₀·M = α·SField-cycle factorization
SYM.F0Mdet(F₀·M), κ=2Condition number of field matrix

Sel

Selection Rules (Multipole)[M] Numerical
Sel.1Cut dipole = 0Cut currents produce zero dipole moment
Sel.2Cut quadrupole = 0Cut currents produce zero quadrupole moment
Sel.3Cycle octupole = 0Cycle currents produce zero octupole moment

Anchor theorems

These four theorems form the backbone of the K4 field control story. Together they prove: cut currents cannot produce field at the centroid, cycle currents give full 3D control, and the system is well-conditioned.

[A]T1.1
Hodge orthogonality
MᵀG = 0

Cycle and cut spaces are algebraically orthogonal. This is unconditional — it holds for any K4, any geometry, any field model.

[A]INT.CG_zero
Integer cut annihilation
C_INT·G = 0

The cross-product field matrix applied to cut currents is exactly zero — verified to Integer(0) via SymPy. No Biot-Savart needed.

[A]INT.det_CM_32
Controllability
det(C_INT·M) = 32

The field-cycle product has full rank with integer determinant 32. Three cycle currents control all three field components.

[A]INT.gram_CM
Condition number κ = 2
(C_INT·M)ᵀ(C_INT·M) = 4·Gram

The controllability Gram matrix has condition number 2 — well-conditioned by construction, not by luck.

All theorems are machine-verified on every test run. Run python -m k4_theory --prove or pytest tests/test_theory_miner.py -v to verify locally.