@aiready/core 0.23.5 → 0.23.7

package/dist/index.js

@@ -111,8 +111,6 @@ __export(index_exports, {
   estimateCostFromBudget: () => estimateCostFromBudget,
   estimateTokens: () => estimateTokens,
   exportHistory: () => exportHistory,
-  extractFunctions: () => extractFunctions,
-  extractImports: () => extractImports,
   findLatestReport: () => findLatestReport,
   findLatestScanReport: () => findLatestScanReport,
   formatAcceptanceRate: () => formatAcceptanceRate,
@@ -158,7 +156,6 @@ __export(index_exports, {
   loadScoreHistory: () => loadScoreHistory,
   mergeConfigWithDefaults: () => mergeConfigWithDefaults,
   normalizeToolName: () => normalizeToolName,
-  parseCode: () => parseCode,
   parseFileExports: () => parseFileExports,
   parseWeightString: () => parseWeightString,
   predictAcceptanceRate: () => predictAcceptanceRate,
@@ -857,7 +854,7 @@ function resolveOutputPath(userPath, defaultFilename, workingDir = process.cwd()
       if ((0, import_fs2.statSync)(workingDir).isFile()) {
         baseDir = (0, import_path2.dirname)(workingDir);
       }
-    } catch (e) {
+    } catch {
     }
     const aireadyDir = (0, import_path2.join)(baseDir, ".aiready");
     outputPath = (0, import_path2.join)(aireadyDir, defaultFilename);
@@ -1029,8 +1026,8 @@ function findLatestScanReport(scanReportsDir, reportFilePrefix) {
       return idB - idA;
     });
     return (0, import_path2.join)(scanReportsDir, reportFiles[0]);
-  } catch (e) {
-    console.error("Error while finding latest scan report:", e);
+  } catch {
+    console.error("Error while finding latest scan report");
     return null;
   }
 }
@@ -1095,7 +1092,19 @@ function createProvider(config) {
   };
 }
 
-// src/utils/ast-parser.ts
+// src/utils/similarity-utils.ts
+function calculateImportSimilarity(export1, export2) {
+  if (export1.imports.length === 0 && export2.imports.length === 0) {
+    return 1;
+  }
+  const set1 = new Set(export1.imports);
+  const set2 = new Set(export2.imports);
+  const intersection = new Set([...set1].filter((x) => set2.has(x)));
+  const union = /* @__PURE__ */ new Set([...set1, ...set2]);
+  return intersection.size / union.size;
+}
+
+// src/utils/dependency-analyzer.ts
 var import_typescript_estree2 = require("@typescript-eslint/typescript-estree");
 
 // src/parsers/typescript-parser.ts
@@ -1125,7 +1134,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 +1143,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 +1469,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
+              }
+            }
           };
         }
       }
