@aiready/core 0.7.7 → 0.7.10

package/dist/index.d.mts

@@ -34,9 +34,12 @@ interface AIReadyConfig {
     scan?: {
         include?: string[];
         exclude?: string[];
+        tools?: string[];
     };
     tools?: {
         'pattern-detect'?: {
+            enabled?: boolean;
+            scoreWeight?: number;
             minSimilarity?: number;
             minLines?: number;
             batchSize?: number;
@@ -47,6 +50,8 @@ interface AIReadyConfig {
             maxResults?: number;
         };
         'context-analyzer'?: {
+            enabled?: boolean;
+            scoreWeight?: number;
             maxDepth?: number;
             maxContextBudget?: number;
             minCohesion?: number;
@@ -59,10 +64,23 @@ interface AIReadyConfig {
             pathDomainMap?: Record<string, string>;
         };
         'consistency'?: {
+            enabled?: boolean;
+            scoreWeight?: number;
             acceptedAbbreviations?: string[];
             shortWords?: string[];
             disableChecks?: ('single-letter' | 'abbreviation' | 'convention-mix' | 'unclear' | 'poor-naming')[];
         };
+        [toolName: string]: {
+            enabled?: boolean;
+            scoreWeight?: number;
+            [key: string]: any;
+        } | undefined;
+    };
+    scoring?: {
+        threshold?: number;
+        showBreakdown?: boolean;
+        compareBaseline?: string;
+        saveTo?: string;
     };
     output?: {
         format?: 'console' | 'json' | 'html';
@@ -85,6 +103,16 @@ interface Report {
 }
 
 declare const DEFAULT_EXCLUDE: string[];
+/**
+ * Scan files in a directory using glob patterns
+ *
+ * Note: This scanner includes multiple language file types by default (.ts, .tsx, .js, .jsx, .py, .java)
+ * to support potential multi-language analysis in the future. Individual tools (like @aiready/consistency)
+ * should filter to their supported languages before processing.
+ *
+ * @param options - Scan configuration
+ * @returns Array of absolute file paths matching the patterns
+ */
 declare function scanFiles(options: ScanOptions): Promise<string[]>;
 declare function readFileContent(filePath: string): Promise<string>;
 declare function getFileExtension(filePath: string): string;
@@ -186,4 +214,114 @@ declare function handleCLIError(error: unknown, commandName: string): never;
  */
 declare function getElapsedTime(startTime: number): string;
 
-export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, calculateImportSimilarity, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, readFileContent, resolveOutputPath, scanFiles };
+/**
+ * AI Readiness Scoring System
+ *
+ * Provides dynamic, composable scoring across multiple analysis tools.
+ * Each tool contributes a 0-100 score with configurable weights.
+ */
+interface ToolScoringOutput {
+    /** Unique tool identifier (e.g., "pattern-detect") */
+    toolName: string;
+    /** Normalized 0-100 score for this tool */
+    score: number;
+    /** Raw metrics used to calculate the score */
+    rawMetrics: Record<string, any>;
+    /** Factors that influenced the score */
+    factors: Array<{
+        name: string;
+        impact: number;
+        description: string;
+    }>;
+    /** Actionable recommendations with estimated impact */
+    recommendations: Array<{
+        action: string;
+        estimatedImpact: number;
+        priority: 'high' | 'medium' | 'low';
+    }>;
+}
+interface ScoringResult {
+    /** Overall AI Readiness Score (0-100) */
+    overall: number;
+    /** Rating category */
+    rating: 'Excellent' | 'Good' | 'Fair' | 'Needs Work' | 'Critical';
+    /** Timestamp of score calculation */
+    timestamp: string;
+    /** Tools that contributed to this score */
+    toolsUsed: string[];
+    /** Breakdown by tool */
+    breakdown: ToolScoringOutput[];
+    /** Calculation details */
+    calculation: {
+        formula: string;
+        weights: Record<string, number>;
+        normalized: string;
+    };
+}
+interface ScoringConfig {
+    /** Minimum passing score (exit code 1 if below) */
+    threshold?: number;
+    /** Show detailed breakdown in output */
+    showBreakdown?: boolean;
+    /** Path to baseline JSON for comparison */
+    compareBaseline?: string;
+    /** Auto-save score to this path */
+    saveTo?: string;
+}
+/**
+ * Default weights for known tools.
+ * New tools get weight of 10 if not specified.
+ */
+declare const DEFAULT_TOOL_WEIGHTS: Record<string, number>;
+/**
+ * Tool name normalization map (shorthand -> full name)
+ */
+declare const TOOL_NAME_MAP: Record<string, string>;
+/**
+ * Normalize tool name from shorthand to full name
+ */
+declare function normalizeToolName(shortName: string): string;
+/**
+ * Get tool weight with fallback priority:
+ * 1. CLI override
+ * 2. Tool config scoreWeight
+ * 3. Default weight
+ * 4. 10 (for unknown tools)
+ */
+declare function getToolWeight(toolName: string, toolConfig?: {
+    scoreWeight?: number;
+}, cliOverride?: number): number;
+/**
+ * Parse weight string from CLI (e.g., "patterns:50,context:30")
+ */
+declare function parseWeightString(weightStr?: string): Map<string, number>;
+/**
+ * Calculate overall AI Readiness Score from multiple tool scores.
+ *
+ * Formula: Σ(tool_score × tool_weight) / Σ(active_tool_weights)
+ *
+ * This allows dynamic composition - score adjusts automatically
+ * based on which tools actually ran.
+ */
+declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutput>, config?: any, cliWeights?: Map<string, number>): ScoringResult;
+/**
+ * Convert numeric score to rating category
+ */
+declare function getRating(score: number): ScoringResult['rating'];
+/**
+ * Get rating emoji and color for display
+ */
+declare function getRatingDisplay(rating: ScoringResult['rating']): {
+    emoji: string;
+    color: string;
+};
+/**
+ * Format score for display with rating
+ */
+declare function formatScore(result: ScoringResult): string;
+/**
+ * Format individual tool score for display
+ */
+declare function formatToolScore(output: ToolScoringOutput): string;
+
+export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, DEFAULT_EXCLUDE, DEFAULT_TOOL_WEIGHTS, type ExportWithImports, type FileImport, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, type ScoringConfig, type ScoringResult, TOOL_NAME_MAP, type ToolScoringOutput, calculateImportSimilarity, calculateOverallScore, estimateTokens, extractFunctions, extractImports, formatScore, formatToolScore, getElapsedTime, getFileExtension, getRating, getRatingDisplay, getToolWeight, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, normalizeToolName, parseCode, parseFileExports, parseWeightString, readFileContent, resolveOutputPath, scanFiles };

package/dist/index.d.ts

@@ -34,9 +34,12 @@ interface AIReadyConfig {
     scan?: {
         include?: string[];
         exclude?: string[];
+        tools?: string[];
     };
     tools?: {
         'pattern-detect'?: {
+            enabled?: boolean;
+            scoreWeight?: number;
             minSimilarity?: number;
             minLines?: number;
             batchSize?: number;
@@ -47,6 +50,8 @@ interface AIReadyConfig {
             maxResults?: number;
         };
         'context-analyzer'?: {
+            enabled?: boolean;
+            scoreWeight?: number;
             maxDepth?: number;
             maxContextBudget?: number;
             minCohesion?: number;
@@ -59,10 +64,23 @@ interface AIReadyConfig {
             pathDomainMap?: Record<string, string>;
         };
         'consistency'?: {
+            enabled?: boolean;
+            scoreWeight?: number;
             acceptedAbbreviations?: string[];
             shortWords?: string[];
             disableChecks?: ('single-letter' | 'abbreviation' | 'convention-mix' | 'unclear' | 'poor-naming')[];
         };
+        [toolName: string]: {
+            enabled?: boolean;
+            scoreWeight?: number;
+            [key: string]: any;
+        } | undefined;
+    };
+    scoring?: {
+        threshold?: number;
+        showBreakdown?: boolean;
+        compareBaseline?: string;
+        saveTo?: string;
     };
     output?: {
         format?: 'console' | 'json' | 'html';
@@ -85,6 +103,16 @@ interface Report {
 }
 
 declare const DEFAULT_EXCLUDE: string[];
+/**
+ * Scan files in a directory using glob patterns
+ *
+ * Note: This scanner includes multiple language file types by default (.ts, .tsx, .js, .jsx, .py, .java)
+ * to support potential multi-language analysis in the future. Individual tools (like @aiready/consistency)
+ * should filter to their supported languages before processing.
+ *
+ * @param options - Scan configuration
+ * @returns Array of absolute file paths matching the patterns
+ */
 declare function scanFiles(options: ScanOptions): Promise<string[]>;
 declare function readFileContent(filePath: string): Promise<string>;
 declare function getFileExtension(filePath: string): string;
@@ -186,4 +214,114 @@ declare function handleCLIError(error: unknown, commandName: string): never;
  */
 declare function getElapsedTime(startTime: number): string;
 
-export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, calculateImportSimilarity, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, readFileContent, resolveOutputPath, scanFiles };
+/**
+ * AI Readiness Scoring System
+ *
+ * Provides dynamic, composable scoring across multiple analysis tools.
+ * Each tool contributes a 0-100 score with configurable weights.
+ */
+interface ToolScoringOutput {
+    /** Unique tool identifier (e.g., "pattern-detect") */
+    toolName: string;
+    /** Normalized 0-100 score for this tool */
+    score: number;
+    /** Raw metrics used to calculate the score */
+    rawMetrics: Record<string, any>;
+    /** Factors that influenced the score */
+    factors: Array<{
+        name: string;
+        impact: number;
+        description: string;
+    }>;
+    /** Actionable recommendations with estimated impact */
+    recommendations: Array<{
+        action: string;
+        estimatedImpact: number;
+        priority: 'high' | 'medium' | 'low';
+    }>;
+}
+interface ScoringResult {
+    /** Overall AI Readiness Score (0-100) */
+    overall: number;
+    /** Rating category */
+    rating: 'Excellent' | 'Good' | 'Fair' | 'Needs Work' | 'Critical';
+    /** Timestamp of score calculation */
+    timestamp: string;
+    /** Tools that contributed to this score */
+    toolsUsed: string[];
+    /** Breakdown by tool */
+    breakdown: ToolScoringOutput[];
+    /** Calculation details */
+    calculation: {
+        formula: string;
+        weights: Record<string, number>;
+        normalized: string;
+    };
+}
+interface ScoringConfig {
+    /** Minimum passing score (exit code 1 if below) */
+    threshold?: number;
+    /** Show detailed breakdown in output */
+    showBreakdown?: boolean;
+    /** Path to baseline JSON for comparison */
+    compareBaseline?: string;
+    /** Auto-save score to this path */
+    saveTo?: string;
+}
+/**
+ * Default weights for known tools.
+ * New tools get weight of 10 if not specified.
+ */
+declare const DEFAULT_TOOL_WEIGHTS: Record<string, number>;
+/**
+ * Tool name normalization map (shorthand -> full name)
+ */
+declare const TOOL_NAME_MAP: Record<string, string>;
+/**
+ * Normalize tool name from shorthand to full name
+ */
+declare function normalizeToolName(shortName: string): string;
+/**
+ * Get tool weight with fallback priority:
+ * 1. CLI override
+ * 2. Tool config scoreWeight
+ * 3. Default weight
+ * 4. 10 (for unknown tools)
+ */
+declare function getToolWeight(toolName: string, toolConfig?: {
+    scoreWeight?: number;
+}, cliOverride?: number): number;
+/**
+ * Parse weight string from CLI (e.g., "patterns:50,context:30")
+ */
+declare function parseWeightString(weightStr?: string): Map<string, number>;
+/**
+ * Calculate overall AI Readiness Score from multiple tool scores.
+ *
+ * Formula: Σ(tool_score × tool_weight) / Σ(active_tool_weights)
+ *
+ * This allows dynamic composition - score adjusts automatically
+ * based on which tools actually ran.
+ */
+declare function calculateOverallScore(toolOutputs: Map<string, ToolScoringOutput>, config?: any, cliWeights?: Map<string, number>): ScoringResult;
+/**
+ * Convert numeric score to rating category
+ */
+declare function getRating(score: number): ScoringResult['rating'];
+/**
+ * Get rating emoji and color for display
+ */
+declare function getRatingDisplay(rating: ScoringResult['rating']): {
+    emoji: string;
+    color: string;
+};
+/**
+ * Format score for display with rating
+ */
+declare function formatScore(result: ScoringResult): string;
+/**
+ * Format individual tool score for display
+ */
+declare function formatToolScore(output: ToolScoringOutput): string;
+
+export { type AIReadyConfig, type ASTNode, type AnalysisResult, type CLIOptions, DEFAULT_EXCLUDE, DEFAULT_TOOL_WEIGHTS, type ExportWithImports, type FileImport, type Issue, type IssueType, type Location, type Metrics, type Report, type ScanOptions, type ScoringConfig, type ScoringResult, TOOL_NAME_MAP, type ToolScoringOutput, calculateImportSimilarity, calculateOverallScore, estimateTokens, extractFunctions, extractImports, formatScore, formatToolScore, getElapsedTime, getFileExtension, getRating, getRatingDisplay, getToolWeight, handleCLIError, handleJSONOutput, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, normalizeToolName, parseCode, parseFileExports, parseWeightString, readFileContent, resolveOutputPath, scanFiles };

package/dist/index.js

@@ -21,20 +21,30 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_EXCLUDE: () => DEFAULT_EXCLUDE,
+  DEFAULT_TOOL_WEIGHTS: () => DEFAULT_TOOL_WEIGHTS,
+  TOOL_NAME_MAP: () => TOOL_NAME_MAP,
   calculateImportSimilarity: () => calculateImportSimilarity,
+  calculateOverallScore: () => calculateOverallScore,
   estimateTokens: () => estimateTokens,
   extractFunctions: () => extractFunctions,
   extractImports: () => extractImports,
+  formatScore: () => formatScore,
+  formatToolScore: () => formatToolScore,
   getElapsedTime: () => getElapsedTime,
   getFileExtension: () => getFileExtension,
+  getRating: () => getRating,
+  getRatingDisplay: () => getRatingDisplay,
+  getToolWeight: () => getToolWeight,
   handleCLIError: () => handleCLIError,
   handleJSONOutput: () => handleJSONOutput,
   isSourceFile: () => isSourceFile,
   loadConfig: () => loadConfig,
   loadMergedConfig: () => loadMergedConfig,
   mergeConfigWithDefaults: () => mergeConfigWithDefaults,
+  normalizeToolName: () => normalizeToolName,
   parseCode: () => parseCode,
   parseFileExports: () => parseFileExports,
+  parseWeightString: () => parseWeightString,
   readFileContent: () => readFileContent,
   resolveOutputPath: () => resolveOutputPath,
   scanFiles: () => scanFiles
@@ -93,6 +103,7 @@ async function scanFiles(options) {
   const {
     rootDir,
     include = ["**/*.{ts,tsx,js,jsx,py,java}"],
+    // Broad default - tools should filter further
     exclude
   } = options;
   const finalExclude = exclude ? [.../* @__PURE__ */ new Set([...DEFAULT_EXCLUDE, ...exclude])] : DEFAULT_EXCLUDE;
@@ -408,23 +419,177 @@ function handleCLIError(error, commandName) {
 function getElapsedTime(startTime) {
   return ((Date.now() - startTime) / 1e3).toFixed(2);
 }
+
+// src/scoring.ts
+var DEFAULT_TOOL_WEIGHTS = {
+  "pattern-detect": 40,
+  "context-analyzer": 35,
+  "consistency": 25,
+  "doc-drift": 20,
+  "deps": 15
+};
+var TOOL_NAME_MAP = {
+  "patterns": "pattern-detect",
+  "context": "context-analyzer",
+  "consistency": "consistency",
+  "doc-drift": "doc-drift",
+  "deps": "deps"
+};
+function normalizeToolName(shortName) {
+  return TOOL_NAME_MAP[shortName] || shortName;
+}
+function getToolWeight(toolName, toolConfig, cliOverride) {
+  if (cliOverride !== void 0) {
+    return cliOverride;
+  }
+  if (toolConfig?.scoreWeight !== void 0) {
+    return toolConfig.scoreWeight;
+  }
+  return DEFAULT_TOOL_WEIGHTS[toolName] || 10;
+}
+function parseWeightString(weightStr) {
+  const weights = /* @__PURE__ */ new Map();
+  if (!weightStr) {
+    return weights;
+  }
+  const pairs = weightStr.split(",");
+  for (const pair of pairs) {
+    const [toolShortName, weightStr2] = pair.split(":");
+    if (toolShortName && weightStr2) {
+      const toolName = normalizeToolName(toolShortName.trim());
+      const weight = parseInt(weightStr2.trim(), 10);
+      if (!isNaN(weight) && weight > 0) {
+        weights.set(toolName, weight);
+      }
+    }
+  }
+  return weights;
+}
+function calculateOverallScore(toolOutputs, config, cliWeights) {
+  if (toolOutputs.size === 0) {
+    throw new Error("No tool outputs provided for scoring");
+  }
+  const weights = /* @__PURE__ */ new Map();
+  for (const [toolName] of toolOutputs.entries()) {
+    const cliWeight = cliWeights?.get(toolName);
+    const configWeight = config?.tools?.[toolName]?.scoreWeight;
+    const weight = cliWeight ?? configWeight ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 10;
+    weights.set(toolName, weight);
+  }
+  let weightedSum = 0;
+  let totalWeight = 0;
+  const breakdown = [];
+  const toolsUsed = [];
+  const calculationWeights = {};
+  for (const [toolName, output] of toolOutputs.entries()) {
+    const weight = weights.get(toolName) || 10;
+    const weightedScore = output.score * weight;
+    weightedSum += weightedScore;
+    totalWeight += weight;
+    toolsUsed.push(toolName);
+    calculationWeights[toolName] = weight;
+    breakdown.push(output);
+  }
+  const overall = Math.round(weightedSum / totalWeight);
+  const rating = getRating(overall);
+  const formulaParts = Array.from(toolOutputs.entries()).map(([name, output]) => {
+    const w = weights.get(name) || 10;
+    return `(${output.score} \xD7 ${w})`;
+  });
+  const formulaStr = `[${formulaParts.join(" + ")}] / ${totalWeight} = ${overall}`;
+  return {
+    overall,
+    rating,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    toolsUsed,
+    breakdown,
+    calculation: {
+      formula: formulaStr,
+      weights: calculationWeights,
+      normalized: formulaStr
+    }
+  };
+}
+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";
+}
+function getRatingDisplay(rating) {
+  switch (rating) {
+    case "Excellent":
+      return { emoji: "\u2705", color: "green" };
+    case "Good":
+      return { emoji: "\u{1F44D}", color: "blue" };
+    case "Fair":
+      return { emoji: "\u26A0\uFE0F", color: "yellow" };
+    case "Needs Work":
+      return { emoji: "\u{1F528}", color: "orange" };
+    case "Critical":
+      return { emoji: "\u274C", color: "red" };
+  }
+}
+function formatScore(result) {
+  const { emoji, color } = getRatingDisplay(result.rating);
+  return `${result.overall}/100 (${result.rating}) ${emoji}`;
+}
+function formatToolScore(output) {
+  let result = `  Score: ${output.score}/100
+
+`;
+  if (output.factors && output.factors.length > 0) {
+    result += `  Factors:
+`;
+    output.factors.forEach((factor) => {
+      const impactSign = factor.impact > 0 ? "+" : "";
+      result += `    \u2022 ${factor.name}: ${impactSign}${factor.impact} - ${factor.description}
+`;
+    });
+    result += "\n";
+  }
+  if (output.recommendations && output.recommendations.length > 0) {
+    result += `  Recommendations:
+`;
+    output.recommendations.forEach((rec, i) => {
+      const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+      result += `    ${i + 1}. ${priorityIcon} ${rec.action}
+`;
+      result += `       Impact: +${rec.estimatedImpact} points
+
+`;
+    });
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_EXCLUDE,
+  DEFAULT_TOOL_WEIGHTS,
+  TOOL_NAME_MAP,
   calculateImportSimilarity,
+  calculateOverallScore,
   estimateTokens,
   extractFunctions,
   extractImports,
+  formatScore,
+  formatToolScore,
   getElapsedTime,
   getFileExtension,
+  getRating,
+  getRatingDisplay,
+  getToolWeight,
   handleCLIError,
   handleJSONOutput,
   isSourceFile,
   loadConfig,
   loadMergedConfig,
   mergeConfigWithDefaults,
+  normalizeToolName,
   parseCode,
   parseFileExports,
+  parseWeightString,
   readFileContent,
   resolveOutputPath,
   scanFiles

package/dist/index.mjs

@@ -50,6 +50,7 @@ async function scanFiles(options) {
   const {
     rootDir,
     include = ["**/*.{ts,tsx,js,jsx,py,java}"],
+    // Broad default - tools should filter further
     exclude
   } = options;
   const finalExclude = exclude ? [.../* @__PURE__ */ new Set([...DEFAULT_EXCLUDE, ...exclude])] : DEFAULT_EXCLUDE;
@@ -365,22 +366,176 @@ function handleCLIError(error, commandName) {
 function getElapsedTime(startTime) {
   return ((Date.now() - startTime) / 1e3).toFixed(2);
 }
+
+// src/scoring.ts
+var DEFAULT_TOOL_WEIGHTS = {
+  "pattern-detect": 40,
+  "context-analyzer": 35,
+  "consistency": 25,
+  "doc-drift": 20,
+  "deps": 15
+};
+var TOOL_NAME_MAP = {
+  "patterns": "pattern-detect",
+  "context": "context-analyzer",
+  "consistency": "consistency",
+  "doc-drift": "doc-drift",
+  "deps": "deps"
+};
+function normalizeToolName(shortName) {
+  return TOOL_NAME_MAP[shortName] || shortName;
+}
+function getToolWeight(toolName, toolConfig, cliOverride) {
+  if (cliOverride !== void 0) {
+    return cliOverride;
+  }
+  if (toolConfig?.scoreWeight !== void 0) {
+    return toolConfig.scoreWeight;
+  }
+  return DEFAULT_TOOL_WEIGHTS[toolName] || 10;
+}
+function parseWeightString(weightStr) {
+  const weights = /* @__PURE__ */ new Map();
+  if (!weightStr) {
+    return weights;
+  }
+  const pairs = weightStr.split(",");
+  for (const pair of pairs) {
+    const [toolShortName, weightStr2] = pair.split(":");
+    if (toolShortName && weightStr2) {
+      const toolName = normalizeToolName(toolShortName.trim());
+      const weight = parseInt(weightStr2.trim(), 10);
+      if (!isNaN(weight) && weight > 0) {
+        weights.set(toolName, weight);
+      }
+    }
+  }
+  return weights;
+}
+function calculateOverallScore(toolOutputs, config, cliWeights) {
+  if (toolOutputs.size === 0) {
+    throw new Error("No tool outputs provided for scoring");
+  }
+  const weights = /* @__PURE__ */ new Map();
+  for (const [toolName] of toolOutputs.entries()) {
+    const cliWeight = cliWeights?.get(toolName);
+    const configWeight = config?.tools?.[toolName]?.scoreWeight;
+    const weight = cliWeight ?? configWeight ?? DEFAULT_TOOL_WEIGHTS[toolName] ?? 10;
+    weights.set(toolName, weight);
+  }
+  let weightedSum = 0;
+  let totalWeight = 0;
+  const breakdown = [];
+  const toolsUsed = [];
+  const calculationWeights = {};
+  for (const [toolName, output] of toolOutputs.entries()) {
+    const weight = weights.get(toolName) || 10;
+    const weightedScore = output.score * weight;
+    weightedSum += weightedScore;
+    totalWeight += weight;
+    toolsUsed.push(toolName);
+    calculationWeights[toolName] = weight;
+    breakdown.push(output);
+  }
+  const overall = Math.round(weightedSum / totalWeight);
+  const rating = getRating(overall);
+  const formulaParts = Array.from(toolOutputs.entries()).map(([name, output]) => {
+    const w = weights.get(name) || 10;
+    return `(${output.score} \xD7 ${w})`;
+  });
+  const formulaStr = `[${formulaParts.join(" + ")}] / ${totalWeight} = ${overall}`;
+  return {
+    overall,
+    rating,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    toolsUsed,
+    breakdown,
+    calculation: {
+      formula: formulaStr,
+      weights: calculationWeights,
+      normalized: formulaStr
+    }
+  };
+}
+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";
+}
+function getRatingDisplay(rating) {
+  switch (rating) {
+    case "Excellent":
+      return { emoji: "\u2705", color: "green" };
+    case "Good":
+      return { emoji: "\u{1F44D}", color: "blue" };
+    case "Fair":
+      return { emoji: "\u26A0\uFE0F", color: "yellow" };
+    case "Needs Work":
+      return { emoji: "\u{1F528}", color: "orange" };
+    case "Critical":
+      return { emoji: "\u274C", color: "red" };
+  }
+}
+function formatScore(result) {
+  const { emoji, color } = getRatingDisplay(result.rating);
+  return `${result.overall}/100 (${result.rating}) ${emoji}`;
+}
+function formatToolScore(output) {
+  let result = `  Score: ${output.score}/100
+
+`;
+  if (output.factors && output.factors.length > 0) {
+    result += `  Factors:
+`;
+    output.factors.forEach((factor) => {
+      const impactSign = factor.impact > 0 ? "+" : "";
+      result += `    \u2022 ${factor.name}: ${impactSign}${factor.impact} - ${factor.description}
+`;
+    });
+    result += "\n";
+  }
+  if (output.recommendations && output.recommendations.length > 0) {
+    result += `  Recommendations:
+`;
+    output.recommendations.forEach((rec, i) => {
+      const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+      result += `    ${i + 1}. ${priorityIcon} ${rec.action}
+`;
+      result += `       Impact: +${rec.estimatedImpact} points
+
+`;
+    });
+  }
+  return result;
+}
 export {
   DEFAULT_EXCLUDE,
+  DEFAULT_TOOL_WEIGHTS,
+  TOOL_NAME_MAP,
   calculateImportSimilarity,
+  calculateOverallScore,
   estimateTokens,
   extractFunctions,
   extractImports,
+  formatScore,
+  formatToolScore,
   getElapsedTime,
   getFileExtension,
+  getRating,
+  getRatingDisplay,
+  getToolWeight,
   handleCLIError,
   handleJSONOutput,
   isSourceFile,
   loadConfig,
   loadMergedConfig,
   mergeConfigWithDefaults,
+  normalizeToolName,
   parseCode,
   parseFileExports,
+  parseWeightString,
   readFileContent,
   resolveOutputPath,
   scanFiles

package/package.json

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