pruneguard 0.3.1 → 0.4.1

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.1",
+  "version": "0.4.1",
   "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.1",
-    "@pruneguard/cli-darwin-x64": "0.3.1",
-    "@pruneguard/cli-linux-arm64-gnu": "0.3.1",
-    "@pruneguard/cli-linux-arm64-musl": "0.3.1",
-    "@pruneguard/cli-linux-x64-gnu": "0.3.1",
-    "@pruneguard/cli-linux-x64-musl": "0.3.1",
-    "@pruneguard/cli-win32-arm64-msvc": "0.3.1",
-    "@pruneguard/cli-win32-x64-msvc": "0.3.1"
+    "@pruneguard/cli-darwin-arm64": "0.4.1",
+    "@pruneguard/cli-darwin-x64": "0.4.1",
+    "@pruneguard/cli-linux-arm64-gnu": "0.4.1",
+    "@pruneguard/cli-linux-arm64-musl": "0.4.1",
+    "@pruneguard/cli-linux-x64-gnu": "0.4.1",
+    "@pruneguard/cli-linux-x64-musl": "0.4.1",
+    "@pruneguard/cli-win32-arm64-msvc": "0.4.1",
+    "@pruneguard/cli-win32-x64-msvc": "0.4.1"
   },
   "engines": {
     "node": ">=18.0.0"

package/report_schema.json

@@ -41,6 +41,17 @@
         }
       ]
     },
+    "parityScore": {
+      "description": "External parity corpus score, if available.",
+      "anyOf": [
+        {
+          "$ref": "#/definitions/ExternalParityReport"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
     "profile": {
       "description": "The profile used for this analysis.",
       "type": "string"
@@ -191,6 +202,218 @@
         "daemon"
       ]
     },
+    "ExternalParityCaseResult": {
+      "description": "Result of a single parity case in the external report.",
+      "type": "object",
+      "required": [
+        "family",
+        "name",
+        "passed",
+        "passedChecks",
+        "referenceTool",
+        "totalChecks"
+      ],
+      "properties": {
+        "failures": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "family": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "passed": {
+          "type": "boolean"
+        },
+        "passedChecks": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "referenceTool": {
+          "type": "string"
+        },
+        "totalChecks": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        }
+      }
+    },
+    "ExternalParityFamilyScore": {
+      "description": "Per-family score in the external parity report.",
+      "type": "object",
+      "required": [
+        "family",
+        "passedCases",
+        "pct",
+        "totalCases"
+      ],
+      "properties": {
+        "family": {
+          "type": "string"
+        },
+        "passedCases": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "pct": {
+          "type": "number",
+          "format": "double"
+        },
+        "totalCases": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        }
+      }
+    },
+    "ExternalParityReport": {
+      "description": "External parity report from the fixture-derived corpus.",
+      "type": "object",
+      "required": [
+        "overallPct",
+        "passedCases",
+        "passedChecks",
+        "totalCases",
+        "totalChecks"
+      ],
+      "properties": {
+        "byFamily": {
+          "description": "Per-family parity breakdown.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExternalParityFamilyScore"
+          }
+        },
+        "byReferenceTool": {
+          "description": "Per-reference-tool parity breakdown.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExternalParityToolScore"
+          }
+        },
+        "caseResults": {
+          "description": "Individual case results.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExternalParityCaseResult"
+          }
+        },
+        "overallPct": {
+          "description": "Overall parity percentage (0-100).",
+          "type": "number",
+          "format": "double"
+        },
+        "passedCases": {
+          "description": "Number of fully passing cases.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "passedChecks": {
+          "description": "Number of individual checks that passed.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "staleDeltas": {
+          "description": "Stale matrix deltas (features where the hand-authored tracker disagrees with reality).",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ParityStaleDelta"
+          }
+        },
+        "totalCases": {
+          "description": "Total number of parity test cases.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "totalChecks": {
+          "description": "Total number of individual checks across all cases.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        }
+      }
+    },
+    "ExternalParitySummary": {
+      "description": "Summary of external parity score for the stats section.",
+      "type": "object",
+      "required": [
+        "overallPct",
+        "passedCases",
+        "passedChecks",
+        "totalCases",
+        "totalChecks"
+      ],
+      "properties": {
+        "overallPct": {
+          "description": "Overall parity percentage (0-100).",
+          "type": "number",
+          "format": "double"
+        },
+        "passedCases": {
+          "description": "Cases that fully passed.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "passedChecks": {
+          "description": "Individual checks that passed.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "totalCases": {
+          "description": "Total cases evaluated.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "totalChecks": {
+          "description": "Total individual checks.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        }
+      }
+    },
+    "ExternalParityToolScore": {
+      "description": "Per-tool score in the external parity report.",
+      "type": "object",
+      "required": [
+        "passedCases",
+        "pct",
+        "tool",
+        "totalCases"
+      ],
+      "properties": {
+        "passedCases": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "pct": {
+          "type": "number",
+          "format": "double"
+        },
+        "tool": {
+          "type": "string"
+        },
+        "totalCases": {
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        }
+      }
+    },
     "FileInfo": {
       "description": "Info about a discovered file.",
       "type": "object",
@@ -378,16 +601,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": {
@@ -487,6 +728,29 @@
         }
       }
     },
+    "ParityStaleDelta": {
+      "description": "A stale delta where the hand-authored parity matrix disagrees with actual test results.",
+      "type": "object",
+      "required": [
+        "actualLevel",
+        "feature",
+        "matrixLevel"
+      ],
+      "properties": {
+        "actualLevel": {
+          "description": "Actual level observed from test results.",
+          "type": "string"
+        },
+        "feature": {
+          "description": "Feature or test case name.",
+          "type": "string"
+        },
+        "matrixLevel": {
+          "description": "Level claimed in the parity matrix.",
+          "type": "string"
+        }
+      }
+    },
     "RemediationActionKind": {
       "description": "The kind of remediation action to take.",
       "type": "string",
@@ -619,6 +883,25 @@
             }
           ]
         },
+        "externalParity": {
+          "description": "External parity score summary, if available.",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ExternalParitySummary"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "externalParityPct": {
+          "description": "External parity score percentage (0-100), if computed.",
+          "type": [
+            "number",
+            "null"
+          ],
+          "format": "double"
+        },
         "filesCached": {
           "type": "integer",
           "format": "uint",
@@ -776,6 +1059,13 @@
           "format": "uint",
           "minimum": 0.0
         },
+        "unsupportedFrameworks": {
+          "description": "Names of unsupported frameworks detected in the workspace.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "watcherLagMs": {
           "description": "Lag of the file-system watcher in milliseconds.",
           "type": [