@aiready/doc-drift 0.14.9 → 0.14.11

package/.turbo/turbo-build.log

@@ -1,24 +1,23 @@
-
-
-> @aiready/doc-drift@0.14.9 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
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Target: es2020
-CJS Build start
-ESM Build start
-ESM dist/cli.mjs            1.07 KB
-ESM dist/index.mjs          1.87 KB
-ESM dist/chunk-GZDN7B4K.mjs 4.40 KB
-ESM ⚡️ Build success in 108ms
-CJS dist/index.js 6.98 KB
-CJS dist/cli.js   6.71 KB
-CJS ⚡️ Build success in 108ms
-DTS Build start
-DTS ⚡️ Build success in 1576ms
-DTS dist/cli.d.ts    108.00 B
-DTS dist/index.d.ts  2.83 KB
-DTS dist/cli.d.mts   108.00 B
-DTS dist/index.d.mts 2.83 KB
+
+> @aiready/doc-drift@0.14.9 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
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: es2020
+CJS Build start
+ESM Build start
+CJS dist/cli.js   6.71 KB
+CJS dist/index.js 6.02 KB
+CJS ⚡️ Build success in 78ms
+ESM dist/cli.mjs            1.07 KB
+ESM dist/index.mjs          972.00 B
+ESM dist/chunk-GZDN7B4K.mjs 4.40 KB
+ESM ⚡️ Build success in 78ms
+DTS Build start
+DTS ⚡️ Build success in 3205ms
+DTS dist/cli.d.ts    108.00 B
+DTS dist/index.d.ts  2.48 KB
+DTS dist/cli.d.mts   108.00 B
+DTS dist/index.d.mts 2.48 KB

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 import * as _aiready_core from '@aiready/core';
-import { Issue, IssueType, ScanOptions, DocDriftRisk, ToolScoringOutput } from '@aiready/core';
+import { Issue, IssueType, ScanOptions, DocDriftRisk } from '@aiready/core';
 
 /**
  * Documentation Drift Tool Provider
  */
-declare const DocDriftProvider: _aiready_core.ToolProvider;
+declare const DOC_DRIFT_PROVIDER: _aiready_core.ToolProvider;
 
 /**
  * Options for documentation drift analysis
@@ -68,13 +68,4 @@ interface DocDriftReport {
  */
 declare function analyzeDocDrift(options: DocDriftOptions): Promise<DocDriftReport>;
 
-/**
- * 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-24
- */
-declare function calculateDocDriftScore(report: DocDriftReport): ToolScoringOutput;
-
-export { type DocDriftIssue, type DocDriftOptions, DocDriftProvider, type DocDriftReport, analyzeDocDrift, calculateDocDriftScore };
+export { DOC_DRIFT_PROVIDER, type DocDriftIssue, type DocDriftOptions, type DocDriftReport, analyzeDocDrift };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import * as _aiready_core from '@aiready/core';
-import { Issue, IssueType, ScanOptions, DocDriftRisk, ToolScoringOutput } from '@aiready/core';
+import { Issue, IssueType, ScanOptions, DocDriftRisk } from '@aiready/core';
 
 /**
  * Documentation Drift Tool Provider
  */
-declare const DocDriftProvider: _aiready_core.ToolProvider;
+declare const DOC_DRIFT_PROVIDER: _aiready_core.ToolProvider;
 
 /**
  * Options for documentation drift analysis
@@ -68,13 +68,4 @@ interface DocDriftReport {
  */
 declare function analyzeDocDrift(options: DocDriftOptions): Promise<DocDriftReport>;
 
-/**
- * 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-24
- */
-declare function calculateDocDriftScore(report: DocDriftReport): ToolScoringOutput;
-
-export { type DocDriftIssue, type DocDriftOptions, DocDriftProvider, type DocDriftReport, analyzeDocDrift, calculateDocDriftScore };
+export { DOC_DRIFT_PROVIDER, type DocDriftIssue, type DocDriftOptions, type DocDriftReport, analyzeDocDrift };

package/dist/index.js

