Module soc
Expand description
Sum of Coupling (soc) — code-maat parity.
Each commit of size N contributes (N-1) to every entity in it.
A solo commit contributes 0. The total per-entity SoC is the sum of
that contribution across every commit the entity appears in.
Semantically: “how many distinct files has this file been changed
alongside, totaled across commits?”. High SoC = central node in the
change-coupling graph.
§Threshold semantics (divergence from code-maat)
Code-maat overloaded --min-revs to mean “minimum SoC sum” in this
one analysis (while it meant “minimum revision count” everywhere else).
CodeLore exposes a dedicated --min-soc flag with the honest name.
Under --code-maat-compat, --min-revs falls back to the legacy
“minimum SoC sum” semantic for migration users.
Research basis: see docs/research-foundations.md entry “soc”
(Tornhill, Software Design X-Rays, 2018 — per-file centrality
across the change-coupling graph).