@aiready/core 0.21.18 → 0.22.0

package/dist/index.js

@@ -57,6 +57,8 @@ __export(index_exports, {
   ParseError: () => ParseError,
   ParserFactory: () => ParserFactory,
   PythonParser: () => PythonParser,
+  ReadinessRating: () => ReadinessRating,
+  RecommendationPriority: () => RecommendationPriority,
   SEVERITY_TIME_ESTIMATES: () => SEVERITY_TIME_ESTIMATES,
   SIZE_ADJUSTED_THRESHOLDS: () => SIZE_ADJUSTED_THRESHOLDS,
   Severity: () => Severity,
@@ -93,6 +95,8 @@ __export(index_exports, {
   calculateTestabilityIndex: () => calculateTestabilityIndex,
   calculateTokenBudget: () => calculateTokenBudget,
   clearHistory: () => clearHistory,
+  emitAnnotation: () => emitAnnotation,
+  emitIssuesAsAnnotations: () => emitIssuesAsAnnotations,
   emitProgress: () => emitProgress,
   estimateCostFromBudget: () => estimateCostFromBudget,
   estimateTokens: () => estimateTokens,
@@ -146,6 +150,7 @@ __export(index_exports, {
   scanEntries: () => scanEntries,
   scanFiles: () => scanFiles,
   setupParser: () => setupParser,
+  severityToAnnotationLevel: () => severityToAnnotationLevel,
   validateSpokeOutput: () => validateSpokeOutput,
   validateWithSchema: () => validateWithSchema
 });
@@ -291,7 +296,12 @@ var UnifiedReportSchema = import_zod.z.object({
     totalFiles: import_zod.z.number(),
     totalIssues: import_zod.z.number(),
     criticalIssues: import_zod.z.number(),
-    majorIssues: import_zod.z.number()
+    majorIssues: import_zod.z.number(),
+    businessImpact: import_zod.z.object({
+      estimatedMonthlyWaste: import_zod.z.number().optional(),
+      potentialSavings: import_zod.z.number().optional(),
+      productivityHours: import_zod.z.number().optional()
+    }).optional()
   }),
   results: import_zod.z.array(AnalysisResultSchema),
   scoring: import_zod.z.object({
@@ -428,51 +438,61 @@ function validateWithSchema(schema, data) {
 }
 
 // src/registry.ts
-var ToolRegistry = class {
-  static getProviders() {
-    const g = globalThis;
-    if (!g.__AIRE_TOOL_REGISTRY__) {
-      g.__AIRE_TOOL_REGISTRY__ = /* @__PURE__ */ new Map();
-    }
-    return g.__AIRE_TOOL_REGISTRY__;
+var ToolRegistry = class _ToolRegistry {
+  /**
+   * Create a new ToolRegistry instance
+   *
+   * @param id Optional identifier for the registry (e.g. for debugging)
+   */
+  constructor(id = "default") {
+    this.providers = /* @__PURE__ */ new Map();
+    this.id = `registry-${id}-${Math.random().toString(36).substring(2, 9)}`;
   }
   /**
    * Register a new tool provider.
+   *
+   * @param provider The tool provider to register
    */
-  static register(provider) {
-    console.log(
-      `[ToolRegistry#${this.instanceId}] Registering tool: ${provider.id} (${provider.alias.join(", ")})`
-    );
-    this.getProviders().set(provider.id, provider);
+  register(provider) {
+    this.providers.set(provider.id, provider);
   }
   /**
    * Get a provider by its canonical ID.
+   *
+   * @param id The tool ID
+   * @returns The provider if found
    */
-  static get(id) {
-    return this.getProviders().get(id);
+  get(id) {
+    return this.providers.get(id);
   }
   /**
    * Get a provider by name or alias.
+   *
+   * @param nameOrAlias The tool name or alias string
+   * @returns The provider if found
    */
-  static find(nameOrAlias) {
-    const providers = this.getProviders();
-    const exact = providers.get(nameOrAlias);
+  find(nameOrAlias) {
+    const exact = this.providers.get(nameOrAlias);
     if (exact) return exact;
-    for (const p of providers.values()) {
+    for (const p of this.providers.values()) {
       if (p.alias.includes(nameOrAlias)) return p;
     }
     return void 0;
   }
   /**
    * Get all registered tool providers.
+   *
+   * @returns Array of all registered tool providers
    */
-  static getAll() {
-    return Array.from(this.getProviders().values());
+  getAll() {
+    return Array.from(this.providers.values());
   }
   /**
    * Get all available tool IDs from the ToolName enum.
+   *
+   * @returns Array of valid ToolName identifiers
    */
-  static getAvailableIds() {
+  getAvailableIds() {
     return Object.values(ToolName).filter(
       (v) => typeof v === "string"
     );
@@ -480,11 +500,54 @@ var ToolRegistry = class {
   /**
    * Clear the registry (primarily for testing).
    */
+  clear() {
+    this.providers.clear();
+  }
+  // --- Static Compatibility Layer ---
+  static getGlobalRegistry() {
+    const g = globalThis;
+    if (!g.__AIRE_TOOL_REGISTRY_INSTANCE__) {
+      g.__AIRE_TOOL_REGISTRY_INSTANCE__ = new _ToolRegistry("global");
+    }
+    return g.__AIRE_TOOL_REGISTRY_INSTANCE__;
+  }
+  /**
+   * Static register (Singleton compatibility)
+   */
+  static register(provider) {
+    this.getGlobalRegistry().register(provider);
+  }
+  /**
+   * Static get (Singleton compatibility)
+   */
+  static get(id) {
+    return this.getGlobalRegistry().get(id);
+  }
+  /**
+   * Static find (Singleton compatibility)
+   */
+  static find(nameOrAlias) {
+    return this.getGlobalRegistry().find(nameOrAlias);
+  }
+  /**
+   * Static getAll (Singleton compatibility)
+   */
+  static getAll() {
+    return this.getGlobalRegistry().getAll();
+  }
+  /**
+   * Static getAvailableIds (Singleton compatibility)
+   */
+  static getAvailableIds() {
+    return this.getGlobalRegistry().getAvailableIds();
+  }
+  /**
+   * Static clear (Singleton compatibility)
+   */
   static clear() {
-    this.getProviders().clear();
+    this.getGlobalRegistry().clear();
   }
 };
-ToolRegistry.instanceId = globalThis.Math.random();
 
 // src/utils/file-scanner.ts
 var import_glob = require("glob");
@@ -596,7 +659,8 @@ async function scanFiles(options) {
   });
   const gitignoreFiles = await (0, import_glob.glob)("**/.gitignore", {
     cwd: rootDir,
-    ignore: finalExclude,
+    ignore: (exclude || []).concat(["**/node_modules/**", "**/.git/**"]),
+    // Minimal ignore for gitignore discovery
     absolute: true
   });
   if (gitignoreFiles.length > 0) {
@@ -663,7 +727,7 @@ async function scanEntries(options) {
   });
   const gitignoreFiles = await (0, import_glob.glob)("**/.gitignore", {
     cwd: rootDir,
-    ignore: finalExclude,
+    ignore: (exclude || []).concat(["**/node_modules/**", "**/.git/**"]),
     absolute: true
   });
   if (gitignoreFiles.length > 0) {
@@ -687,8 +751,9 @@ async function scanEntries(options) {
       }
     }
     const filteredDirs = dirs.filter((d) => {
-      const rel = (0, import_path.relative)(rootDir || ".", d).replace(/\\/g, "/").replace(/\/$/, "");
+      let rel = (0, import_path.relative)(rootDir || ".", d).replace(/\\/g, "/");
       if (rel === "") return true;
+      if (!rel.endsWith("/")) rel += "/";
       return !ig.ignores(rel);
     });
     return { files, dirs: filteredDirs };
@@ -753,7 +818,8 @@ function getElapsedTime(startTime) {
   return ((Date.now() - startTime) / 1e3).toFixed(2);
 }
 function getScoreBar(val) {
-  return "\u2588".repeat(Math.round(val / 10)).padEnd(10, "\u2591");
+  const clamped = Math.max(0, Math.min(100, val));
+  return "\u2588".repeat(Math.round(clamped / 10)).padEnd(10, "\u2591");
 }
 function getSafetyIcon(rating) {
   switch (rating) {
@@ -1014,7 +1080,7 @@ var TypeScriptParser = class {
   extractFromDeclaration(declaration, importedNames, code, parentNode) {
     const exports2 = [];
     const metadata = this.analyzeMetadata(parentNode || declaration, code);
-    if (declaration.type === "FunctionDeclaration" && declaration.id) {
+    if ((declaration.type === "FunctionDeclaration" || declaration.type === "TSDeclareFunction") && declaration.id) {
       exports2.push({
         name: declaration.id.name,
         type: "function",
@@ -1042,11 +1108,21 @@ var TypeScriptParser = class {
       const body = declaration.body.body;
       const methods = body.filter((m) => m.type === "MethodDefinition");
       const properties = body.filter((m) => m.type === "PropertyDefinition");
+      const constructor = methods.find(
+        (m) => m.kind === "constructor"
+      );
+      const parameters = constructor ? constructor.value.params.map((p) => {
+        if (p.type === "Identifier") return p.name;
+        if (p.type === "TSParameterProperty" && p.parameter.type === "Identifier")
+          return p.parameter.name;
+        return "unknown";
+      }) : [];
       exports2.push({
         name: declaration.id.name,
         type: "class",
         methodCount: methods.length,
         propertyCount: properties.length,
+        parameters,
         loc: declaration.loc ? {
           start: {
             line: declaration.loc.start.line,
@@ -2493,6 +2569,9 @@ var GoParser = class {
 
 // src/parsers/parser-factory.ts
 var ParserFactory = class _ParserFactory {
+  /**
+   * Create a new ParserFactory instance
+   */
   constructor() {
     this.parsers = /* @__PURE__ */ new Map();
     this.extensionMap = new Map(
@@ -2505,7 +2584,9 @@ var ParserFactory = class _ParserFactory {
     this.registerParser(new GoParser());
   }
   /**
-   * Get singleton instance
+   * Get the global singleton instance
+   *
+   * @returns The singleton ParserFactory instance
    */
   static getInstance() {
     if (!_ParserFactory.instance) {
@@ -3052,6 +3133,20 @@ function generateHTML(graph) {
 }
 
 // src/scoring.ts
+var RecommendationPriority = /* @__PURE__ */ ((RecommendationPriority2) => {
+  RecommendationPriority2["High"] = "high";
+  RecommendationPriority2["Medium"] = "medium";
+  RecommendationPriority2["Low"] = "low";
+  return RecommendationPriority2;
+})(RecommendationPriority || {});
+var ReadinessRating = /* @__PURE__ */ ((ReadinessRating2) => {
+  ReadinessRating2["Excellent"] = "Excellent";
+  ReadinessRating2["Good"] = "Good";
+  ReadinessRating2["Fair"] = "Fair";
+  ReadinessRating2["NeedsWork"] = "Needs Work";
+  ReadinessRating2["Critical"] = "Critical";
+  return ReadinessRating2;
+})(ReadinessRating || {});
 var DEFAULT_TOOL_WEIGHTS = {
   ["pattern-detect" /* PatternDetect */]: 22,
   ["context-analyzer" /* ContextAnalyzer */]: 19,
@@ -3126,10 +3221,10 @@ function parseWeightString(weightStr) {
   if (!weightStr) return weights;
   const pairs = weightStr.split(",");
   for (const pair of pairs) {
-    const [toolShortName, weightStr2] = pair.split(":");
-    if (toolShortName && weightStr2) {
+    const [toolShortName, weightValueStr] = pair.split(":");
+    if (toolShortName && weightValueStr) {
       const toolName = normalizeToolName(toolShortName.trim());
-      const weight = parseInt(weightStr2.trim(), 10);
+      const weight = parseInt(weightValueStr.trim(), 10);
       if (!isNaN(weight) && weight > 0) {
         weights.set(toolName, weight);
       }
@@ -3184,11 +3279,11 @@ function calculateOverallScore(toolOutputs, config, cliWeights) {
   };
 }
 function getRating(score) {
-  if (score >= 90) return "Excellent";
-  if (score >= 75) return "Good";
-  if (score >= 60) return "Fair";
-  if (score >= 40) return "Needs Work";
-  return "Critical";
+  if (score >= 90) return "Excellent" /* Excellent */;
+  if (score >= 75) return "Good" /* Good */;
+  if (score >= 60) return "Fair" /* Fair */;
+  if (score >= 40) return "Needs Work" /* NeedsWork */;
+  return "Critical" /* Critical */;
 }
 function getRatingWithContext(score, fileCount, modelTier = "standard") {
   const threshold = getRecommendedThreshold(fileCount, modelTier);
@@ -3197,16 +3292,18 @@ function getRatingWithContext(score, fileCount, modelTier = "standard") {
 }
 function getRatingDisplay(rating) {
   switch (rating) {
-    case "Excellent":
+    case "Excellent" /* Excellent */:
       return { emoji: "\u2705", color: "green" };
-    case "Good":
+    case "Good" /* Good */:
       return { emoji: "\u{1F44D}", color: "blue" };
-    case "Fair":
+    case "Fair" /* Fair */:
       return { emoji: "\u26A0\uFE0F", color: "yellow" };
-    case "Needs Work":
+    case "Needs Work" /* NeedsWork */:
       return { emoji: "\u{1F528}", color: "orange" };
-    case "Critical":
+    case "Critical" /* Critical */:
       return { emoji: "\u274C", color: "red" };
+    default:
+      return { emoji: "\u2753", color: "gray" };
   }
 }
 function formatScore(result) {
@@ -3231,7 +3328,12 @@ function formatToolScore(output) {
     result += `  Recommendations:
 `;
     output.recommendations.forEach((rec, i) => {
-      const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+      let priorityIcon = "\u{1F535}";
+      const prio = rec.priority;
+      if (prio === "high" /* High */ || prio === "high")
+        priorityIcon = "\u{1F534}";
+      else if (prio === "medium" /* Medium */ || prio === "medium")
+        priorityIcon = "\u{1F7E1}";
       result += `    ${i + 1}. ${priorityIcon} ${rec.action}
 `;
       result += `       Impact: +${rec.estimatedImpact} points
@@ -3313,15 +3415,17 @@ var DEFAULT_COST_CONFIG = {
   daysPerMonth: 30
 };
 function calculateMonthlyCost(tokenWaste, config = {}) {
+  const multiplier = tokenWaste > 5e4 ? 5 : tokenWaste > 1e4 ? 3.5 : 2.5;
   const budget = calculateTokenBudget({
-    totalContextTokens: tokenWaste * 2.5,
+    totalContextTokens: tokenWaste * multiplier,
     wastedTokens: {
       duplication: tokenWaste * 0.7,
       fragmentation: tokenWaste * 0.3,
-      chattiness: 0
+      chattiness: 0.1 * tokenWaste
+      // Added baseline chattiness
     }
   });
-  const preset = getModelPreset("claude-4.6");
+  const preset = getModelPreset("claude-3.5-sonnet");
   return estimateCostFromBudget(budget, preset, config);
 }
 function calculateTokenBudget(params) {
@@ -3803,7 +3907,7 @@ function calculatePatternEntropy(files) {
   }
   const dirGroups = /* @__PURE__ */ new Map();
   for (const file of files) {
-    const parts = file.path.split("/").slice(0, 4).join("/") || "root";
+    const parts = file.path.split("/").slice(0, -1).join("/") || "root";
     dirGroups.set(parts, (dirGroups.get(parts) || 0) + 1);
   }
   const counts = Array.from(dirGroups.values());
@@ -3910,6 +4014,8 @@ function calculateAiSignalClarity(params) {
     deepCallbacks,
     ambiguousNames,
     undocumentedExports,
+    largeFiles = 0,
+    // Default to 0 to prevent NaN
     totalSymbols,
     totalExports
   } = params;
@@ -3926,28 +4032,35 @@ function calculateAiSignalClarity(params) {
   const overloadSignal = {
     name: "Symbol Overloading",
     count: overloadedSymbols,
-    riskContribution: Math.round(Math.min(1, overloadRatio) * 100 * 0.25),
+    riskContribution: Math.round(Math.min(1, overloadRatio) * 100 * 0.2),
     description: `${overloadedSymbols} overloaded symbols \u2014 AI picks wrong signature`
   };
+  const largeFileSignal = {
+    name: "Large Files",
+    count: largeFiles,
+    riskContribution: Math.round(Math.min(5, largeFiles) * 5),
+    // up to 25 points
+    description: `${largeFiles} large files \u2014 pushing AI context limits`
+  };
   const magicRatio = magicLiterals / Math.max(1, totalSymbols * 2);
   const magicSignal = {
     name: "Magic Literals",
     count: magicLiterals,
-    riskContribution: Math.round(Math.min(1, magicRatio) * 100 * 0.2),
+    riskContribution: Math.round(Math.min(1, magicRatio) * 100 * 0.15),
     description: `${magicLiterals} unnamed constants \u2014 AI invents wrong values`
   };
   const trapRatio = booleanTraps / Math.max(1, totalSymbols);
   const trapSignal = {
     name: "Boolean Traps",
     count: booleanTraps,
-    riskContribution: Math.round(Math.min(1, trapRatio) * 100 * 0.2),
+    riskContribution: Math.round(Math.min(1, trapRatio) * 100 * 0.15),
     description: `${booleanTraps} boolean trap parameters \u2014 AI inverts intent`
   };
   const sideEffectRatio = implicitSideEffects / Math.max(1, totalExports);
   const sideEffectSignal = {
     name: "Implicit Side Effects",
     count: implicitSideEffects,
-    riskContribution: Math.round(Math.min(1, sideEffectRatio) * 100 * 0.15),
+    riskContribution: Math.round(Math.min(1, sideEffectRatio) * 100 * 0.1),
     description: `${implicitSideEffects} functions with implicit side effects \u2014 AI misses contracts`
   };
   const callbackRatio = deepCallbacks / Math.max(1, totalSymbols * 0.1);
@@ -3961,18 +4074,19 @@ function calculateAiSignalClarity(params) {
   const ambiguousSignal = {
     name: "Ambiguous Names",
     count: ambiguousNames,
-    riskContribution: Math.round(Math.min(1, ambiguousRatio) * 100 * 0.1),
+    riskContribution: Math.round(Math.min(1, ambiguousRatio) * 100 * 0.05),
     description: `${ambiguousNames} non-descriptive identifiers \u2014 AI guesses wrong intent`
   };
   const undocRatio = undocumentedExports / Math.max(1, totalExports);
   const undocSignal = {
     name: "Undocumented Exports",
     count: undocumentedExports,
-    riskContribution: Math.round(Math.min(1, undocRatio) * 100 * 0.1),
+    riskContribution: Math.round(Math.min(1, undocRatio) * 100 * 0.05),
     description: `${undocumentedExports} public functions without docs \u2014 AI fabricates behavior`
   };
   const signals = [
     overloadSignal,
+    largeFileSignal,
     magicSignal,
     trapSignal,
     sideEffectSignal,
@@ -3995,6 +4109,10 @@ function calculateAiSignalClarity(params) {
   );
   const topRisk = topSignal.riskContribution > 0 ? topSignal.description : "No significant issues detected";
   const recommendations = [];
+  if (largeFileSignal.riskContribution > 5)
+    recommendations.push(
+      `Split ${largeFiles} large files (> 500 lines) into smaller, single-responsibility modules`
+    );
   if (overloadSignal.riskContribution > 5)
     recommendations.push(
       `Rename ${overloadedSymbols} overloaded symbols to unique, intent-revealing names`
@@ -4630,6 +4748,46 @@ function getRepoMetadata(directory) {
   }
   return metadata;
 }
+
+// src/utils/github-utils.ts
+function emitAnnotation(params) {
+  const { level, file, line, col, title, message } = params;
+  const parts = [];
+  if (file) parts.push(`file=${file}`);
+  if (line) parts.push(`line=${line}`);
+  if (col) parts.push(`col=${col}`);
+  if (title) parts.push(`title=${title}`);
+  const metadata = parts.length > 0 ? ` ${parts.join(",")}` : "";
+  console.log(`::${level}${metadata}::${message.replace(/\n/g, "%0A")}`);
+}
+function severityToAnnotationLevel(severity) {
+  switch (severity.toLowerCase()) {
+    case "critical":
+    case "high-risk":
+    case "blind-risk":
+      return "error";
+    case "major":
+    case "moderate-risk":
+      return "warning";
+    case "minor":
+    case "info":
+    case "safe":
+    default:
+      return "notice";
+  }
+}
+function emitIssuesAsAnnotations(issues) {
+  issues.forEach((issue) => {
+    emitAnnotation({
+      level: severityToAnnotationLevel(issue.severity || "info"),
+      file: issue.file || issue.fileName || "",
+      line: issue.line || issue.location?.start?.line,
+      col: issue.column || issue.location?.start?.column,
+      title: `${issue.tool || "AIReady"}: ${issue.type || "Issue"}`,
+      message: issue.message || issue.description || "No description provided"
+    });
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AnalysisResultSchema,
@@ -4659,6 +4817,8 @@ function getRepoMetadata(directory) {
   ParseError,
   ParserFactory,
   PythonParser,
+  ReadinessRating,
+  RecommendationPriority,
   SEVERITY_TIME_ESTIMATES,
   SIZE_ADJUSTED_THRESHOLDS,
   Severity,
@@ -4695,6 +4855,8 @@ function getRepoMetadata(directory) {
   calculateTestabilityIndex,
   calculateTokenBudget,
   clearHistory,
+  emitAnnotation,
+  emitIssuesAsAnnotations,
   emitProgress,
   estimateCostFromBudget,
   estimateTokens,
@@ -4748,6 +4910,7 @@ function getRepoMetadata(directory) {
   scanEntries,
   scanFiles,
   setupParser,
+  severityToAnnotationLevel,
   validateSpokeOutput,
   validateWithSchema
 });