pruneguard 0.3.0 → 0.4.0

package/dist/index.d.mts

@@ -126,6 +126,8 @@ type AnalysisReport = {
     ruleName?: string;
     primaryActionKind?: string;
     actionKinds?: string[];
+    trustNotes?: string[];
+    frameworkContext?: string[];
   }>;
   entrypoints: Array<{
     path: string;
@@ -133,6 +135,9 @@ type AnalysisReport = {
     profile: string;
     workspace?: string;
     source: string;
+    framework?: string;
+    reason?: string;
+    heuristic?: boolean;
   }>;
   stats: {
     durationMs: number;
@@ -147,6 +152,7 @@ type AnalysisReport = {
       tsconfigPathMiss: number;
       exportsConditionMiss: number;
       externalized: number;
+      workspaceExportsMiss: number;
     };
     resolvedViaExports: number;
     entrypointsDetected: number;
@@ -177,6 +183,16 @@ type AnalysisReport = {
     cacheEntriesRead: number;
     cacheEntriesWritten: number;
     affectedScopeIncomplete: boolean;
+    frameworksDetected: string[];
+    heuristicFrameworks: string[];
+    heuristicEntrypoints: number;
+    compatibilityWarnings: string[];
+    strictTrustApplied: boolean;
+    frameworkConfidenceCounts: {
+      exact: number;
+      heuristic: number;
+      unsupported: number;
+    };
     executionMode?: "oneshot" | "daemon";
     indexWarm?: boolean;
     indexAgeMs?: number;
@@ -223,6 +239,7 @@ type ReviewOptions = {
   baseRef?: string;
   noCache?: boolean;
   noBaseline?: boolean;
+  strictTrust?: boolean;
 };
 type ReviewReport = {
   baseRef?: string;
@@ -239,6 +256,7 @@ type ReviewReport = {
       medium: number;
       low: number;
     };
+    executionMode?: "oneshot" | "daemon";
   };
   recommendations: string[];
   proposedActions?: Array<{
@@ -256,6 +274,15 @@ type ReviewReport = {
     risk: "low" | "medium" | "high";
     confidence: "high" | "medium" | "low";
   }>;
+  compatibilityWarnings?: string[];
+  strictTrustApplied?: boolean;
+  recommendedActions?: Array<{
+    kind: string;
+    description: string;
+    priority: number;
+    command?: string;
+    targets?: string[];
+  }>;
   executionMode?: "oneshot" | "daemon";
   latencyMs?: number;
 };
@@ -270,20 +297,45 @@ type SafeDeleteReport = {
   targets: string[];
   safe: Array<{
     target: string;
+    classification: "safe" | "needs-review" | "blocked";
     confidence?: "high" | "medium" | "low";
     reasons: string[];
+    evidence: Array<{
+      kind: string;
+      file?: string;
+      line?: number;
+      description: string;
+    }>;
   }>;
   needsReview: Array<{
     target: string;
+    classification: "safe" | "needs-review" | "blocked";
     confidence?: "high" | "medium" | "low";
     reasons: string[];
+    evidence: Array<{
+      kind: string;
+      file?: string;
+      line?: number;
+      description: string;
+    }>;
   }>;
   blocked: Array<{
     target: string;
+    classification: "safe" | "needs-review" | "blocked";
     confidence?: "high" | "medium" | "low";
     reasons: string[];
+    evidence: Array<{
+      kind: string;
+      file?: string;
+      line?: number;
+      description: string;
+    }>;
+  }>;
+  deletionOrder: Array<{
+    target: string;
+    step: number;
+    reason?: string;
   }>;
-  deletionOrder: string[];
   evidence: Array<{
     kind: string;
     file?: string;
@@ -312,26 +364,41 @@ type SuggestRulesReport = {
     configFragment: Record<string, unknown>;
     confidence: "high" | "medium" | "low";
     evidence?: string[];
+    rationale?: string;
   }>;
   tags?: Array<{
     name: string;
     glob: string;
     rationale: string;
+    source?: string;
   }>;
   ownershipHints?: Array<{
     pathGlob: string;
     suggestedOwner: string;
     crossTeamEdges: number;
     rationale: string;
+    touchedPackages?: string[];
   }>;
   hotspots?: Array<{
     file: string;
+    workspace?: string;
+    package?: string;
     crossPackageImports: number;
     crossOwnerImports: number;
     incomingEdges: number;
     outgoingEdges: number;
+    rank: number;
+    teamsInvolved?: string[];
     suggestion: string;
   }>;
+  governanceActions?: Array<{
+    priority: number;
+    kind: string;
+    description: string;
+    effort: "low" | "medium" | "high";
+    impact: "low" | "medium" | "high";
+    configFragment?: Record<string, unknown>;
+  }>;
   rationale?: string[];
 };
 type FixPlanReport = {
@@ -351,11 +418,22 @@ type FixPlanReport = {
     verification: string[];
     risk: "low" | "medium" | "high";
     confidence: "high" | "medium" | "low";
+    rank?: number;
+    phase?: string;
+    findingIds: string[];
   }>;
   blockedBy: string[];
   verificationSteps: string[];
   riskLevel: "low" | "medium" | "high";
   confidence: "high" | "medium" | "low";
+  totalActions: number;
+  highConfidenceActions: number;
+  phaseSummary: Array<{
+    name: string;
+    order: number;
+    actionCount: number;
+    description: string;
+  }>;
 };
 type DaemonStatusReport = {
   running: boolean;
@@ -364,6 +442,72 @@ type DaemonStatusReport = {
   version?: string;
   startedAt?: string;
   projectRoot?: string;
+  indexWarm?: boolean;
+  lastUpdateMs?: number;
+  graphNodes?: number;
+  graphEdges?: number;
+  watchedFiles?: number;
+  watcherLagMs?: number;
+  pendingInvalidations?: number;
+  generation?: number;
+  uptimeSecs?: number;
+  binaryPath?: string;
+  initialBuildMs?: number;
+  lastRebuildMs?: number;
+  incrementalRebuilds?: number;
+  totalInvalidations?: number;
+  configChangePending?: boolean;
+};
+type CompatibilityReportOptions = {
+  cwd?: string;
+  config?: string;
+  profile?: Profile;
+};
+type DebugFrameworksOptions = {
+  cwd?: string;
+  config?: string;
+  profile?: Profile;
+};
+type CompatibilityReport = {
+  supportedFrameworks: string[];
+  heuristicFrameworks: string[];
+  unsupportedSignals: Array<{
+    signal: string;
+    source: string;
+    suggestion?: string;
+  }>;
+  warnings: Array<{
+    code: string;
+    message: string;
+    affectedScope?: string;
+    severity: "low" | "medium" | "high";
+  }>;
+  trustDowngrades: Array<{
+    reason: string;
+    scope: string;
+    severity: "low" | "medium" | "high";
+  }>;
+};
+type FrameworkDebugReport = {
+  detectedPacks: Array<{
+    name: string;
+    confidence: string;
+    signals: string[];
+    reasons: string[];
+  }>;
+  allEntrypoints: Array<{
+    path: string;
+    framework: string;
+    kind: string;
+    heuristic: boolean;
+    reason: string;
+  }>;
+  allIgnorePatterns: string[];
+  allClassificationRules: Array<{
+    pattern: string;
+    classification: string;
+  }>;
+  heuristicDetections: string[];
 };
 declare function scan(options?: ScanOptions): Promise<AnalysisReport>;
 declare function scanDot(options?: ScanOptions): Promise<string>;
@@ -397,5 +541,7 @@ declare function migrateDepcruise(options?: {
 declare function daemonStatus(options?: {
   cwd?: string;
 }): Promise<DaemonStatusReport>;
+declare function compatibilityReport(options?: CompatibilityReportOptions): Promise<CompatibilityReport>;
+declare function debugFrameworks(options?: DebugFrameworksOptions): Promise<FrameworkDebugReport>;
 //#endregion
-export { AnalysisReport, type CommandResult, DaemonStatusReport, DebugEntrypointsOptions, DebugResolveOptions, ExplainOptions, ExplainReport, FixPlanOptions, FixPlanReport, ImpactOptions, ImpactReport, MigrationOutput, Profile, PruneguardConfig, PruneguardExecutionError, type ResolutionInfo, type ResolutionSource, ReviewOptions, ReviewReport, SafeDeleteOptions, SafeDeleteReport, ScanOptions, SuggestRulesOptions, SuggestRulesReport, binaryPath, daemonStatus, debugEntrypoints, debugResolve, explain, fixPlan, impact, loadConfig, migrateDepcruise, migrateKnip, resolutionInfo, review, run, safeDelete, scan, scanDot, schemaPath, suggestRules };
+export { AnalysisReport, type CommandResult, CompatibilityReport, CompatibilityReportOptions, DaemonStatusReport, DebugEntrypointsOptions, DebugFrameworksOptions, DebugResolveOptions, ExplainOptions, ExplainReport, FixPlanOptions, FixPlanReport, FrameworkDebugReport, ImpactOptions, ImpactReport, MigrationOutput, Profile, PruneguardConfig, PruneguardExecutionError, type ResolutionInfo, type ResolutionSource, ReviewOptions, ReviewReport, SafeDeleteOptions, SafeDeleteReport, ScanOptions, SuggestRulesOptions, SuggestRulesReport, binaryPath, compatibilityReport, daemonStatus, debugEntrypoints, debugFrameworks, debugResolve, explain, fixPlan, impact, loadConfig, migrateDepcruise, migrateKnip, resolutionInfo, review, run, safeDelete, scan, scanDot, schemaPath, suggestRules };

package/dist/index.mjs

@@ -126,6 +126,7 @@ async function review(options = {}) {
 	if (options.baseRef) args.push("--changed-since", options.baseRef);
 	if (options.noCache) args.push("--no-cache");
 	if (options.noBaseline) args.push("--no-baseline");
+	if (options.strictTrust) args.push("--strict-trust");
 	args.push("review");
 	const result = await run$1(args, { cwd: options.cwd });
 	if (result.exitCode !== 0 && result.exitCode !== 1) requireSuccess(result);
@@ -199,5 +200,21 @@ async function daemonStatus(options) {
 	}
 	return report;
 }
+async function compatibilityReport(options = {}) {
+	const args = ["--format", "json"];
+	pushGlobalFlags(args, options);
+	args.push("compatibility-report");
+	const result = await run$1(args, { cwd: options.cwd });
+	requireSuccess(result);
+	return parseJson(result);
+}
+async function debugFrameworks(options = {}) {
+	const args = ["--format", "json"];
+	pushGlobalFlags(args, options);
+	args.push("debug", "frameworks");
+	const result = await run$1(args, { cwd: options.cwd });
+	requireSuccess(result);
+	return parseJson(result);
+}
 //#endregion
-export { PruneguardExecutionError, binaryPath, daemonStatus, debugEntrypoints, debugResolve, explain, fixPlan, impact, loadConfig, migrateDepcruise, migrateKnip, resolutionInfo, review, run, safeDelete, scan, scanDot, schemaPath, suggestRules };
+export { PruneguardExecutionError, binaryPath, compatibilityReport, daemonStatus, debugEntrypoints, debugFrameworks, debugResolve, explain, fixPlan, impact, loadConfig, migrateDepcruise, migrateKnip, resolutionInfo, review, run, safeDelete, scan, scanDot, schemaPath, suggestRules };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pruneguard",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Repo truth engine for JS/TS monorepos",
   "keywords": [
     "javascript",
@@ -29,6 +29,8 @@
     "report_schema.json",
     "review_report_schema.json",
     "safe_delete_report_schema.json",
+    "suggest_rules_report_schema.json",
+    "daemon_status_report_schema.json",
     "dist",
     "README.md",
     "bin/pruneguard"
@@ -43,14 +45,14 @@
     }
   },
   "optionalDependencies": {
-    "@pruneguard/cli-darwin-arm64": "0.3.0",
-    "@pruneguard/cli-darwin-x64": "0.3.0",
-    "@pruneguard/cli-linux-arm64-gnu": "0.3.0",
-    "@pruneguard/cli-linux-arm64-musl": "0.3.0",
-    "@pruneguard/cli-linux-x64-gnu": "0.3.0",
-    "@pruneguard/cli-linux-x64-musl": "0.3.0",
-    "@pruneguard/cli-win32-arm64-msvc": "0.3.0",
-    "@pruneguard/cli-win32-x64-msvc": "0.3.0"
+    "@pruneguard/cli-darwin-arm64": "0.4.0",
+    "@pruneguard/cli-darwin-x64": "0.4.0",
+    "@pruneguard/cli-linux-arm64-gnu": "0.4.0",
+    "@pruneguard/cli-linux-arm64-musl": "0.4.0",
+    "@pruneguard/cli-linux-x64-gnu": "0.4.0",
+    "@pruneguard/cli-linux-x64-musl": "0.4.0",
+    "@pruneguard/cli-win32-arm64-msvc": "0.4.0",
+    "@pruneguard/cli-win32-x64-msvc": "0.4.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/report_schema.json

@@ -108,6 +108,20 @@
         "source"
       ],
       "properties": {
+        "framework": {
+          "description": "Framework that contributed this entrypoint, if any.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "heuristic": {
+          "description": "Whether this entrypoint was detected via heuristics.",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
         "kind": {
           "type": "string"
         },
@@ -117,6 +131,13 @@
         "profile": {
           "type": "string"
         },
+        "reason": {
+          "description": "Reason this entrypoint was detected.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
         "source": {
           "type": "string"
         },
@@ -275,6 +296,16 @@
             "$ref": "#/definitions/Evidence"
           }
         },
+        "frameworkContext": {
+          "description": "Framework context relevant to this finding.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
         "id": {
           "description": "Stable deterministic ID for this finding.",
           "type": "string"
@@ -327,6 +358,16 @@
             "null"
           ]
         },
+        "trustNotes": {
+          "description": "Trust-related notes for this finding.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
         "workspace": {
           "description": "Workspace this finding belongs to, if applicable.",
           "type": [
@@ -337,16 +378,34 @@
       }
     },
     "FindingCategory": {
-      "type": "string",
-      "enum": [
-        "unused-export",
-        "unused-file",
-        "unused-package",
-        "unused-dependency",
-        "cycle",
-        "boundary-violation",
-        "ownership-violation",
-        "impact"
+      "oneOf": [
+        {
+          "type": "string",
+          "enum": [
+            "unused-export",
+            "unused-file",
+            "unused-package",
+            "unused-dependency",
+            "cycle",
+            "boundary-violation",
+            "ownership-violation",
+            "impact"
+          ]
+        },
+        {
+          "description": "An exported class member, enum variant, or namespace member is unused.",
+          "type": "string",
+          "enum": [
+            "unused-member"
+          ]
+        },
+        {
+          "description": "The same symbol is exported from multiple paths (barrel re-export collision).",
+          "type": "string",
+          "enum": [
+            "duplicate-export"
+          ]
+        }
       ]
     },
     "FindingConfidence": {
@@ -365,6 +424,32 @@
         "info"
       ]
     },
+    "FrameworkConfidenceCounts": {
+      "description": "Breakdown of framework detection confidence levels.",
+      "type": "object",
+      "required": [
+        "exact",
+        "heuristic",
+        "unsupported"
+      ],
+      "properties": {
+        "exact": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "heuristic": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "unsupported": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        }
+      }
+    },
     "Inventories": {
       "description": "Inventories of discovered entities.",
       "type": "object",
@@ -521,6 +606,13 @@
           "format": "uint",
           "minimum": 0.0
         },
+        "compatibilityWarnings": {
+          "description": "Compatibility warnings from framework detection.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "confidenceCounts": {
           "$ref": "#/definitions/ConfidenceCounts"
         },
@@ -578,6 +670,26 @@
           "format": "uint",
           "minimum": 0.0
         },
+        "frameworkConfidenceCounts": {
+          "description": "Framework confidence breakdown.",
+          "default": {
+            "exact": 0,
+            "heuristic": 0,
+            "unsupported": 0
+          },
+          "allOf": [
+            {
+              "$ref": "#/definitions/FrameworkConfidenceCounts"
+            }
+          ]
+        },
+        "frameworksDetected": {
+          "description": "Frameworks detected during analysis.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "fullScopeRequired": {
           "type": "boolean"
         },
@@ -591,6 +703,20 @@
           "format": "uint",
           "minimum": 0.0
         },
+        "heuristicEntrypoints": {
+          "description": "Number of entrypoints added by heuristic detection.",
+          "default": 0,
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "heuristicFrameworks": {
+          "description": "Frameworks detected via heuristics (lower confidence).",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "indexAgeMs": {
           "description": "Age of the reused graph index in milliseconds.",
           "type": [
@@ -650,6 +776,11 @@
           "format": "uint",
           "minimum": 0.0
         },
+        "strictTrustApplied": {
+          "description": "Whether strict trust mode was applied.",
+          "default": false,
+          "type": "boolean"
+        },
         "suppressedFindings": {
           "type": "integer",
           "format": "uint",
@@ -764,6 +895,13 @@
           "type": "integer",
           "format": "uint",
           "minimum": 0.0
+        },
+        "workspaceExportsMiss": {
+          "description": "Subpath not declared in a workspace package's `exports` map.",
+          "default": 0,
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
         }
       }
     },