@@ -20,12 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  DocDriftProvider: () => DocDriftProvider,
-  analyzeDocDrift: () => analyzeDocDrift,
-  calculateDocDriftScore: () => calculateDocDriftScore
+  DOC_DRIFT_PROVIDER: () => DOC_DRIFT_PROVIDER,
+  analyzeDocDrift: () => analyzeDocDrift
 });
 module.exports = __toCommonJS(index_exports);
-var import_core4 = require("@aiready/core");
+var import_core3 = require("@aiready/core");
 
 // src/provider.ts
 var import_core2 = require("@aiready/core");
@@ -153,7 +152,7 @@ async function analyzeDocDrift(options) {
 }
 
 // src/provider.ts
-var DocDriftProvider = (0, import_core2.createProvider)({
+var DOC_DRIFT_PROVIDER = (0, import_core2.createProvider)({
   id: import_core2.ToolName.DocDrift,
   alias: ["doc-drift", "docs", "jsdoc"],
   version: "0.9.5",
@@ -177,37 +176,10 @@ var DocDriftProvider = (0, import_core2.createProvider)({
   }
 });
 
-// src/scoring.ts
-var import_core3 = require("@aiready/core");
-function calculateDocDriftScore(report) {
-  const { rawData, summary } = report;
-  const riskResult = (0, import_core3.calculateDocDrift)({
-    uncommentedExports: rawData.uncommentedExports,
-    totalExports: rawData.totalExports,
-    outdatedComments: rawData.outdatedComments,
-    undocumentedComplexity: rawData.undocumentedComplexity,
-    actualDrift: rawData.actualDrift
-  });
-  return (0, import_core3.buildStandardToolScore)({
-    toolName: import_core3.ToolName.DocDrift,
-    score: summary.score,
-    rawData,
-    dimensions: riskResult.dimensions,
-    dimensionNames: {
-      undocumentedComplexityScore: "Undocumented Complexity",
-      outdatedCommentsScore: "Outdated/Incomplete Comments",
-      uncommentedExportsScore: "Uncommented Exports"
-    },
-    recommendations: riskResult.recommendations,
-    rating: summary.rating
-  });
-}
-
 // src/index.ts
-import_core4.ToolRegistry.register(DocDriftProvider);
+import_core3.ToolRegistry.register(DOC_DRIFT_PROVIDER);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  DocDriftProvider,
-  analyzeDocDrift,
-  calculateDocDriftScore
+  DOC_DRIFT_PROVIDER,
+  analyzeDocDrift
 });

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   groupIssuesByFile,
   buildSimpleProviderScore
 } from "@aiready/core";
