@aiready/doc-drift 0.13.4 → 0.13.6

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/doc-drift@0.13.4 build /Users/pengcao/projects/aiready/packages/doc-drift
+> @aiready/doc-drift@0.13.6 build /Users/pengcao/projects/aiready/packages/doc-drift
 > tsup src/index.ts src/cli.ts --format cjs,esm --dts
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -9,16 +9,16 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-ESM dist/chunk-5BGWZWHD.mjs 3.81 KB
-ESM dist/index.mjs          2.37 KB
+ESM dist/index.mjs          2.59 KB
 ESM dist/cli.mjs            1.39 KB
-ESM ⚡️ Build success in 200ms
-CJS dist/index.js 6.86 KB
-CJS dist/cli.js   6.48 KB
-CJS ⚡️ Build success in 200ms
+ESM dist/chunk-MAPV5YQR.mjs 4.40 KB
+ESM ⚡️ Build success in 55ms
+CJS dist/index.js 7.71 KB
+CJS dist/cli.js   7.11 KB
+CJS ⚡️ Build success in 56ms
 DTS Build start
-DTS ⚡️ Build success in 3500ms
+DTS ⚡️ Build success in 4610ms
 DTS dist/cli.d.ts    108.00 B
-DTS dist/index.d.ts  2.12 KB
+DTS dist/index.d.ts  2.83 KB
 DTS dist/cli.d.mts   108.00 B
-DTS dist/index.d.mts 2.12 KB
+DTS dist/index.d.mts 2.83 KB

package/.turbo/turbo-test.log

@@ -1,18 +1,18 @@
 
 
-> @aiready/doc-drift@0.13.3 test /Users/pengcao/projects/aiready/packages/doc-drift
+> @aiready/doc-drift@0.13.5 test /Users/pengcao/projects/aiready/packages/doc-drift
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/doc-drift
 
- ✓ src/__tests__/scoring.test.ts (2 tests) 12ms
- ✓ src/__tests__/analyzer.test.ts (1 test) 47ms
- ✓ src/__tests__/provider.test.ts (2 tests) 8ms
+ ✓ src/__tests__/provider.test.ts (2 tests) 7ms
+ ✓ src/__tests__/analyzer.test.ts (1 test) 316ms
+ ✓ src/__tests__/scoring.test.ts (2 tests) 47ms
 
  Test Files  3 passed (3)
       Tests  5 passed (5)
