pruneguard 0.3.0 → 0.4.0

package/README.md

@@ -60,9 +60,6 @@ Commands:
   debug entrypoints           List detected entrypoints
   debug runtime               Print runtime diagnostics
   daemon start|stop|status    Manage the background daemon
-  migrate knip                Convert knip config to pruneguard
-  migrate depcruise           Convert dependency-cruiser config to pruneguard
-
 Options:
   -c, --config <FILE>          Config file path [default: pruneguard.json]
       --format <FORMAT>        Output format: text, json, sarif, dot
@@ -127,8 +124,6 @@ import {
   loadConfig,
   schemaPath,
   scanDot,
-  migrateKnip,
-  migrateDepcruise,
 } from "pruneguard";
 ```
 
@@ -204,8 +199,6 @@ const config = await loadConfig();
 const schema = schemaPath();
 const dot = await scanDot();
 const rules = await suggestRules();
-const knip = await migrateKnip();
-const dc = await migrateDepcruise();
 ```
 
 ### Error handling
@@ -374,17 +367,6 @@ jobs:
 
 ---
 
-## Migrating from other tools
-
-```sh
-pruneguard migrate knip           # reads knip.json or package.json#knip
-pruneguard migrate depcruise      # reads .dependency-cruiser.* files
-```
-
-Both commands emit an equivalent `pruneguard.json` with migration notes.
-
----
-
 ## Framework detection
 
 | Framework | Auto-detected via | Entrypoints added |

package/configuration_schema.json

@@ -21,7 +21,10 @@
         "cycles": "warn",
         "boundaries": "warn",
         "ownership": "warn",
-        "impact": "warn"
+        "impact": "warn",
+        "unusedMembers": "warn",
+        "duplicateExports": "warn",
+        "ignoreExportsUsedInFile": false
       },
       "allOf": [
         {
@@ -34,7 +37,8 @@
       "default": {
         "auto": true,
         "includeTests": false,
-        "includeStories": false
+        "includeStories": false,
+        "includeEntryExports": false
       },
       "allOf": [
         {
@@ -63,6 +67,13 @@
         }
       ]
     },
+    "ignoreIssues": {
+      "description": "Suppress specific finding kinds from the report.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/IgnoreIssueRule"
+      }
+    },
     "ignorePatterns": {
       "description": "Glob patterns for files to ignore entirely.",
       "type": "array",
@@ -92,7 +103,18 @@
       "description": "Module resolver configuration.",
       "default": {
         "respectExports": true,
-        "preserveSymlinks": false
+        "preserveSymlinks": false,
+        "detectRequireResolve": true,
+        "detectImportMetaResolve": true,
+        "detectImportMetaGlob": true,
+        "detectRequireContext": true,
+        "detectUrlConstructor": true,
+        "detectJsdocImports": true,
+        "detectTripleSlash": true,
+        "detectImportEquals": true,
+        "detectTypeImports": true,
+        "detectWebpackAliases": true,
+        "detectBabelAliases": true
       },
       "allOf": [
         {
@@ -143,6 +165,20 @@
             }
           ]
         },
+        "duplicateExports": {
+          "description": "Report duplicate exports (same symbol re-exported from multiple paths).",
+          "default": "warn",
+          "allOf": [
+            {
+              "$ref": "#/definitions/AnalysisSeverity"
+            }
+          ]
+        },
+        "ignoreExportsUsedInFile": {
+          "description": "When true, exports consumed only within the same file are still reported as unused.",
+          "default": false,
+          "type": "boolean"
+        },
         "impact": {
           "default": "warn",
           "allOf": [
@@ -183,6 +219,15 @@
             }
           ]
         },
+        "unusedMembers": {
+          "description": "Report unused exported class/enum members (methods, properties, variants).",
+          "default": "warn",
+          "allOf": [
+            {
+              "$ref": "#/definitions/AnalysisSeverity"
+            }
+          ]
+        },
         "unusedPackages": {
           "default": "warn",
           "allOf": [
@@ -225,6 +270,11 @@
             "type": "string"
           }
         },
+        "includeEntryExports": {
+          "description": "When true, runtime entrypoint exports are eligible to be reported as unused.  By default (`false`), only public-API entrypoint exports are checked.",
+          "default": false,
+          "type": "boolean"
+        },
         "includeStories": {
           "description": "Whether to include story files as entrypoints.",
           "default": false,
@@ -259,6 +309,46 @@
     "FrameworksConfig": {
       "type": "object",
       "properties": {
+        "angular": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "astro": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "cypress": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "docusaurus": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "jest": {
           "anyOf": [
             {
@@ -279,6 +369,46 @@
             }
           ]
         },
+        "nuxt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "nx": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "playwright": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "remix": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "storybook": {
           "anyOf": [
             {
@@ -289,6 +419,26 @@
             }
           ]
         },
+        "sveltekit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "turborepo": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "vite": {
           "anyOf": [
             {
@@ -299,6 +449,16 @@
             }
           ]
         },
+        "vitepress": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/FrameworkToggle"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "vitest": {
           "anyOf": [
             {
@@ -311,6 +471,68 @@
         }
       }
     },
