@wbern/obscene 2.1.0 → 2.1.1

package/README.md

@@ -185,7 +185,7 @@ The coupling table annotates entries that need framing:
 | Marker | JSON field | Meaning |
 |--------|------------|---------|
 | `†` next to a path | `file1Deleted` / `file2Deleted` | File is no longer present at HEAD (deleted or renamed away). The coupling signal is historical; the pair is not actionable in the current tree. |
-| `⇄` next to the Degree value | `lockstep` | Both files' total churn equals their co-change count over the window — they only ever changed together. The 100% degree is real but uninformative; treat the pair as a single unit from git's perspective. |
+| `⇄` next to the Degree value | `lockstep` | Shared commits / max(churn) ≥ 0.9 — both files almost always change together over the window. Typical of generator/mirror pairs (`README.md` ↔ `src/README.md`, `*.pb.go` ↔ `*.proto`). Treat the pair as a single unit from git's perspective. |
 
 ### Corpus framing
 

package/dist/cli.js

@@ -359,7 +359,8 @@ function computeCoupling(cochanges, churn, complexityMap, minCochanges, trackedF
       percentOfTotal: 0,
       tier: "cool"
     };
-    if (count > 0 && churn1 === count && churn2 === count) {
+    const maxChurn = Math.max(churn1, churn2);
+    if (count > 0 && maxChurn > 0 && count / maxChurn >= 0.9) {
       entry.lockstep = true;
     }
     if (trackedFiles) {
@@ -880,9 +881,10 @@ function formatHotspotsTable(output) {
       "Score=metric\xD7churn | Tiers are relative to THIS codebase, not absolute quality grades."
     )
   );
+  const zeroComplexityCorpus = corpus !== void 0 && corpus.fileCount > 0 && corpus.totalComplexity === 0;
   lines.push(
     pc2.dim(
-      "High scores flag review candidates, not bad code \u2014 stable complex files (parsers, engines) score high naturally."
+      zeroComplexityCorpus ? "High scores flag files that change often and are sizable \u2014 neither is bad in itself." : "High scores flag review candidates, not bad code \u2014 stable complex files (parsers, engines) score high naturally."
     )
   );
   lines.push(pc2.dim("Docs: https://github.com/wbern/obscene#metrics"));
@@ -964,7 +966,7 @@ function formatCompositeTable(output) {
 
 // src/cli.ts
 var program = new Command();
-program.name("obscene").description("Identify hotspot files \u2014 complex code that changes frequently").version("2.1.0");
+program.name("obscene").description("Identify hotspot files \u2014 complex code that changes frequently").version("2.1.1");
 var REPORT_GUIDE = {
   complexity: "Cyclomatic complexity (branch/loop count). NOT a quality judgment \u2014 a 500-line parser will naturally score high. Compare density, not raw values.",
   complexityDensity: "Complexity per line of code. Normalizes for file size. >0.25 suggests dense logic worth reviewing; <0.10 is typical for straightforward code.",
@@ -986,7 +988,7 @@ var COUPLING_GUIDE = {
   totalComplexity: "Sum of both files' cyclomatic complexity. Highlights coupled pairs where the involved code is also complex \u2014 hidden dependency + high complexity compounds maintenance risk.",
   tier: "Relative ranking within THIS codebase's coupling pairs (top 50% = hot, next 30% = warm, bottom 20% = cool). NOT an absolute quality grade. 'hot' means this pair co-changes more than most \u2014 it may be intentional and fine.",
   deleted: "file1Deleted / file2Deleted are set when the file is no longer present at HEAD (deleted or renamed away). The coupling signal is historical \u2014 the pair is not actionable in the current tree.",
-  lockstep: "Set when both files' total churn equals their co-change count over the window \u2014 i.e. they only ever changed together. The 100% degree is real but uninformative; treat the pair as a single unit from git's perspective."
+  lockstep: "Set when shared commits / max(churn) \u2265 0.9 \u2014 both files almost always change together over the window. Typical of generator/mirror pairs (README \u2194 src/README, *.pb.go \u2194 *.proto). The coupling signal is real but uninformative; treat the pair as a single unit from git's perspective."
 };
 function addSharedOptions(cmd) {
   return cmd.option("--top <n>", "limit to top N entries (0 = all)", "20").option("--format <type>", "output format: json | table", "json").option(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wbern/obscene",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Identify hotspot files — complex code that changes frequently. Churn × complexity analysis for any git repo.",
   "type": "module",
   "bin": {