-   Start at  10:36:26
-   Duration  1.89s (transform 1.09s, setup 0ms, import 3.19s, tests 66ms, environment 0ms)
+   Start at  10:12:34
+   Duration  5.35s (transform 2.37s, setup 0ms, import 10.75s, tests 370ms, environment 5ms)
 
 [?25h

package/dist/{chunk-NWJ6PSNT.mjs → chunk-6EHZXHM7.mjs}

@@ -21,12 +21,11 @@ async function analyzeDocDrift(options) {
   const files = await scanFiles(options);
   const issues = [];
   const staleMonths = options.staleMonths ?? 6;
-  const staleSeconds = staleMonths * 30 * 24 * 60 * 60;
   let uncommentedExports = 0;
   let totalExports = 0;
   let outdatedComments = 0;
   let undocumentedComplexity = 0;
-  const now = Math.floor(Date.now() / 1e3);
+  let actualDrift = 0;
   let processed = 0;
   for (const file of files) {
     processed++;
@@ -63,10 +62,11 @@ async function analyzeDocDrift(options) {
             const docContent = doc.content;
             if (exp.type === "function" && exp.parameters) {
               const params = exp.parameters;
-              const missingParams = params.filter(
-                (p) => !docContent.includes(p) && !docContent.toLowerCase().includes(p.toLowerCase())
-              );
-              if (missingParams.length > 0 && params.length > 2) {
+              const missingParams = params.filter((p) => {
+                const regex = new RegExp(`\\b${p}\\b`, "i");
+                return !regex.test(docContent);
+              });
+              if (missingParams.length > 0) {
                 outdatedComments++;
                 issues.push({
                   type: IssueType.DocDrift,
@@ -74,10 +74,9 @@ async function analyzeDocDrift(options) {
                   message: `Documentation mismatch: function parameters (${missingParams.join(", ")}) are not mentioned in the docs.`,
                   location: { file, line: exp.loc?.start.line || 1 }
                 });
-                continue;
               }
             }
-            if (exp.loc) {
+            if (exp.loc && doc.loc) {
               if (!fileLineStamps) {
                 fileLineStamps = getFileCommitTimestamps(file);
               }
@@ -86,8 +85,21 @@ async function analyzeDocDrift(options) {
                 exp.loc.start.line,
                 exp.loc.end.line
               );
-              if (bodyModified > 0) {
-                if (now - bodyModified < staleSeconds / 4 && exp.documentation.isStale === true) {
+              const docModified = getLineRangeLastModifiedCached(
+                fileLineStamps,
+                doc.loc.start.line,
+                doc.loc.end.line
+              );
+              if (bodyModified > 0 && docModified > 0) {
+                const DRIFT_THRESHOLD_SECONDS = 24 * 60 * 60;
+                if (bodyModified - docModified > DRIFT_THRESHOLD_SECONDS) {
+                  actualDrift++;
+                  issues.push({
+                    type: IssueType.DocDrift,
+                    severity: Severity.Major,
+                    message: `Documentation drift: logic was modified on ${new Date(bodyModified * 1e3).toLocaleDateString()} but documentation was last updated on ${new Date(docModified * 1e3).toLocaleDateString()}.`,
+                    location: { file, line: doc.loc.start.line }
+                  });
                 }
               }
             }
@@ -103,7 +115,8 @@ async function analyzeDocDrift(options) {
     uncommentedExports,
     totalExports,
     outdatedComments,
-    undocumentedComplexity
+    undocumentedComplexity,
+    actualDrift
   });
   return {
     summary: {
@@ -117,7 +130,8 @@ async function analyzeDocDrift(options) {
       uncommentedExports,
       totalExports,
       outdatedComments,
-      undocumentedComplexity
+      undocumentedComplexity,
+      actualDrift
     },
     recommendations: riskResult.recommendations
   };

package/dist/chunk-MAPV5YQR.mjs

@@ -0,0 +1,142 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/analyzer.ts
+import {
+  scanFiles,
+  calculateDocDrift,
+  getFileCommitTimestamps,
+  getLineRangeLastModifiedCached,
+  Severity,
+  IssueType,
+  emitProgress,
+  getParser
+} from "@aiready/core";
+import { readFileSync } from "fs";
+async function analyzeDocDrift(options) {
+  const files = await scanFiles(options);
+  const issues = [];
+  let uncommentedExports = 0;
+  let totalExports = 0;
+  let outdatedComments = 0;
+  let undocumentedComplexity = 0;
+  let actualDrift = 0;
+  let processed = 0;
+  for (const file of files) {
+    processed++;
+    emitProgress(
+      processed,
+      files.length,
+      "doc-drift",
+      "analyzing files",
+      options.onProgress
+    );
+    const parser = getParser(file);
+    if (!parser) continue;
+    let code;
+    try {
+      code = readFileSync(file, "utf-8");
+    } catch {
+      continue;
+    }
+    try {
+      await parser.initialize();
+      const parseResult = parser.parse(code, file);
+      let fileLineStamps;
+      for (const exp of parseResult.exports) {
+        if (exp.type === "function" || exp.type === "class") {
+          totalExports++;
+          if (!exp.documentation) {
+            uncommentedExports++;
+            if (exp.loc) {
+              const lines = exp.loc.end.line - exp.loc.start.line;
+              if (lines > 20) undocumentedComplexity++;
+            }
+          } else {
+            const doc = exp.documentation;
+            const docContent = doc.content;
+            if (exp.type === "function" && exp.parameters) {
+              const params = exp.parameters;
+              const missingParams = params.filter((p) => {
+                const regex = new RegExp(`\\b${p}\\b`, "i");
+                return !regex.test(docContent);
+              });
+              if (missingParams.length > 0) {
+                outdatedComments++;
+                issues.push({
+                  type: IssueType.DocDrift,
+                  severity: Severity.Major,
+                  message: `Documentation mismatch: function parameters (${missingParams.join(", ")}) are not mentioned in the docs.`,
+                  location: { file, line: exp.loc?.start.line || 1 }
+                });
+              }
+            }
+            if (exp.loc && doc.loc) {
+              if (!fileLineStamps) {
+                fileLineStamps = getFileCommitTimestamps(file);
+              }
+              const bodyModified = getLineRangeLastModifiedCached(
+                fileLineStamps,
+                exp.loc.start.line,
+                exp.loc.end.line
+              );
+              const docModified = getLineRangeLastModifiedCached(
+                fileLineStamps,
+                doc.loc.start.line,
+                doc.loc.end.line
+              );
+              if (bodyModified > 0 && docModified > 0) {
+                const DRIFT_THRESHOLD_SECONDS = 24 * 60 * 60;
+                if (bodyModified - docModified > DRIFT_THRESHOLD_SECONDS) {
+                  actualDrift++;
+                  issues.push({
+                    type: IssueType.DocDrift,
+                    severity: Severity.Major,
+                    message: `Documentation drift: logic was modified on ${new Date(bodyModified * 1e3).toLocaleDateString()} but documentation was last updated on ${new Date(docModified * 1e3).toLocaleDateString()}.`,
+                    location: { file, line: doc.loc.start.line }
+                  });
+                }
+              }
+            }
+          }
+        }
+      }
+    } catch (error) {
+      console.warn(`Doc-drift: Failed to parse ${file}: ${error}`);
+      continue;
+    }
+  }
+  const riskResult = calculateDocDrift({
+    uncommentedExports,
+    totalExports,
+    outdatedComments,
+    undocumentedComplexity,
+    actualDrift
+  });
+  return {
+    summary: {
+      filesAnalyzed: files.length,
+      functionsAnalyzed: totalExports,
+      score: riskResult.score,
+      rating: riskResult.rating
+    },
+    issues,
+    rawData: {
+      uncommentedExports,
+      totalExports,
+      outdatedComments,
+      undocumentedComplexity,
+      actualDrift
+    },
+    recommendations: riskResult.recommendations
+  };
+}
+
+export {
+  __require,
+  analyzeDocDrift
+};

package/dist/{chunk-5BGWZWHD.mjs → chunk-P74XAVQ3.mjs}

@@ -26,6 +26,7 @@ async function analyzeDocDrift(options) {
   let totalExports = 0;
   let outdatedComments = 0;
   let undocumentedComplexity = 0;
+  let actualDrift = 0;
   const now = Math.floor(Date.now() / 1e3);
   let processed = 0;
   for (const file of files) {
@@ -75,10 +76,9 @@ async function analyzeDocDrift(options) {
                   message: `Documentation mismatch: function parameters (${missingParams.join(", ")}) are not mentioned in the docs.`,
                   location: { file, line: exp.loc?.start.line || 1 }
                 });
-                continue;
               }
             }
-            if (exp.loc) {
+            if (exp.loc && doc.loc) {
               if (!fileLineStamps) {
                 fileLineStamps = getFileCommitTimestamps(file);
               }
@@ -87,8 +87,21 @@ async function analyzeDocDrift(options) {
                 exp.loc.start.line,
                 exp.loc.end.line
               );
-              if (bodyModified > 0) {
-                if (now - bodyModified < staleSeconds / 4 && exp.documentation.isStale === true) {
+              const docModified = getLineRangeLastModifiedCached(
+                fileLineStamps,
+                doc.loc.start.line,
+                doc.loc.end.line
+              );
+              if (bodyModified > 0 && docModified > 0) {
+                const DRIFT_THRESHOLD_SECONDS = 24 * 60 * 60;
+                if (bodyModified - docModified > DRIFT_THRESHOLD_SECONDS) {
+                  actualDrift++;
+                  issues.push({
+                    type: IssueType.DocDrift,
+                    severity: Severity.Major,
+                    message: `Documentation drift: logic was modified on ${new Date(bodyModified * 1e3).toLocaleDateString()} but documentation was last updated on ${new Date(docModified * 1e3).toLocaleDateString()}.`,
+                    location: { file, line: doc.loc.start.line }
+                  });
                 }
               }
             }
@@ -104,7 +117,8 @@ async function analyzeDocDrift(options) {
     uncommentedExports,
     totalExports,
     outdatedComments,
-    undocumentedComplexity
+    undocumentedComplexity,
+    actualDrift
   });
   return {
     summary: {
@@ -118,7 +132,8 @@ async function analyzeDocDrift(options) {
       uncommentedExports,
       totalExports,
       outdatedComments,
-      undocumentedComplexity
+      undocumentedComplexity,
+      actualDrift
     },
     recommendations: riskResult.recommendations
   };

package/dist/cli.js

@@ -41,13 +41,11 @@ var import_fs = require("fs");
 async function analyzeDocDrift(options) {
   const files = await (0, import_core.scanFiles)(options);
   const issues = [];
-  const staleMonths = options.staleMonths ?? 6;
-  const staleSeconds = staleMonths * 30 * 24 * 60 * 60;
   let uncommentedExports = 0;
   let totalExports = 0;
   let outdatedComments = 0;
   let undocumentedComplexity = 0;
-  const now = Math.floor(Date.now() / 1e3);
+  let actualDrift = 0;
   let processed = 0;
   for (const file of files) {
     processed++;
@@ -96,10 +94,9 @@ async function analyzeDocDrift(options) {
                   message: `Documentation mismatch: function parameters (${missingParams.join(", ")}) are not mentioned in the docs.`,
                   location: { file, line: exp.loc?.start.line || 1 }
                 });
-                continue;
               }
             }
-            if (exp.loc) {
+            if (exp.loc && doc.loc) {
               if (!fileLineStamps) {
                 fileLineStamps = (0, import_core.getFileCommitTimestamps)(file);
               }
@@ -108,8 +105,21 @@ async function analyzeDocDrift(options) {
                 exp.loc.start.line,
                 exp.loc.end.line
               );
-              if (bodyModified > 0) {
-                if (now - bodyModified < staleSeconds / 4 && exp.documentation.isStale === true) {
+              const docModified = (0, import_core.getLineRangeLastModifiedCached)(
+                fileLineStamps,
+                doc.loc.start.line,
+                doc.loc.end.line
+              );
+              if (bodyModified > 0 && docModified > 0) {
+                const DRIFT_THRESHOLD_SECONDS = 24 * 60 * 60;
+                if (bodyModified - docModified > DRIFT_THRESHOLD_SECONDS) {
+                  actualDrift++;
+                  issues.push({
+                    type: import_core.IssueType.DocDrift,
+                    severity: import_core.Severity.Major,
+                    message: `Documentation drift: logic was modified on ${new Date(bodyModified * 1e3).toLocaleDateString()} but documentation was last updated on ${new Date(docModified * 1e3).toLocaleDateString()}.`,
+                    location: { file, line: doc.loc.start.line }
+                  });
                 }
               }
             }
@@ -125,7 +135,8 @@ async function analyzeDocDrift(options) {
     uncommentedExports,
     totalExports,
     outdatedComments,
-    undocumentedComplexity
+    undocumentedComplexity,
+    actualDrift
   });
   return {
     summary: {
@@ -139,7 +150,8 @@ async function analyzeDocDrift(options) {
       uncommentedExports,
       totalExports,
       outdatedComments,
-      undocumentedComplexity
+      undocumentedComplexity,
+      actualDrift
     },
     recommendations: riskResult.recommendations
   };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 import {
   __require,
   analyzeDocDrift
-} from "./chunk-5BGWZWHD.mjs";
+} from "./chunk-MAPV5YQR.mjs";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.d.mts

@@ -49,15 +49,31 @@ interface DocDriftReport {
         outdatedComments: number;
         /** Count of complex functions without sufficient documentation */
         undocumentedComplexity: number;
+        /** Number of functions where code changed after docs */
+        actualDrift: number;
     };
     /** AI-generated remediation advice */
     recommendations: string[];
 }
 
+/**
+ * Analyzes documentation drift across a set of files.
+ * This tool detects:
+ * 1. Missing documentation for complex functions/classes.
+ * 2. Signature mismatches (parameters not mentioned in docs).
+ * 3. Temporal drift (logic changed after documentation was last updated).
+ *
+ * @param options - Analysis configuration including include/exclude patterns and drift thresholds.
+ * @returns A comprehensive report with drift scores and specific issues.
+ */
 declare function analyzeDocDrift(options: DocDriftOptions): Promise<DocDriftReport>;
 
 /**
- * Convert doc-drift report into a ToolScoringOutput.
+ * Convert doc-drift report into a standardized ToolScoringOutput.
+ *
+ * @param report - The detailed doc-drift report including raw metrics.
+ * @returns Standardized scoring and risk factor breakdown.
+ * @lastUpdated 2026-03-18
  */
 declare function calculateDocDriftScore(report: DocDriftReport): ToolScoringOutput;
 

package/dist/index.d.ts

@@ -49,15 +49,31 @@ interface DocDriftReport {
         outdatedComments: number;
         /** Count of complex functions without sufficient documentation */
         undocumentedComplexity: number;
+        /** Number of functions where code changed after docs */
+        actualDrift: number;
     };
     /** AI-generated remediation advice */
     recommendations: string[];
 }
 
+/**
+ * Analyzes documentation drift across a set of files.
+ * This tool detects:
+ * 1. Missing documentation for complex functions/classes.
+ * 2. Signature mismatches (parameters not mentioned in docs).
+ * 3. Temporal drift (logic changed after documentation was last updated).
+ *
+ * @param options - Analysis configuration including include/exclude patterns and drift thresholds.
+ * @returns A comprehensive report with drift scores and specific issues.
+ */
 declare function analyzeDocDrift(options: DocDriftOptions): Promise<DocDriftReport>;
 
 /**
- * Convert doc-drift report into a ToolScoringOutput.
+ * Convert doc-drift report into a standardized ToolScoringOutput.
+ *
+ * @param report - The detailed doc-drift report including raw metrics.
+ * @returns Standardized scoring and risk factor breakdown.
+ * @lastUpdated 2026-03-18
  */
 declare function calculateDocDriftScore(report: DocDriftReport): ToolScoringOutput;
 

package/dist/index.js

@@ -36,13 +36,11 @@ var import_fs = require("fs");
 async function analyzeDocDrift(options) {
   const files = await (0, import_core.scanFiles)(options);
   const issues = [];
-  const staleMonths = options.staleMonths ?? 6;
-  const staleSeconds = staleMonths * 30 * 24 * 60 * 60;
   let uncommentedExports = 0;
   let totalExports = 0;
   let outdatedComments = 0;
   let undocumentedComplexity = 0;
-  const now = Math.floor(Date.now() / 1e3);
+  let actualDrift = 0;
   let processed = 0;
   for (const file of files) {
     processed++;
@@ -91,10 +89,9 @@ async function analyzeDocDrift(options) {
                   message: `Documentation mismatch: function parameters (${missingParams.join(", ")}) are not mentioned in the docs.`,
                   location: { file, line: exp.loc?.start.line || 1 }
                 });
-                continue;
               }
             }
-            if (exp.loc) {
+            if (exp.loc && doc.loc) {
               if (!fileLineStamps) {
                 fileLineStamps = (0, import_core.getFileCommitTimestamps)(file);
               }
@@ -103,8 +100,21 @@ async function analyzeDocDrift(options) {
                 exp.loc.start.line,
                 exp.loc.end.line
               );
-              if (bodyModified > 0) {
-                if (now - bodyModified < staleSeconds / 4 && exp.documentation.isStale === true) {
+              const docModified = (0, import_core.getLineRangeLastModifiedCached)(
+                fileLineStamps,
+                doc.loc.start.line,
+                doc.loc.end.line
+              );
+              if (bodyModified > 0 && docModified > 0) {
+                const DRIFT_THRESHOLD_SECONDS = 24 * 60 * 60;
+                if (bodyModified - docModified > DRIFT_THRESHOLD_SECONDS) {
+                  actualDrift++;
+                  issues.push({
+                    type: import_core.IssueType.DocDrift,
+                    severity: import_core.Severity.Major,
+                    message: `Documentation drift: logic was modified on ${new Date(bodyModified * 1e3).toLocaleDateString()} but documentation was last updated on ${new Date(docModified * 1e3).toLocaleDateString()}.`,
+                    location: { file, line: doc.loc.start.line }
+                  });
                 }
               }
             }
@@ -120,7 +130,8 @@ async function analyzeDocDrift(options) {
     uncommentedExports,
     totalExports,
     outdatedComments,
-    undocumentedComplexity
+    undocumentedComplexity,
+    actualDrift
   });
   return {
     summary: {
@@ -134,7 +145,8 @@ async function analyzeDocDrift(options) {
       uncommentedExports,
       totalExports,
       outdatedComments,
-      undocumentedComplexity
+      undocumentedComplexity,
+      actualDrift
     },
     recommendations: riskResult.recommendations
   };
@@ -173,26 +185,33 @@ function calculateDocDriftScore(report) {
     uncommentedExports: rawData.uncommentedExports,
     totalExports: rawData.totalExports,
     outdatedComments: rawData.outdatedComments,
-    undocumentedComplexity: rawData.undocumentedComplexity
+    undocumentedComplexity: rawData.undocumentedComplexity,
+    actualDrift: rawData.actualDrift
   });
   const factors = [
     {
-      name: "Uncommented Exports",
+      name: "Undocumented Complexity",
       impact: -Math.min(
-        20,
-        rawData.uncommentedExports / Math.max(1, rawData.totalExports) * 100 * 0.2
+        50,
+        rawData.undocumentedComplexity / Math.max(1, rawData.totalExports) / 0.2 * 100 * 0.5
       ),
-      description: `${rawData.uncommentedExports} uncommented exports`
+      description: `${rawData.undocumentedComplexity} complex functions lack docs (high risk)`
     },
     {
-      name: "Outdated Comments",
-      impact: -Math.min(60, rawData.outdatedComments * 15 * 0.6),
-      description: `${rawData.outdatedComments} outdated comments`
+      name: "Outdated/Incomplete Comments",
+      impact: -Math.min(
+        30,
+        rawData.outdatedComments / Math.max(1, rawData.totalExports) / 0.4 * 100 * 0.3
+      ),
+      description: `${rawData.outdatedComments} functions with parameter-mismatch in docs`
     },
     {
-      name: "Undocumented Complexity",
-      impact: -Math.min(20, rawData.undocumentedComplexity * 10 * 0.2),
-      description: `${rawData.undocumentedComplexity} complex functions lack docs`
+      name: "Uncommented Exports",
+      impact: -Math.min(
+        20,
+        rawData.uncommentedExports / Math.max(1, rawData.totalExports) / 0.8 * 100 * 0.2
+      ),
+      description: `${rawData.uncommentedExports} uncommented exports`
     }
   ];
   const recommendations = riskResult.recommendations.map((rec) => ({

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   analyzeDocDrift
-} from "./chunk-5BGWZWHD.mjs";
+} from "./chunk-MAPV5YQR.mjs";
 
 // src/index.ts
 import { ToolRegistry } from "@aiready/core";
@@ -44,26 +44,33 @@ function calculateDocDriftScore(report) {
     uncommentedExports: rawData.uncommentedExports,
     totalExports: rawData.totalExports,
     outdatedComments: rawData.outdatedComments,
-    undocumentedComplexity: rawData.undocumentedComplexity
+    undocumentedComplexity: rawData.undocumentedComplexity,
+    actualDrift: rawData.actualDrift
   });
   const factors = [
     {
-      name: "Uncommented Exports",
+      name: "Undocumented Complexity",
       impact: -Math.min(
-        20,
-        rawData.uncommentedExports / Math.max(1, rawData.totalExports) * 100 * 0.2
+        50,
+        rawData.undocumentedComplexity / Math.max(1, rawData.totalExports) / 0.2 * 100 * 0.5
       ),
-      description: `${rawData.uncommentedExports} uncommented exports`
+      description: `${rawData.undocumentedComplexity} complex functions lack docs (high risk)`
     },
     {
-      name: "Outdated Comments",
-      impact: -Math.min(60, rawData.outdatedComments * 15 * 0.6),
-      description: `${rawData.outdatedComments} outdated comments`
+      name: "Outdated/Incomplete Comments",
+      impact: -Math.min(
+        30,
+        rawData.outdatedComments / Math.max(1, rawData.totalExports) / 0.4 * 100 * 0.3
+      ),
+      description: `${rawData.outdatedComments} functions with parameter-mismatch in docs`
     },
     {
-      name: "Undocumented Complexity",
-      impact: -Math.min(20, rawData.undocumentedComplexity * 10 * 0.2),
-      description: `${rawData.undocumentedComplexity} complex functions lack docs`
+      name: "Uncommented Exports",
+      impact: -Math.min(
+        20,
+        rawData.uncommentedExports / Math.max(1, rawData.totalExports) / 0.8 * 100 * 0.2
+      ),
+      description: `${rawData.uncommentedExports} uncommented exports`
     }
   ];
   const recommendations = riskResult.recommendations.map((rec) => ({