@@ -1682,11 +1729,24 @@ var PythonParser = class extends BaseLanguageParser {
   getParserName() {
     return "python";
   }
+  /**
+   * Analyze metadata for a Python node (purity, side effects).
+   *
+   * @param node - Tree-sitter node to analyze.
+   * @param code - Source code for context.
+   * @returns Partial ExportInfo containing discovered metadata.
+   */
   analyzeMetadata(node, code) {
     return analyzeNodeMetadata(node, code, {
       sideEffectSignatures: ["print(", "input(", "open("]
     });
   }
+  /**
+   * Extract import information using AST walk.
+   *
+   * @param rootNode - Root node of the Python AST.
+   * @returns Array of discovered ImportInfo objects.
+   */
   extractImportsAST(rootNode) {
     const imports = [];
     const processImportNode = (node) => {
@@ -1768,6 +1828,13 @@ var PythonParser = class extends BaseLanguageParser {
     }
     return imports;
   }
+  /**
+   * Extract export information using AST walk.
+   *
+   * @param rootNode - Root node of the Python AST.
+   * @param code - Source code for documentation extraction.
+   * @returns Array of discovered ExportInfo objects.
+   */
   extractExportsAST(rootNode, code) {
     const exports2 = [];
     for (const node of rootNode.children) {
@@ -1846,6 +1913,12 @@ var PythonParser = class extends BaseLanguageParser {
     }
     return exports2;
   }
+  /**
+   * Extract parameter names from a function definition node.
+   *
+   * @param node - Function definition node.
+   * @returns Array of parameter name strings.
+   */
   extractParameters(node) {
     const paramsNode = node.childForFieldName("parameters");
     if (!paramsNode) return [];
@@ -1859,6 +1932,13 @@ var PythonParser = class extends BaseLanguageParser {
       return "unknown";
     });
   }
+  /**
+   * Fallback regex-based parsing when tree-sitter is unavailable.
+   *
+   * @param code - Source code content.
+   * @param filePath - Path to the file being parsed.
+   * @returns Consolidated ParseResult.
+   */
   parseRegex(code, filePath) {
     try {
       const imports = this.extractImportsRegex(code, filePath);
@@ -2132,6 +2212,13 @@ var JavaParser = class extends BaseLanguageParser {
   getParserName() {
     return "java";
   }
+  /**
+   * Analyze metadata for a Java node (purity, side effects).
+   *
+   * @param node - Tree-sitter node to analyze.
+   * @param code - Source code for context.
+   * @returns Partial ExportInfo containing discovered metadata.
+   */
   analyzeMetadata(node, code) {
     return analyzeGeneralMetadata(node, code, {
       sideEffectSignatures: [
@@ -2211,6 +2298,12 @@ var JavaParser = class extends BaseLanguageParser {
       warnings: ["Parser falling back to regex-based analysis"]
     };
   }
+  /**
+   * Extract import information using AST walk.
+   *
+   * @param rootNode - Root node of the Java AST.
+   * @returns Array of discovered ImportInfo objects.
+   */
   extractImportsAST(rootNode) {
     const imports = [];
     for (const node of rootNode.children) {
@@ -2244,6 +2337,13 @@ var JavaParser = class extends BaseLanguageParser {
     }
     return imports;
   }
+  /**
+   * Extract export information (classes, interfaces, methods) using AST walk.
+   *
+   * @param rootNode - Root node of the Java AST.
+   * @param code - Source code for documentation extraction.
+   * @returns Array of discovered ExportInfo objects.
+   */
   extractExportsAST(rootNode, code) {
     const exports2 = [];
     for (const node of rootNode.children) {
@@ -2274,11 +2374,25 @@ var JavaParser = class extends BaseLanguageParser {
     }
     return exports2;
   }
+  /**
+   * Extract modifiers (visibility, static, etc.) from a node.
+   *
+   * @param node - AST node to extract modifiers from.
+   * @returns Array of modifier strings.
+   */
   getModifiers(node) {
     const modifiersNode = node.children.find((c) => c.type === "modifiers");
     if (!modifiersNode) return [];
     return modifiersNode.children.map((c) => c.text);
   }
+  /**
+   * Extract methods and nested exports from a class or interface body.
+   *
+   * @param parentNode - Class or interface declaration node.
+   * @param parentName - Name of the parent class/interface.
+   * @param exports - Array to collect discovered exports into.
+   * @param code - Source code for context.
+   */
   extractSubExports(parentNode, parentName, exports2, code) {
     const bodyNode = parentNode.children.find((c) => c.type === "class_body");
     if (!bodyNode) return;
@@ -2337,11 +2451,24 @@ var CSharpParser = class extends BaseLanguageParser {
   getParserName() {
     return "c_sharp";
   }
+  /**
+   * Analyze metadata for a C# node (purity, side effects).
+   *
+   * @param node - Tree-sitter node to analyze.
+   * @param code - Source code for context.
+   * @returns Partial ExportInfo containing discovered metadata.
+   */
   analyzeMetadata(node, code) {
     return analyzeGeneralMetadata(node, code, {
       sideEffectSignatures: ["Console.Write", "File.Write", "Logging."]
     });
   }
+  /**
+   * Fallback regex-based parsing when tree-sitter is unavailable.
+   *
+   * @param code - Source code content.
+   * @returns Consolidated ParseResult.
+   */
   parseRegex(code) {
     const lines = code.split("\n");
     const exports2 = [];
@@ -2403,6 +2530,12 @@ var CSharpParser = class extends BaseLanguageParser {
       warnings: ["Parser falling back to regex-based analysis"]
     };
   }
+  /**
+   * Extract import information (usings) using AST walk.
+   *
+   * @param rootNode - Root node of the C# AST.
+   * @returns Array of discovered ImportInfo objects.
+   */
   extractImportsAST(rootNode) {
     const imports = [];
     const findUsings = (node) => {
@@ -2436,6 +2569,14 @@ var CSharpParser = class extends BaseLanguageParser {
     findUsings(rootNode);
     return imports;
   }
+  /**
+   * Extract export information (classes, methods, properties) using AST walk.
+   * Handles nested namespaces and classes.
+   *
+   * @param rootNode - Root node of the C# AST.
+   * @param code - Source code for documentation extraction.
+   * @returns Array of discovered ExportInfo objects.
+   */
   extractExportsAST(rootNode, code) {
     const exports2 = [];
     const traverse = (node, currentNamespace, currentClass) => {
@@ -2547,11 +2688,24 @@ var GoParser = class extends BaseLanguageParser {
   getParserName() {
     return "go";
   }
+  /**
+   * Analyze metadata for a Go node (purity, side effects).
+   *
+   * @param node - Tree-sitter node to analyze.
+   * @param code - Source code for context.
+   * @returns Partial ExportInfo containing discovered metadata.
+   */
   analyzeMetadata(node, code) {
     return analyzeGeneralMetadata(node, code, {
       sideEffectSignatures: ["<-", "fmt.Print", "fmt.Fprintf", "os.Exit"]
     });
   }
+  /**
+   * Fallback regex-based parsing when tree-sitter is unavailable.
+   *
+   * @param code - Source code content.
+   * @returns Consolidated ParseResult.
+   */
   parseRegex(code) {
     const lines = code.split("\n");
     const exports2 = [];
@@ -2629,6 +2783,12 @@ var GoParser = class extends BaseLanguageParser {
       warnings: ["Parser falling back to regex-based analysis"]
     };
   }
+  /**
+   * Extract import information using AST walk.
+   *
+   * @param rootNode - Root node of the Go AST.
+   * @returns Array of discovered ImportInfo objects.
+   */
   extractImportsAST(rootNode) {
     const imports = [];
     const findImports = (node) => {
@@ -2662,6 +2822,13 @@ var GoParser = class extends BaseLanguageParser {
     findImports(rootNode);
     return imports;
   }
+  /**
+   * Extract export information (functions, types, vars) using AST walk.
+   *
+   * @param rootNode - Root node of the Go AST.
+   * @param code - Source code for documentation extraction.
+   * @returns Array of discovered ExportInfo objects.
+   */
   extractExportsAST(rootNode, code) {
     const exports2 = [];
     const isExported = (name) => {
@@ -3018,7 +3185,7 @@ function extractTypeReferences(node) {
   return Array.from(types);
 }
 
-// src/utils/ast-parser.ts
+// src/utils/dependency-analyzer.ts
 function parseFileExports(code, filePath) {
   const parser = getParser(filePath);
   if (parser && parser.language !== "typescript" /* TypeScript */ && parser.language !== "javascript" /* JavaScript */) {
@@ -3060,29 +3227,6 @@ function parseFileExports(code, filePath) {
     return { exports: [], imports: [] };
   }
 }
-function calculateImportSimilarity(export1, export2) {
-  if (export1.imports.length === 0 && export2.imports.length === 0) {
-    return 1;
-  }
-  const set1 = new Set(export1.imports);
-  const set2 = new Set(export2.imports);
-  const intersection = new Set([...set1].filter((x) => set2.has(x)));
-  const union = /* @__PURE__ */ new Set([...set1, ...set2]);
-  return intersection.size / union.size;
-}
-function parseCode(_code, _language) {
-  void _code;
-  void _language;
-  return null;
-}
-function extractFunctions(_ast) {
-  void _ast;
-  return [];
-}
-function extractImports(_ast) {
-  void _ast;
-  return [];
-}
 
 // src/utils/metrics.ts
 function estimateTokens(text) {
@@ -4619,14 +4763,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 +4800,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 +4822,8 @@ function calculateDocDrift(params) {
     dimensions: {
       uncommentedExports,
       outdatedComments,
-      undocumentedComplexity
+      undocumentedComplexity,
+      actualDrift
     },
     recommendations
   };
@@ -5152,8 +5319,6 @@ function emitIssuesAsAnnotations(issues) {
   estimateCostFromBudget,
   estimateTokens,
   exportHistory,
-  extractFunctions,
-  extractImports,
   findLatestReport,
   findLatestScanReport,
   formatAcceptanceRate,
@@ -5199,7 +5364,6 @@ function emitIssuesAsAnnotations(issues) {
   loadScoreHistory,
   mergeConfigWithDefaults,
   normalizeToolName,
-  parseCode,
   parseFileExports,
   parseWeightString,
   predictAcceptanceRate,