pruneguard 0.5.0 → 0.5.1

package/configuration_schema.json

@@ -134,6 +134,22 @@
         }
       ]
     },
+    "semantic": {
+      "description": "Semantic precision layer configuration.",
+      "default": {
+        "mode": "auto",
+        "maxColdOverheadPct": 20,
+        "maxFilesPerQueryBatch": 128,
+        "maxProjectRefs": 8,
+        "maxHelperWallMs": 1200,
+        "minUncertaintyScore": 60
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/SemanticConfig"
+        }
+      ]
+    },
     "workspaces": {
       "description": "Workspace configuration.",
       "anyOf": [
@@ -1064,6 +1080,65 @@
         }
       }
     },
+    "SemanticConfig": {
+      "description": "Configuration for the optional semantic precision layer.",
+      "type": "object",
+      "properties": {
+        "maxColdOverheadPct": {
+          "description": "Maximum percentage of cold-scan overhead the helper is allowed to add (0-100).",
+          "default": 20,
+          "type": "integer",
+          "format": "uint8",
+          "minimum": 0.0
+        },
+        "maxFilesPerQueryBatch": {
+          "description": "Maximum files to include in a single query batch to the helper.",
+          "default": 128,
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "maxHelperWallMs": {
+          "description": "Maximum wall-clock milliseconds the helper is allowed to run.",
+          "default": 1200,
+          "type": "integer",
+          "format": "uint64",
+          "minimum": 0.0
+        },
+        "maxProjectRefs": {
+          "description": "Maximum number of TypeScript project references to traverse.",
+          "default": 8,
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "minUncertaintyScore": {
+          "description": "Minimum uncertainty score (0-100) a candidate must have before being sent to the semantic helper. Lower values mean more candidates are refined.",
+          "default": 60,
+          "type": "integer",
+          "format": "uint8",
+          "minimum": 0.0
+        },
+        "mode": {
+          "description": "Whether to use the semantic helper: off, auto (default), or required.",
+          "default": "auto",
+          "allOf": [
+            {
+              "$ref": "#/definitions/SemanticMode"
+            }
+          ]
+        }
+      }
+    },
+    "SemanticMode": {
+      "description": "Mode for the optional semantic precision helper.",
+      "type": "string",
+      "enum": [
+        "off",
+        "auto",
+        "required"
+      ]
+    },
     "TeamConfig": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pruneguard",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Repo truth engine for JS/TS monorepos",
   "keywords": [
     "javascript",
@@ -45,14 +45,14 @@
     }
   },
   "optionalDependencies": {
-    "@pruneguard/cli-darwin-arm64": "0.5.0",
-    "@pruneguard/cli-darwin-x64": "0.5.0",
-    "@pruneguard/cli-linux-arm64-gnu": "0.5.0",
-    "@pruneguard/cli-linux-arm64-musl": "0.5.0",
-    "@pruneguard/cli-linux-x64-gnu": "0.5.0",
-    "@pruneguard/cli-linux-x64-musl": "0.5.0",
-    "@pruneguard/cli-win32-arm64-msvc": "0.5.0",
-    "@pruneguard/cli-win32-x64-msvc": "0.5.0"
+    "@pruneguard/cli-darwin-arm64": "0.5.1",
+    "@pruneguard/cli-darwin-x64": "0.5.1",
+    "@pruneguard/cli-linux-arm64-gnu": "0.5.1",
+    "@pruneguard/cli-linux-arm64-musl": "0.5.1",
+    "@pruneguard/cli-linux-x64-gnu": "0.5.1",
+    "@pruneguard/cli-linux-x64-musl": "0.5.1",
+    "@pruneguard/cli-win32-arm64-msvc": "0.5.1",
+    "@pruneguard/cli-win32-x64-msvc": "0.5.1"
   },
   "engines": {
     "node": ">=18.0.0"

package/report_schema.json

@@ -512,6 +512,13 @@
             }
           ]
         },
