@aiready/core 0.23.5 → 0.23.6

package/dist/{client-BF9NjhE8.d.mts → client-CKcjnPXt.d.mts}

@@ -822,6 +822,7 @@ interface ExportInfo {
     documentation?: {
         content: string;
         type: 'jsdoc' | 'docstring' | 'comment' | 'xml-doc';
+        loc?: SourceRange;
         isStale?: boolean;
     };
 }

package/dist/{client-BF9NjhE8.d.ts → client-CKcjnPXt.d.ts}

@@ -822,6 +822,7 @@ interface ExportInfo {
     documentation?: {
         content: string;
         type: 'jsdoc' | 'docstring' | 'comment' | 'xml-doc';
+        loc?: SourceRange;
         isStale?: boolean;
     };
 }

package/dist/client.d.mts

@@ -1,2 +1,2 @@
-export { e as AIReadyConfig, g as AcceptancePrediction, A as AnalysisResult, o as AnalysisStatus, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, h as ComprehensionDifficulty, t as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, l as ExportInfo, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, I as ImportInfo, K as Issue, Q as IssueType, U as LANGUAGE_EXTENSIONS, k as Language, V as LanguageConfig, L as LanguageParser, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a4 as Metrics, M as ModelContextTier, N as NamingConvention, a8 as ParseError, m as ParseResult, a9 as ParseStatistics, P as ProductivityImpact, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, c as Severity, c as SeverityType, aj as SourceLocation, ak as SourceRange, a as SpokeOutput, ao as TOOL_NAME_MAP, j as TechnicalValueChain, i as TechnicalValueChainSummary, f as TokenBudget, T as ToolName, aq as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-BF9NjhE8.mjs';
+export { e as AIReadyConfig, g as AcceptancePrediction, A as AnalysisResult, o as AnalysisStatus, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, h as ComprehensionDifficulty, t as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, l as ExportInfo, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, I as ImportInfo, K as Issue, Q as IssueType, U as LANGUAGE_EXTENSIONS, k as Language, V as LanguageConfig, L as LanguageParser, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a4 as Metrics, M as ModelContextTier, N as NamingConvention, a8 as ParseError, m as ParseResult, a9 as ParseStatistics, P as ProductivityImpact, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, c as Severity, c as SeverityType, aj as SourceLocation, ak as SourceRange, a as SpokeOutput, ao as TOOL_NAME_MAP, j as TechnicalValueChain, i as TechnicalValueChainSummary, f as TokenBudget, T as ToolName, aq as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-CKcjnPXt.mjs';
 import 'zod';

package/dist/client.d.ts

@@ -1,2 +1,2 @@
-export { e as AIReadyConfig, g as AcceptancePrediction, A as AnalysisResult, o as AnalysisStatus, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, h as ComprehensionDifficulty, t as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, l as ExportInfo, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, I as ImportInfo, K as Issue, Q as IssueType, U as LANGUAGE_EXTENSIONS, k as Language, V as LanguageConfig, L as LanguageParser, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a4 as Metrics, M as ModelContextTier, N as NamingConvention, a8 as ParseError, m as ParseResult, a9 as ParseStatistics, P as ProductivityImpact, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, c as Severity, c as SeverityType, aj as SourceLocation, ak as SourceRange, a as SpokeOutput, ao as TOOL_NAME_MAP, j as TechnicalValueChain, i as TechnicalValueChainSummary, f as TokenBudget, T as ToolName, aq as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-BF9NjhE8.js';
+export { e as AIReadyConfig, g as AcceptancePrediction, A as AnalysisResult, o as AnalysisStatus, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, h as ComprehensionDifficulty, t as Config, C as CostConfig, D as DEFAULT_TOOL_WEIGHTS, l as ExportInfo, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, I as ImportInfo, K as Issue, Q as IssueType, U as LANGUAGE_EXTENSIONS, k as Language, V as LanguageConfig, L as LanguageParser, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a4 as Metrics, M as ModelContextTier, N as NamingConvention, a8 as ParseError, m as ParseResult, a9 as ParseStatistics, P as ProductivityImpact, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, S as ScanOptions, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, c as Severity, c as SeverityType, aj as SourceLocation, ak as SourceRange, a as SpokeOutput, ao as TOOL_NAME_MAP, j as TechnicalValueChain, i as TechnicalValueChainSummary, f as TokenBudget, T as ToolName, aq as ToolOptions, ar as ToolOutput, b as ToolScoringOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-CKcjnPXt.js';
 import 'zod';

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, A as AnalysisResult, E as ExportWithImports, d as ASTNode, F as FileImport, e as AIReadyConfig, M as ModelContextTier, C as CostConfig, f as TokenBudget, P as ProductivityImpact, g as AcceptancePrediction, h as ComprehensionDifficulty, i as TechnicalValueChainSummary, j as TechnicalValueChain, L as LanguageParser, k as Language, l as ExportInfo, m as ParseResult, N as NamingConvention, I as ImportInfo } from './client-BF9NjhE8.mjs';
-export { n as AnalysisResultSchema, o as AnalysisStatus, p as AnalysisStatusSchema, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, t as Config, D as DEFAULT_TOOL_WEIGHTS, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, K as Issue, O as IssueSchema, Q as IssueType, R as IssueTypeSchema, U as LANGUAGE_EXTENSIONS, V as LanguageConfig, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a1 as LocationSchema, a2 as ManagedAccount, a3 as ManagedAccountSchema, a4 as Metrics, a5 as MetricsSchema, a6 as ModelTier, a7 as ModelTierSchema, a8 as ParseError, a9 as ParseStatistics, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, ai as SeveritySchema, aj as SourceLocation, ak as SourceRange, al as SpokeOutputSchema, am as SpokeSummary, an as SpokeSummarySchema, ao as TOOL_NAME_MAP, ap as ToolNameSchema, aq as ToolOptions, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-BF9NjhE8.mjs';
+import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, A as AnalysisResult, E as ExportWithImports, d as ASTNode, F as FileImport, e as AIReadyConfig, M as ModelContextTier, C as CostConfig, f as TokenBudget, P as ProductivityImpact, g as AcceptancePrediction, h as ComprehensionDifficulty, i as TechnicalValueChainSummary, j as TechnicalValueChain, L as LanguageParser, k as Language, l as ExportInfo, m as ParseResult, N as NamingConvention, I as ImportInfo } from './client-CKcjnPXt.mjs';
+export { n as AnalysisResultSchema, o as AnalysisStatus, p as AnalysisStatusSchema, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, t as Config, D as DEFAULT_TOOL_WEIGHTS, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, K as Issue, O as IssueSchema, Q as IssueType, R as IssueTypeSchema, U as LANGUAGE_EXTENSIONS, V as LanguageConfig, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a1 as LocationSchema, a2 as ManagedAccount, a3 as ManagedAccountSchema, a4 as Metrics, a5 as MetricsSchema, a6 as ModelTier, a7 as ModelTierSchema, a8 as ParseError, a9 as ParseStatistics, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, ai as SeveritySchema, aj as SourceLocation, ak as SourceRange, al as SpokeOutputSchema, am as SpokeSummary, an as SpokeSummarySchema, ao as TOOL_NAME_MAP, ap as ToolNameSchema, aq as ToolOptions, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-CKcjnPXt.mjs';
 import { z } from 'zod';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -1096,14 +1096,22 @@ interface DocDriftRisk {
         uncommentedExports: number;
         outdatedComments: number;
         undocumentedComplexity: number;
+        actualDrift: number;
     };
     recommendations: string[];
 }
+/**
+ * Calculate the documentation drift risk score based on various metrics.
+ *
+ * @param params - The raw metrics for doc-drift analysis
+ * @returns The calculated risk score and recommendations
+ */
 declare function calculateDocDrift(params: {
     uncommentedExports: number;
     totalExports: number;
     outdatedComments: number;
     undocumentedComplexity: number;
+    actualDrift: number;
 }): DocDriftRisk;
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, A as AnalysisResult, E as ExportWithImports, d as ASTNode, F as FileImport, e as AIReadyConfig, M as ModelContextTier, C as CostConfig, f as TokenBudget, P as ProductivityImpact, g as AcceptancePrediction, h as ComprehensionDifficulty, i as TechnicalValueChainSummary, j as TechnicalValueChain, L as LanguageParser, k as Language, l as ExportInfo, m as ParseResult, N as NamingConvention, I as ImportInfo } from './client-BF9NjhE8.js';
-export { n as AnalysisResultSchema, o as AnalysisStatus, p as AnalysisStatusSchema, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, t as Config, D as DEFAULT_TOOL_WEIGHTS, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, K as Issue, O as IssueSchema, Q as IssueType, R as IssueTypeSchema, U as LANGUAGE_EXTENSIONS, V as LanguageConfig, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a1 as LocationSchema, a2 as ManagedAccount, a3 as ManagedAccountSchema, a4 as Metrics, a5 as MetricsSchema, a6 as ModelTier, a7 as ModelTierSchema, a8 as ParseError, a9 as ParseStatistics, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, ai as SeveritySchema, aj as SourceLocation, ak as SourceRange, al as SpokeOutputSchema, am as SpokeSummary, an as SpokeSummarySchema, ao as TOOL_NAME_MAP, ap as ToolNameSchema, aq as ToolOptions, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-BF9NjhE8.js';
+import { T as ToolName, S as ScanOptions, a as SpokeOutput, b as ToolScoringOutput, c as Severity, A as AnalysisResult, E as ExportWithImports, d as ASTNode, F as FileImport, e as AIReadyConfig, M as ModelContextTier, C as CostConfig, f as TokenBudget, P as ProductivityImpact, g as AcceptancePrediction, h as ComprehensionDifficulty, i as TechnicalValueChainSummary, j as TechnicalValueChain, L as LanguageParser, k as Language, l as ExportInfo, m as ParseResult, N as NamingConvention, I as ImportInfo } from './client-CKcjnPXt.js';
+export { n as AnalysisResultSchema, o as AnalysisStatus, p as AnalysisStatusSchema, B as BusinessMetrics, q as COMMON_FINE_TUNING_OPTIONS, r as CONTEXT_TIER_THRESHOLDS, s as CommonASTNode, t as Config, D as DEFAULT_TOOL_WEIGHTS, u as FRIENDLY_TOOL_NAMES, v as FileContent, G as GLOBAL_INFRA_OPTIONS, w as GLOBAL_SCAN_OPTIONS, x as GraphData, y as GraphEdge, z as GraphIssueSeverity, H as GraphMetadata, J as GraphNode, K as Issue, O as IssueSchema, Q as IssueType, R as IssueTypeSchema, U as LANGUAGE_EXTENSIONS, V as LanguageConfig, W as Lead, X as LeadSchema, Y as LeadSource, Z as LeadSourceSchema, _ as LeadSubmission, $ as LeadSubmissionSchema, a0 as Location, a1 as LocationSchema, a2 as ManagedAccount, a3 as ManagedAccountSchema, a4 as Metrics, a5 as MetricsSchema, a6 as ModelTier, a7 as ModelTierSchema, a8 as ParseError, a9 as ParseStatistics, aa as ReadinessRating, ab as RecommendationPriority, ac as SCORING_PROFILES, ad as SIZE_ADJUSTED_THRESHOLDS, ae as ScanResult, af as ScoringConfig, ag as ScoringProfile, ah as ScoringResult, ai as SeveritySchema, aj as SourceLocation, ak as SourceRange, al as SpokeOutputSchema, am as SpokeSummary, an as SpokeSummarySchema, ao as TOOL_NAME_MAP, ap as ToolNameSchema, aq as ToolOptions, ar as ToolOutput, as as UnifiedReport, at as UnifiedReportSchema, au as calculateOverallScore, av as formatScore, aw as formatToolScore, ax as generateHTML, ay as getProjectSizeTier, az as getRating, aA as getRatingDisplay, aB as getRatingSlug, aC as getRatingWithContext, aD as getRecommendedThreshold, aE as getToolWeight, aF as normalizeToolName, aG as parseWeightString } from './client-CKcjnPXt.js';
 import { z } from 'zod';
 import * as Parser from 'web-tree-sitter';
 import { TSESTree } from '@typescript-eslint/typescript-estree';
@@ -1096,14 +1096,22 @@ interface DocDriftRisk {
         uncommentedExports: number;
         outdatedComments: number;
         undocumentedComplexity: number;
+        actualDrift: number;
     };
     recommendations: string[];
 }
+/**
+ * Calculate the documentation drift risk score based on various metrics.
+ *
+ * @param params - The raw metrics for doc-drift analysis
+ * @returns The calculated risk score and recommendations
+ */
 declare function calculateDocDrift(params: {
     uncommentedExports: number;
     totalExports: number;
     outdatedComments: number;
     undocumentedComplexity: number;
+    actualDrift: number;
 }): DocDriftRisk;
 
 /**

package/dist/index.js

@@ -1125,7 +1125,7 @@ var TypeScriptParser = class {
       hasSideEffects: false
     };
     const start = node.range?.[0] ?? 0;
-    const preceding = code.slice(Math.max(0, start - 200), start);
+    const preceding = code.slice(Math.max(0, start - 1e3), start);
     const jsdocMatches = Array.from(
       preceding.matchAll(/\/\*\*([\s\S]*?)\*\//g)
     );
@@ -1134,9 +1134,24 @@ var TypeScriptParser = class {
       const matchEndIndex = (lastMatch.index || 0) + lastMatch[0].length;
       const between = preceding.slice(matchEndIndex);
       if (/^\s*$/.test(between)) {
+        const precedingStartOffset = Math.max(0, start - 1e3);
+        const absoluteStartOffset = precedingStartOffset + (lastMatch.index || 0);
+        const absoluteEndOffset = precedingStartOffset + matchEndIndex;
+        const codeBeforeStart = code.slice(0, absoluteStartOffset);
+        const startLines = codeBeforeStart.split("\n");
+        const startLine = startLines.length;
+        const startColumn = startLines[startLines.length - 1].length;
+        const codeBeforeEnd = code.slice(0, absoluteEndOffset);
+        const endLines = codeBeforeEnd.split("\n");
+        const endLine = endLines.length;
+        const endColumn = endLines[endLines.length - 1].length;
         metadata.documentation = {
           content: lastMatch[1].replace(/^\s*\*+/gm, "").trim(),
-          type: "jsdoc"
+          type: "jsdoc",
+          loc: {
+            start: { line: startLine, column: startColumn },
+            end: { line: endLine, column: endColumn }
+          }
         };
       }
     }
@@ -1445,37 +1460,60 @@ function analyzeNodeMetadata(node, code, options) {
     let prev = node.previousSibling || null;
     while (prev && /comment/i.test(prev.type)) {
       const text = prev.text || "";
+      const loc = {
+        start: {
+          line: prev.startPosition.row + 1,
+          column: prev.startPosition.column
+        },
+        end: {
+          line: prev.endPosition.row + 1,
+          column: prev.endPosition.column
+        }
+      };
       if (text.trim().startsWith("/**") || text.trim().startsWith("/*")) {
         metadata.documentation = {
           content: text.replace(/^[/*]+|[/*]+$/g, "").trim(),
-          type: "comment"
+          type: "comment",
+          loc
         };
         break;
       }
       if (text.trim().startsWith("///")) {
         metadata.documentation = {
           content: text.replace(/^\/\/\//, "").trim(),
-          type: "xml-doc"
+          type: "xml-doc",
+          loc
         };
         break;
       }
       if (text.trim().startsWith("//")) {
         metadata.documentation = {
           content: text.replace(/^\/\//, "").trim(),
-          type: "comment"
+          type: "comment",
+          loc
         };
         break;
       }
       prev = prev.previousSibling;
     }
-    if (node.type === "function_definition") {
+    if (node.type === "function_definition" || node.type === "class_definition") {
       const body2 = node.childForFieldName ? node.childForFieldName("body") : node.children.find((c) => c.type === "block");
       if (body2 && body2.children.length > 0) {
         const firstStmt = body2.children[0];
         if (firstStmt.type === "expression_statement" && firstStmt.firstChild?.type === "string") {
           metadata.documentation = {
             content: firstStmt.firstChild.text.replace(/['"`]/g, "").trim(),
-            type: "docstring"
+            type: "docstring",
+            loc: {
+              start: {
+                line: firstStmt.startPosition.row + 1,
+                column: firstStmt.startPosition.column
+              },
+              end: {
+                line: firstStmt.endPosition.row + 1,
+                column: firstStmt.endPosition.column
+              }
+            }
           };
         }
       }
@@ -4619,14 +4657,32 @@ function calculateDocDrift(params) {
     uncommentedExports,
     totalExports,
     outdatedComments,
-    undocumentedComplexity
+    undocumentedComplexity,
+    actualDrift
   } = params;
   const uncommentedRatio = totalExports > 0 ? uncommentedExports / totalExports : 0;
-  const outdatedRisk = Math.min(100, outdatedComments * 15);
-  const uncommentedRisk = Math.min(100, uncommentedRatio * 100);
-  const complexityRisk = Math.min(100, undocumentedComplexity * 10);
+  const outdatedRatio = totalExports > 0 ? outdatedComments / totalExports : 0;
+  const complexityRatio = totalExports > 0 ? undocumentedComplexity / totalExports : 0;
+  const driftRatio = totalExports > 0 ? actualDrift / totalExports : 0;
+  const DRIFT_THRESHOLD = 0.2;
+  const OUTDATED_THRESHOLD = 0.4;
+  const COMPLEXITY_THRESHOLD = 0.2;
+  const UNCOMMENTED_THRESHOLD = 0.8;
+  const driftRisk = Math.min(100, driftRatio / DRIFT_THRESHOLD * 100);
+  const outdatedRisk = Math.min(
+    100,
+    outdatedRatio / OUTDATED_THRESHOLD * 100
+  );
+  const complexityRisk = Math.min(
+    100,
+    complexityRatio / COMPLEXITY_THRESHOLD * 100
+  );
+  const uncommentedRisk = Math.min(
+    100,
+    uncommentedRatio / UNCOMMENTED_THRESHOLD * 100
+  );
   const risk = Math.round(
-    outdatedRisk * 0.6 + uncommentedRisk * 0.2 + complexityRisk * 0.2
+    driftRisk * 0.4 + complexityRisk * 0.3 + outdatedRisk * 0.2 + uncommentedRisk * 0.1
   );
   const finalRisk = Math.min(100, Math.max(0, risk));
   const score = totalExports > 0 ? 100 - finalRisk : 100;
@@ -4638,6 +4694,10 @@ function calculateDocDrift(params) {
   else if (score >= 40) rating = "high";
   else rating = "severe";
   const recommendations = [];
+  if (actualDrift > 0)
+    recommendations.push(
+      `Review ${actualDrift} functions where code was changed after documentation was last updated.`
+    );
   if (outdatedComments > 0)
     recommendations.push(
       `Update or remove ${outdatedComments} outdated comments that contradict the code.`
@@ -4656,7 +4716,8 @@ function calculateDocDrift(params) {
     dimensions: {
       uncommentedExports,
       outdatedComments,
-      undocumentedComplexity
+      undocumentedComplexity,
+      actualDrift
     },
     recommendations
   };

package/dist/index.mjs

@@ -732,7 +732,7 @@ var TypeScriptParser = class {
       hasSideEffects: false
     };
     const start = node.range?.[0] ?? 0;
-    const preceding = code.slice(Math.max(0, start - 200), start);
+    const preceding = code.slice(Math.max(0, start - 1e3), start);
     const jsdocMatches = Array.from(
       preceding.matchAll(/\/\*\*([\s\S]*?)\*\//g)
     );
@@ -741,9 +741,24 @@ var TypeScriptParser = class {
       const matchEndIndex = (lastMatch.index || 0) + lastMatch[0].length;
       const between = preceding.slice(matchEndIndex);
       if (/^\s*$/.test(between)) {
+        const precedingStartOffset = Math.max(0, start - 1e3);
+        const absoluteStartOffset = precedingStartOffset + (lastMatch.index || 0);
+        const absoluteEndOffset = precedingStartOffset + matchEndIndex;
+        const codeBeforeStart = code.slice(0, absoluteStartOffset);
+        const startLines = codeBeforeStart.split("\n");
+        const startLine = startLines.length;
+        const startColumn = startLines[startLines.length - 1].length;
+        const codeBeforeEnd = code.slice(0, absoluteEndOffset);
+        const endLines = codeBeforeEnd.split("\n");
+        const endLine = endLines.length;
+        const endColumn = endLines[endLines.length - 1].length;
         metadata.documentation = {
           content: lastMatch[1].replace(/^\s*\*+/gm, "").trim(),
-          type: "jsdoc"
+          type: "jsdoc",
+          loc: {
+            start: { line: startLine, column: startColumn },
+            end: { line: endLine, column: endColumn }
+          }
         };
       }
     }
@@ -1052,37 +1067,60 @@ function analyzeNodeMetadata(node, code, options) {
     let prev = node.previousSibling || null;
     while (prev && /comment/i.test(prev.type)) {
       const text = prev.text || "";
+      const loc = {
+        start: {
+          line: prev.startPosition.row + 1,
+          column: prev.startPosition.column
+        },
+        end: {
+          line: prev.endPosition.row + 1,
+          column: prev.endPosition.column
+        }
+      };
       if (text.trim().startsWith("/**") || text.trim().startsWith("/*")) {
         metadata.documentation = {
           content: text.replace(/^[/*]+|[/*]+$/g, "").trim(),
-          type: "comment"
+          type: "comment",
+          loc
         };
         break;
       }
       if (text.trim().startsWith("///")) {
         metadata.documentation = {
           content: text.replace(/^\/\/\//, "").trim(),
-          type: "xml-doc"
+          type: "xml-doc",
+          loc
         };
         break;
       }
       if (text.trim().startsWith("//")) {
         metadata.documentation = {
           content: text.replace(/^\/\//, "").trim(),
-          type: "comment"
+          type: "comment",
+          loc
         };
         break;
       }
       prev = prev.previousSibling;
     }
-    if (node.type === "function_definition") {
+    if (node.type === "function_definition" || node.type === "class_definition") {
       const body2 = node.childForFieldName ? node.childForFieldName("body") : node.children.find((c) => c.type === "block");
       if (body2 && body2.children.length > 0) {
         const firstStmt = body2.children[0];
         if (firstStmt.type === "expression_statement" && firstStmt.firstChild?.type === "string") {
           metadata.documentation = {
             content: firstStmt.firstChild.text.replace(/['"`]/g, "").trim(),
-            type: "docstring"
+            type: "docstring",
+            loc: {
+              start: {
+                line: firstStmt.startPosition.row + 1,
+                column: firstStmt.startPosition.column
+              },
+              end: {
+                line: firstStmt.endPosition.row + 1,
+                column: firstStmt.endPosition.column
+              }
+            }
           };
         }
       }
@@ -3794,14 +3832,32 @@ function calculateDocDrift(params) {
     uncommentedExports,
     totalExports,
     outdatedComments,
-    undocumentedComplexity
+    undocumentedComplexity,
+    actualDrift
   } = params;
   const uncommentedRatio = totalExports > 0 ? uncommentedExports / totalExports : 0;
-  const outdatedRisk = Math.min(100, outdatedComments * 15);
-  const uncommentedRisk = Math.min(100, uncommentedRatio * 100);
-  const complexityRisk = Math.min(100, undocumentedComplexity * 10);
+  const outdatedRatio = totalExports > 0 ? outdatedComments / totalExports : 0;
+  const complexityRatio = totalExports > 0 ? undocumentedComplexity / totalExports : 0;
+  const driftRatio = totalExports > 0 ? actualDrift / totalExports : 0;
+  const DRIFT_THRESHOLD = 0.2;
+  const OUTDATED_THRESHOLD = 0.4;
+  const COMPLEXITY_THRESHOLD = 0.2;
+  const UNCOMMENTED_THRESHOLD = 0.8;
+  const driftRisk = Math.min(100, driftRatio / DRIFT_THRESHOLD * 100);
+  const outdatedRisk = Math.min(
+    100,
+    outdatedRatio / OUTDATED_THRESHOLD * 100
+  );
+  const complexityRisk = Math.min(
+    100,
+    complexityRatio / COMPLEXITY_THRESHOLD * 100
+  );
+  const uncommentedRisk = Math.min(
+    100,
+    uncommentedRatio / UNCOMMENTED_THRESHOLD * 100
+  );
   const risk = Math.round(
-    outdatedRisk * 0.6 + uncommentedRisk * 0.2 + complexityRisk * 0.2
+    driftRisk * 0.4 + complexityRisk * 0.3 + outdatedRisk * 0.2 + uncommentedRisk * 0.1
   );
   const finalRisk = Math.min(100, Math.max(0, risk));
   const score = totalExports > 0 ? 100 - finalRisk : 100;
@@ -3813,6 +3869,10 @@ function calculateDocDrift(params) {
   else if (score >= 40) rating = "high";
   else rating = "severe";
   const recommendations = [];
+  if (actualDrift > 0)
+    recommendations.push(
+      `Review ${actualDrift} functions where code was changed after documentation was last updated.`
+    );
   if (outdatedComments > 0)
     recommendations.push(
       `Update or remove ${outdatedComments} outdated comments that contradict the code.`
@@ -3831,7 +3891,8 @@ function calculateDocDrift(params) {
     dimensions: {
       uncommentedExports,
       outdatedComments,
-      undocumentedComplexity
+      undocumentedComplexity,
+      actualDrift
     },
     recommendations
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.23.5",
+  "version": "0.23.6",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/dist/__tests__/parser-factory.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Test multi-language parser factory
- */
-export {};
-//# sourceMappingURL=parser-factory.test.d.ts.map

package/dist/__tests__/parser-factory.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parser-factory.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/parser-factory.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/parser-factory.test.js

@@ -1,70 +0,0 @@
-/**
- * Test multi-language parser factory
- */
-import { describe, it, expect } from 'vitest';
-import {
-  ParserFactory,
-  Language,
-  getParser,
-  isFileSupported,
-  getSupportedLanguages,
-} from '../parsers/parser-factory';
-describe('ParserFactory', () => {
-  it('should return TypeScript parser for .ts files', () => {
-    const parser = getParser('test.ts');
-    expect(parser).toBeDefined();
-    expect(parser?.language).toBe(Language.TypeScript);
-  });
-  it('should return TypeScript parser for .tsx files', () => {
-    const parser = getParser('component.tsx');
-    expect(parser).toBeDefined();
-    expect(parser?.language).toBe(Language.TypeScript);
-  });
-  it('should return JavaScript parser for .js files', () => {
-    const parser = getParser('script.js');
-    expect(parser).toBeDefined();
-    expect(parser?.language).toBe(Language.TypeScript); // TS parser handles JS too
-  });
-  it('should return Python parser for .py files', () => {
-    const parser = getParser('script.py');
-    expect(parser).toBeDefined();
-    expect(parser?.language).toBe(Language.Python);
-  });
-  it('should return null for unsupported files', () => {
-    const parser = getParser('README.md');
-    expect(parser).toBeNull();
-  });
-  it('should correctly identify supported files', () => {
-    expect(isFileSupported('test.ts')).toBe(true);
-    expect(isFileSupported('test.py')).toBe(true);
-    expect(isFileSupported('test.java')).toBe(false); // Not yet implemented
-    expect(isFileSupported('README.md')).toBe(false);
-  });
-  it('should list all supported languages', () => {
-    const languages = getSupportedLanguages();
-    expect(languages).toContain(Language.TypeScript);
-    expect(languages).toContain(Language.Python);
-    expect(languages.length).toBeGreaterThanOrEqual(2);
-  });
-  it('should be case-insensitive for extensions', () => {
-    expect(getParser('Test.TS')).toBeDefined();
-    expect(getParser('Test.PY')).toBeDefined();
-  });
-});
-describe('Language Detection', () => {
-  it('should detect language from file path', () => {
-    const factory = ParserFactory.getInstance();
-    expect(factory.getLanguageForFile('src/index.ts')).toBe(
-      Language.TypeScript
-    );
-    expect(factory.getLanguageForFile('src/component.tsx')).toBe(
-      Language.TypeScript
-    );
-    expect(factory.getLanguageForFile('src/script.js')).toBe(
-      Language.JavaScript
-    );
-    expect(factory.getLanguageForFile('src/main.py')).toBe(Language.Python);
-    expect(factory.getLanguageForFile('README.md')).toBeNull();
-  });
-});
-//# sourceMappingURL=parser-factory.test.js.map

package/dist/__tests__/parser-factory.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parser-factory.test.js","sourceRoot":"","sources":["../../src/__tests__/parser-factory.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/python-parser.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Test Python parser
- */
-export {};
-//# sourceMappingURL=python-parser.test.d.ts.map

package/dist/__tests__/python-parser.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"python-parser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/python-parser.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}