stopslop 1.2.0 → 1.2.1

package/COMPATIBILITY.md

@@ -1,6 +1,6 @@
 # Compatibility
 
-Last updated: 1.1.0
+Last updated: 1.2.1 (2026-11-02)
 
 StopSlop follows Semantic Versioning. Stable surfaces change incompatibly only
 in a major release. Experimental surfaces may change in a minor release; such
@@ -20,6 +20,10 @@ calibration, and Knip or Clone Alert updates can change what a release reports
 for the same code; such changes are called out in the changelog. Pin the
 StopSlop version in CI when a gate must not move without a commit.
 
+Version 1.2.1 preserves all stable surfaces and adds no deprecations. Anonymous
+function detection and analysis-engine updates can produce new findings or
+different scores for existing code.
+
 ## Runtime support
 
 - Node.js 20.19+, 22.12+, and 24.

package/README.md

@@ -42,6 +42,41 @@ uses [Clone Alert](https://www.npmjs.com/package/clone-alert); dead-code analysi
 uses [Knip](https://knip.dev). StopSlop detects code patterns, not whether a human
 or an AI wrote them.
 
+## A passing test does not mean the feature is connected
+
+An agent adds a discount function and a test:
+
+```ts
+// src/discount.ts
+export function applyDiscount(total: number): number {
+  return total * 0.9;
+}
+```
+
+```ts
+// test/discount.test.ts
+import { strictEqual } from 'node:assert';
+import { test } from 'node:test';
+import { applyDiscount } from '../src/discount.js';
+
+test('applies a 10% discount', () => {
+  strictEqual(applyDiscount(100), 90);
+});
+```
+
+The test passes, but checkout still calculates the total without calling
+`applyDiscount`. StopSlop reports:
+
+```text
+  1 orphan feature
+
+   orphan feature  `applyDiscount` is only used by the test `test/discount.test.ts`; connect it to production code, or remove it and its test if unneeded
+      src/discount.ts:1
+```
+
+If the discount belongs in checkout, connect it and keep the test. If the feature
+was abandoned, remove the unused function and its test.
+
 ## Start with one command
 
 Run without installing:
@@ -344,8 +379,9 @@ is experimental and may change in a minor release; see
 - A baseline accepts finding identities. If an accepted function becomes more
   complex without changing identity, the score rises but the gate stays clear.
 
-Architecture, research references, and the boundary between published methods
-and StopSlop heuristics are documented in [ARCH.md](ARCH.md).
+The score formula and its limits are in [docs/score.md](docs/score.md), how
+the default thresholds were calibrated in [docs/thresholds.md](docs/thresholds.md),
+and what each finding means in [docs/rules.md](docs/rules.md).
 
 ## FAQ
 

package/dist/cli.js

@@ -216,8 +216,8 @@ const RULES = {
 	},
 	"orphan-feature": {
 		summary: "Function or class is used only by its own test",
-		why: "No production code calls it; one test is the only thing that imports it. That is a feature written together with its test and never wired in, and the green test makes it look finished.",
-		fix: "Delete the symbol and its test together: deleting only the source breaks the test, and deleting only the test leaves dead code. If the feature is meant to exist, wire it into the production code that needs it.",
+		why: "No production code calls it; one test is the only thing that imports it. This can be a feature written together with its test and never wired in, and the green test makes it look finished.",
+		fix: "Check whether the feature is meant to exist. If so, wire it into the production code that needs it. Otherwise, remove the unused symbol and its test together: deleting only the source breaks the test, and deleting only the test leaves dead code.",
 		config: "deadCode.orphans"
 	}
 };

package/docs/configuration.md

@@ -62,7 +62,8 @@ the corpus it sits between count p95 ≈ 13 and p99 ≈ 38). Lower = stricter.
 ### `godClass` / `godModule` — object | false
 
 A class (or a module's top-level definitions) is flagged on **either** of two
-axes — see [ARCH.md](../ARCH.md) for the reasoning.
+axes, described below; [thresholds.md](thresholds.md) has the calibration behind
+the defaults.
 
 | field | meaning | default (class / module) |
 |---|---|---|

package/docs/rules.md

@@ -95,8 +95,8 @@ File is not reachable from any entry point.
 
 Function or class is used only by its own test.
 
-**Why it matters.** No production code calls it; one test is the only thing that imports it. That is a feature written together with its test and never wired in, and the green test makes it look finished.
+**Why it matters.** No production code calls it; one test is the only thing that imports it. This can be a feature written together with its test and never wired in, and the green test makes it look finished.
 
-**How to fix.** Delete the symbol and its test together: deleting only the source breaks the test, and deleting only the test leaves dead code. If the feature is meant to exist, wire it into the production code that needs it.
+**How to fix.** Check whether the feature is meant to exist. If so, wire it into the production code that needs it. Otherwise, remove the unused symbol and its test together: deleting only the source breaks the test, and deleting only the test leaves dead code.
 
 **Tune or disable:** `deadCode.orphans` in `stopslop.json`.

package/llms.txt

@@ -20,7 +20,6 @@ Coding agents: this repository is a plugin for Claude Code (`/plugin marketplace
 
 - [Score formula and interpretation](https://raw.githubusercontent.com/BaryshevRS/stopslop/main/docs/score.md)
 - [Default thresholds and calibration](https://raw.githubusercontent.com/BaryshevRS/stopslop/main/docs/thresholds.md)
-- [Architecture and methodology](https://raw.githubusercontent.com/BaryshevRS/stopslop/main/ARCH.md)
 - [Compatibility policy](https://raw.githubusercontent.com/BaryshevRS/stopslop/main/COMPATIBILITY.md)
 
 ## Package

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stopslop",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Static analysis for AI-generated JavaScript and TypeScript: find cognitive complexity, god classes/modules, duplicate code, dead code and orphan features.",
   "type": "module",
   "license": "MIT",
@@ -69,22 +69,22 @@
     "commit-msg": "pnpm exec commitlint --edit \"$1\""
   },
   "dependencies": {
-    "clone-alert": "^1.1.3",
-    "knip": "6.39.0",
-    "oxc-parser": "^0.139.0",
+    "clone-alert": "^1.1.5",
+    "knip": "6.44.1",
+    "oxc-parser": "^0.156.0",
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
-    "@arethetypeswrong/core": "^0.18.1",
-    "@commitlint/cli": "^21.1.0",
-    "@commitlint/config-conventional": "^21.1.0",
-    "@types/node": "^22.10.0",
-    "publint": "^0.3.8",
-    "simple-git-hooks": "^2.13.1",
+    "@arethetypeswrong/core": "^0.18.5",
+    "@commitlint/cli": "^21.2.4",
+    "@commitlint/config-conventional": "^21.2.4",
+    "@types/node": "^22.20.5",
+    "publint": "^0.3.25",
+    "simple-git-hooks": "^2.14.0",
     "tsdown": "^0.21.10",
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
   },
   "keywords": [
     "ai",

package/schema.json

@@ -842,6 +842,10 @@
               "title": "borp plugin configuration (https://knip.dev/reference/plugins/borp)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "buf": {
+              "title": "buf plugin configuration (https://knip.dev/reference/plugins/buf)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "bumpp": {
               "title": "bumpp plugin configuration (https://knip.dev/reference/plugins/bumpp)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -922,6 +926,10 @@
               "title": "Drizzle plugin configuration (https://knip.dev/reference/plugins/drizzle)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "electron-forge": {
+              "title": "Electron Forge plugin configuration (https://knip.dev/reference/plugins/electron-forge)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "electron-vite": {
               "title": "electron-vite plugin configuration (https://knip.dev/reference/plugins/electron-vite)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -950,6 +958,10 @@
               "title": "Expo plugin configuration (https://knip.dev/reference/plugins/expo)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "expo-router": {
+              "title": "Expo Router plugin configuration (https://knip.dev/reference/plugins/expo-router)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "expressive-code": {
               "title": "expressive-code plugin configuration (https://knip.dev/reference/plugins/expressive-code)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -958,6 +970,14 @@
               "title": "fast plugin configuration (https://knip.dev/reference/plugins/fast)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "filesystem-routing": {
+              "title": "filesystem-routing plugin configuration (https://knip.dev/reference/plugins/filesystem-routing)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
+            "flue": {
+              "title": "flue plugin configuration (https://knip.dev/reference/plugins/flue)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "fumadocs": {
               "title": "fumadocs plugin configuration (https://knip.dev/reference/plugins/fumadocs)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -990,6 +1010,10 @@
               "title": "i18next-parser plugin configuration (https://knip.dev/reference/plugins/i18next-parser)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "jasmine": {
+              "title": "jasmine plugin configuration (https://knip.dev/reference/plugins/jasmine)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "jest": {
               "title": "Jest plugin configuration (https://knip.dev/reference/plugins/jest)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -1002,6 +1026,10 @@
               "title": "knex plugin configuration (https://knip.dev/reference/plugins/knex)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "kysely-codegen": {
+              "title": "kysely-codegen plugin configuration (https://knip.dev/reference/plugins/kysely-codegen)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "ladle": {
               "title": "ladle plugin configuration (https://knip.dev/reference/plugins/ladle)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -1014,6 +1042,10 @@
               "title": "lefthook plugin configuration (https://knip.dev/reference/plugins/lefthook)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "lingui": {
+              "title": "lingui plugin configuration (https://knip.dev/reference/plugins/lingui)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "lint-staged": {
               "title": "lint-staged plugin configuration (https://knip.dev/reference/plugins/lint-staged)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -1046,6 +1078,14 @@
               "title": "marko plugin configuration (https://knip.dev/reference/plugins/marko)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "mastra": {
+              "title": "mastra plugin configuration (https://knip.dev/reference/plugins/mastra)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
+            "mcp": {
+              "title": "mcp plugin configuration (https://knip.dev/reference/plugins/mcp)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "mdx": {
               "title": "mdx plugin configuration (https://knip.dev/reference/plugins/mdx)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -1158,6 +1198,10 @@
               "title": "orval plugin configuration (https://knip.dev/reference/plugins/orval)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "osls": {
+              "title": "osls plugin configuration (https://knip.dev/reference/plugins/osls)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "oxfmt": {
               "title": "oxfmt plugin configuration (https://knip.dev/reference/plugins/oxfmt)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -1218,6 +1262,10 @@
               "title": "Prisma plugin configuration (https://knip.dev/reference/plugins/prisma)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "purgecss": {
+              "title": "purgecss plugin configuration (https://knip.dev/reference/plugins/purgecss)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "quasar": {
               "title": "quasar plugin configuration (https://knip.dev/reference/plugins/quasar)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -1310,6 +1358,10 @@
               "title": "size-limit plugin configuration (https://knip.dev/reference/plugins/size-limit)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "solidjs-vite-plugin": {
+              "title": "solidjs-vite-plugin plugin configuration (https://knip.dev/reference/plugins/solidjs-vite-plugin)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "sst": {
               "title": "sst plugin configuration (https://knip.dev/reference/plugins/sst)",
               "$ref": "#/definitions/knip/definitions/plugin"
@@ -1402,6 +1454,10 @@
               "title": "tsdown plugin configuration (https://knip.dev/reference/plugins/tsdown)",
               "$ref": "#/definitions/knip/definitions/plugin"
             },
+            "tsrs": {
+              "title": "tsrs plugin configuration (https://knip.dev/reference/plugins/tsrs)",
+              "$ref": "#/definitions/knip/definitions/plugin"
+            },
             "tsup": {
               "title": "tsup plugin configuration (https://knip.dev/reference/plugins/tsup)",
               "$ref": "#/definitions/knip/definitions/plugin"