-var DocDriftProvider = createProvider({
+var DOC_DRIFT_PROVIDER = createProvider({
   id: ToolName.DocDrift,
   alias: ["doc-drift", "docs", "jsdoc"],
   version: "0.9.5",
@@ -36,40 +36,9 @@ var DocDriftProvider = createProvider({
   }
 });
 
-// src/scoring.ts
-import {
-  calculateDocDrift,
-  ToolName as ToolName2,
-  buildStandardToolScore
-} from "@aiready/core";
-function calculateDocDriftScore(report) {
-  const { rawData, summary } = report;
-  const riskResult = calculateDocDrift({
-    uncommentedExports: rawData.uncommentedExports,
-    totalExports: rawData.totalExports,
-    outdatedComments: rawData.outdatedComments,
-    undocumentedComplexity: rawData.undocumentedComplexity,
-    actualDrift: rawData.actualDrift
-  });
-  return buildStandardToolScore({
-    toolName: ToolName2.DocDrift,
-    score: summary.score,
-    rawData,
-    dimensions: riskResult.dimensions,
-    dimensionNames: {
-      undocumentedComplexityScore: "Undocumented Complexity",
-      outdatedCommentsScore: "Outdated/Incomplete Comments",
-      uncommentedExportsScore: "Uncommented Exports"
-    },
-    recommendations: riskResult.recommendations,
-    rating: summary.rating
-  });
-}
-
 // src/index.ts
-ToolRegistry.register(DocDriftProvider);
+ToolRegistry.register(DOC_DRIFT_PROVIDER);
 export {
-  DocDriftProvider,
-  analyzeDocDrift,
-  calculateDocDriftScore
+  DOC_DRIFT_PROVIDER,
+  analyzeDocDrift
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/doc-drift",
-  "version": "0.14.9",
+  "version": "0.14.11",
   "description": "AI-Readiness: Documentation Drift Detection",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -10,7 +10,7 @@
     "commander": "^14.0.0",
     "glob": "^13.0.0",
     "picocolors": "^1.0.0",
-    "@aiready/core": "0.24.9"
+    "@aiready/core": "0.24.12"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/__tests__/provider.test.ts

@@ -1,46 +1,12 @@
-import { describe, it, expect, vi } from 'vitest';
-import { DocDriftProvider } from '../provider';
-import * as analyzer from '../analyzer';
-
-vi.mock('../analyzer', () => ({
-  analyzeDocDrift: vi.fn(),
-}));
+import { describe, it, expect } from 'vitest';
+import { DOC_DRIFT_PROVIDER } from '../provider';
 
 describe('Doc Drift Provider', () => {
-  it('should analyze and return SpokeOutput', async () => {
-    vi.mocked(analyzer.analyzeDocDrift).mockResolvedValue({
-      summary: {
-        filesAnalyzed: 1,
-        functionsAnalyzed: 5,
-        score: 90,
-        rating: 'minimal',
-      },
-      issues: [],
-      rawData: {
-        uncommentedExports: 0,
-        totalExports: 5,
-        outdatedComments: 0,
-        undocumentedComplexity: 0,
-        actualDrift: 0,
-      },
-      recommendations: [],
-    });
-
-    const output = await DocDriftProvider.analyze({ rootDir: '.' });
-
-    expect(output.summary.filesAnalyzed).toBe(1);
-    expect(output.metadata!.toolName).toBe('doc-drift');
+  it('should have correct ID', () => {
+    expect(DOC_DRIFT_PROVIDER.id).toBe('doc-drift');
   });
 
-  it('should score an output', () => {
-    const mockOutput = {
-      summary: { score: 80, recommendations: ['Fix it'] } as any,
-      metadata: { rawData: {} },
-      results: [],
-    };
-
-    const scoring = DocDriftProvider.score(mockOutput as any, { rootDir: '.' });
-    expect(scoring.score).toBe(80);
-    expect(scoring.recommendations[0].action).toBe('Fix it');
+  it('should have alias', () => {
+    expect(DOC_DRIFT_PROVIDER.alias).toContain('documentation');
   });
 });

package/src/index.ts

@@ -1,10 +1,9 @@
 import { ToolRegistry } from '@aiready/core';
-import { DocDriftProvider } from './provider';
+import { DOC_DRIFT_PROVIDER } from './provider';
 
 // Register with global registry
-ToolRegistry.register(DocDriftProvider);
+ToolRegistry.register(DOC_DRIFT_PROVIDER);
 
 export * from './types';
 export * from './analyzer';
-export * from './scoring';
-export { DocDriftProvider };
+export { DOC_DRIFT_PROVIDER };

package/src/provider.ts

@@ -11,7 +11,7 @@ import { DocDriftOptions } from './types';
 /**
  * Documentation Drift Tool Provider
  */
-export const DocDriftProvider = createProvider({
+export const DOC_DRIFT_PROVIDER = createProvider({
   id: ToolName.DocDrift,
   alias: ['doc-drift', 'docs', 'jsdoc'],
   version: '0.9.5',

package/dist/chunk-6EHZXHM7.mjs

@@ -1,143 +0,0 @@
-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 = [];
-  const staleMonths = options.staleMonths ?? 6;
-  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-DEXSCXHS.mjs

@@ -1,142 +0,0 @@
-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`);
-                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-MAPV5YQR.mjs

@@ -1,142 +0,0 @@
-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-P74XAVQ3.mjs

@@ -1,145 +0,0 @@
-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 = [];
-  const staleMonths = options.staleMonths ?? 6;
-  const staleSeconds = staleMonths * 30 * 24 * 60 * 60;
-  let uncommentedExports = 0;
-  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) {
-    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
-};