+        "confidenceReason": {
+          "description": "Human-readable reason for the confidence level assigned to this finding.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
         "evidence": {
           "description": "Evidence supporting the finding.",
           "type": "array",
@@ -544,6 +551,17 @@
             "null"
           ]
         },
+        "precisionSource": {
+          "description": "Source of precision for this finding's evidence.",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/PrecisionSource"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "primaryActionKind": {
           "description": "Primary remediation action kind for this finding.",
           "anyOf": [
@@ -751,6 +769,39 @@
         }
       }
     },
+    "PrecisionSource": {
+      "description": "Source of the precision for a finding's evidence.",
+      "oneOf": [
+        {
+          "description": "Rust static analysis only.",
+          "type": "string",
+          "enum": [
+            "rust-static"
+          ]
+        },
+        {
+          "description": "Derived from framework-generated source maps or .d.ts files.",
+          "type": "string",
+          "enum": [
+            "generated-map"
+          ]
+        },
+        {
+          "description": "Derived from framework config file extraction.",
+          "type": "string",
+          "enum": [
+            "config-derived"
+          ]
+        },
+        {
+          "description": "Refined by the semantic helper binary.",
+          "type": "string",
+          "enum": [
+            "semantic-helper"
+          ]
+        }
+      ]
+    },
     "RemediationActionKind": {
       "description": "The kind of remediation action to take.",
       "type": "string",
@@ -767,6 +818,46 @@
         "acknowledge-baseline"
       ]
     },
+    "ReplacementFamilyScore": {
+      "description": "Per-family replacement score for the weighted replacement metric.",
+      "type": "object",
+      "required": [
+        "family",
+        "passedCases",
+        "score",
+        "tier",
+        "totalCases"
+      ],
+      "properties": {
+        "family": {
+          "description": "Family name (e.g. \"vite\", \"next\", \"jest\").",
+          "type": "string"
+        },
+        "passedCases": {
+          "description": "Passing test cases in this family.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "score": {
+          "description": "Replacement score for this family (0-100).",
+          "type": "number",
+          "format": "double"
+        },
+        "tier": {
+          "description": "Tier of this family (1 or 2).",
+          "type": "integer",
+          "format": "uint8",
+          "minimum": 0.0
+        },
+        "totalCases": {
+          "description": "Total test cases in this family.",
+          "type": "integer",
+          "format": "uint",
+          "minimum": 0.0
+        }
+      }
+    },
     "Stats": {
       "description": "Performance statistics.",
       "type": "object",
@@ -1018,6 +1109,21 @@
             "null"
           ]
         },
+        "replacementFamilyScores": {
+          "description": "Per-family replacement scores.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReplacementFamilyScore"
+          }
+        },
+        "replacementScore": {
+          "description": "Weighted replacement score (0-100) against the external parity corpus.",
+          "type": [
+            "number",
+            "null"
+          ],
+          "format": "double"
+        },
         "resolvedViaExports": {
           "type": "integer",
           "format": "uint",
@@ -1041,6 +1147,61 @@
           "format": "uint",
           "minimum": 0.0
         },
+        "semanticFiles": {
+          "description": "Number of files sent to the semantic helper.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "semanticMode": {
+          "description": "Semantic helper mode used for this analysis.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "semanticProjects": {
+          "description": "Number of TypeScript projects loaded by the semantic helper.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "semanticQueries": {
+          "description": "Number of queries sent to the semantic helper.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "semanticSkippedReason": {
+          "description": "Reason the semantic helper was skipped, if applicable.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "semanticUsed": {
+          "description": "Whether the semantic helper was actually invoked.",
+          "default": false,
+          "type": "boolean"
+        },
+        "semanticWallMs": {
+          "description": "Wall-clock milliseconds spent in the semantic helper.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint64",
+          "minimum": 0.0
+        },
         "strictTrustApplied": {
           "description": "Whether strict trust mode was applied.",
           "default": false,