+    "IgnoreIssueRule": {
+      "description": "Rule for suppressing specific finding kinds.",
+      "type": "object",
+      "required": [
+        "kind"
+      ],
+      "properties": {
+        "codes": {
+          "description": "Additional finding codes to match (beyond the primary `kind`).",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "comment": {
+          "description": "Optional comment explaining why this is suppressed.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "files": {
+          "description": "Optional glob patterns — only suppress in matching files.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "kind": {
+          "description": "The finding kind to suppress (e.g. \"unusedExport\", \"unusedFile\", \"cycle\").",
+          "type": "string"
+        },
+        "packages": {
+          "description": "Package names to scope this rule to.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "parentSymbols": {
+          "description": "Parent symbol names to scope this rule to.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "symbols": {
+          "description": "Symbol names to scope this rule to.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "workspaces": {
+          "description": "Workspace names to scope this rule to.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "OverrideConfig": {
       "type": "object",
       "properties": {
@@ -444,6 +666,61 @@
             "type": "string"
           }
         },
+        "detectBabelAliases": {
+          "description": "Whether to detect Babel alias patterns.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectImportEquals": {
+          "description": "Whether to detect TypeScript `import =` statements.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectImportMetaGlob": {
+          "description": "Whether to detect `import.meta.glob()` calls.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectImportMetaResolve": {
+          "description": "Whether to detect `import.meta.resolve()` calls.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectJsdocImports": {
+          "description": "Whether to detect JSDoc `@import` tags.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectRequireContext": {
+          "description": "Whether to detect `require.context()` calls.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectRequireResolve": {
+          "description": "Whether to detect `require.resolve()` calls.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectTripleSlash": {
+          "description": "Whether to detect triple-slash reference directives.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectTypeImports": {
+          "description": "Whether to detect type-only imports.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectUrlConstructor": {
+          "description": "Whether to detect `new URL()` constructor patterns.",
+          "default": true,
+          "type": "boolean"
+        },
+        "detectWebpackAliases": {
+          "description": "Whether to detect webpack alias patterns.",
+          "default": true,
+          "type": "boolean"
+        },
         "extensions": {
           "description": "File extensions to resolve.",
           "type": "array",

package/daemon_status_report_schema.json

@@ -0,0 +1,183 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "DaemonStatusReport",
+  "description": "Daemon status report for querying daemon health from JS or CLI.",
+  "type": "object",
+  "required": [
+    "running"
+  ],
+  "properties": {
+    "binaryPath": {
+      "description": "Absolute path to the daemon binary.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "configChangePending": {
+      "description": "Whether a config-level change is pending that requires full rebuild.",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "generation": {
+      "description": "Current generation (rebuild counter) of the index.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    },
+    "graphEdges": {
+      "description": "Number of edges in the module graph.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint",
+      "minimum": 0.0
+    },
+    "graphNodes": {
+      "description": "Number of nodes in the module graph.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint",
+      "minimum": 0.0
+    },
+    "incrementalRebuilds": {
+      "description": "Number of incremental rebuilds since daemon start.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    },
+    "indexWarm": {
+      "description": "Whether the hot index has been warmed (initial build complete).",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "initialBuildMs": {
+      "description": "Milliseconds the initial graph build took.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    },
+    "lastRebuildMs": {
+      "description": "Milliseconds the last incremental rebuild took.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    },
+    "lastUpdateMs": {
+      "description": "Milliseconds since the last graph update.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    },
+    "pendingInvalidations": {
+      "description": "Number of files pending invalidation.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint",
+      "minimum": 0.0
+    },
+    "pid": {
+      "description": "Process ID of the running daemon, if any.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint32",
+      "minimum": 0.0
+    },
+    "port": {
+      "description": "TCP port the daemon is listening on, if any.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint16",
+      "minimum": 0.0
+    },
+    "projectRoot": {
+      "description": "Absolute path to the project root the daemon is serving.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "running": {
+      "description": "Whether a daemon process is currently running.",
+      "type": "boolean"
+    },
+    "startedAt": {
+      "description": "ISO-8601 timestamp when the daemon started.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "totalInvalidations": {
+      "description": "Total number of files invalidated since daemon start.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    },
+    "uptimeSecs": {
+      "description": "Uptime of the daemon in seconds.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    },
+    "version": {
+      "description": "Version of the running daemon binary.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "watchedFiles": {
+      "description": "Number of files being watched for changes.",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint",
+      "minimum": 0.0
+    },
+    "watcherLagMs": {
+      "description": "Milliseconds of watcher lag (time since last fs event was processed).",
+      "type": [
+        "integer",
+        "null"
+      ],
+      "format": "uint64",
+      "minimum": 0.0
+    }
+  }
+}