@aiready/core 0.7.9 → 0.7.11

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';
@@ -196,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';
@@ -196,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
@@ -44,6 +54,8 @@ module.exports = __toCommonJS(index_exports);
 // src/utils/file-scanner.ts
 var import_glob = require("glob");
 var import_promises = require("fs/promises");
+var import_fs = require("fs");
+var import_path = require("path");
 var DEFAULT_EXCLUDE = [
   // Dependencies
   "**/node_modules/**",
@@ -96,7 +108,17 @@ async function scanFiles(options) {
     // Broad default - tools should filter further
     exclude
   } = options;
-  const finalExclude = exclude ? [.../* @__PURE__ */ new Set([...DEFAULT_EXCLUDE, ...exclude])] : DEFAULT_EXCLUDE;
+  const ignoreFilePath = (0, import_path.join)(rootDir || ".", ".aireadyignore");
+  let ignoreFromFile = [];
+  if ((0, import_fs.existsSync)(ignoreFilePath)) {
+    try {
+      const txt = await (0, import_promises.readFile)(ignoreFilePath, "utf-8");
+      ignoreFromFile = txt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#")).filter((l) => !l.startsWith("!"));
+    } catch (e) {
+      ignoreFromFile = [];
+    }
+  }
+  const finalExclude = [.../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...DEFAULT_EXCLUDE])];
   const files = await (0, import_glob.glob)(include, {
     cwd: rootDir,
     ignore: finalExclude,
@@ -295,8 +317,8 @@ function estimateTokens(text) {
 }
 
 // src/utils/config.ts
-var import_fs = require("fs");
-var import_path = require("path");
+var import_fs2 = require("fs");
+var import_path2 = require("path");
 var import_url = require("url");
 var CONFIG_FILES = [
   "aiready.json",
@@ -307,11 +329,11 @@ var CONFIG_FILES = [
   ".aireadyrc.js"
 ];
 async function loadConfig(rootDir) {
-  let currentDir = (0, import_path.resolve)(rootDir);
+  let currentDir = (0, import_path2.resolve)(rootDir);
   while (true) {
     for (const configFile of CONFIG_FILES) {
-      const configPath = (0, import_path.join)(currentDir, configFile);
-      if ((0, import_fs.existsSync)(configPath)) {
+      const configPath = (0, import_path2.join)(currentDir, configFile);
+      if ((0, import_fs2.existsSync)(configPath)) {
         try {
           let config;
           if (configFile.endsWith(".js")) {
@@ -319,7 +341,7 @@ async function loadConfig(rootDir) {
             const module2 = await import(`${fileUrl}?t=${Date.now()}`);
             config = module2.default || module2;
           } else {
-            const content = (0, import_fs.readFileSync)(configPath, "utf-8");
+            const content = (0, import_fs2.readFileSync)(configPath, "utf-8");
             config = JSON.parse(content);
           }
           if (typeof config !== "object" || config === null) {
@@ -332,7 +354,7 @@ async function loadConfig(rootDir) {
         }
       }
     }
-    const parent = (0, import_path.dirname)(currentDir);
+    const parent = (0, import_path2.dirname)(currentDir);
     if (parent === currentDir) {
       break;
     }
@@ -364,19 +386,19 @@ function mergeConfigWithDefaults(userConfig, defaults) {
 }
 
 // src/utils/cli-helpers.ts
-var import_fs2 = require("fs");
-var import_path2 = require("path");
+var import_fs3 = require("fs");
+var import_path3 = require("path");
 function resolveOutputPath(userPath, defaultFilename, workingDir = process.cwd()) {
   let outputPath;
   if (userPath) {
     outputPath = userPath;
   } else {
-    const aireadyDir = (0, import_path2.join)(workingDir, ".aiready");
-    outputPath = (0, import_path2.join)(aireadyDir, defaultFilename);
+    const aireadyDir = (0, import_path3.join)(workingDir, ".aiready");
+    outputPath = (0, import_path3.join)(aireadyDir, defaultFilename);
   }
-  const parentDir = (0, import_path2.dirname)(outputPath);
-  if (!(0, import_fs2.existsSync)(parentDir)) {
-    (0, import_fs2.mkdirSync)(parentDir, { recursive: true });
+  const parentDir = (0, import_path3.dirname)(outputPath);
+  if (!(0, import_fs3.existsSync)(parentDir)) {
+    (0, import_fs3.mkdirSync)(parentDir, { recursive: true });
   }
   return outputPath;
 }
@@ -392,11 +414,11 @@ async function loadMergedConfig(directory, defaults, cliOptions) {
 }
 function handleJSONOutput(data, outputFile, successMessage) {
   if (outputFile) {
-    const dir = (0, import_path2.dirname)(outputFile);
-    if (!(0, import_fs2.existsSync)(dir)) {
-      (0, import_fs2.mkdirSync)(dir, { recursive: true });
+    const dir = (0, import_path3.dirname)(outputFile);
+    if (!(0, import_fs3.existsSync)(dir)) {
+      (0, import_fs3.mkdirSync)(dir, { recursive: true });
     }
-    (0, import_fs2.writeFileSync)(outputFile, JSON.stringify(data, null, 2));
+    (0, import_fs3.writeFileSync)(outputFile, JSON.stringify(data, null, 2));
     console.log(successMessage || `\u2705 Results saved to ${outputFile}`);
   } else {
     console.log(JSON.stringify(data, null, 2));
@@ -409,23 +431,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

@@ -1,6 +1,8 @@
 // src/utils/file-scanner.ts
 import { glob } from "glob";
 import { readFile } from "fs/promises";
+import { existsSync } from "fs";
+import { join } from "path";
 var DEFAULT_EXCLUDE = [
   // Dependencies
   "**/node_modules/**",
@@ -53,7 +55,17 @@ async function scanFiles(options) {
     // Broad default - tools should filter further
     exclude
   } = options;
-  const finalExclude = exclude ? [.../* @__PURE__ */ new Set([...DEFAULT_EXCLUDE, ...exclude])] : DEFAULT_EXCLUDE;
+  const ignoreFilePath = join(rootDir || ".", ".aireadyignore");
+  let ignoreFromFile = [];
+  if (existsSync(ignoreFilePath)) {
+    try {
+      const txt = await readFile(ignoreFilePath, "utf-8");
+      ignoreFromFile = txt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#")).filter((l) => !l.startsWith("!"));
+    } catch (e) {
+      ignoreFromFile = [];
+    }
+  }
+  const finalExclude = [.../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...DEFAULT_EXCLUDE])];
   const files = await glob(include, {
     cwd: rootDir,
     ignore: finalExclude,
@@ -252,8 +264,8 @@ function estimateTokens(text) {
 }
 
 // src/utils/config.ts
-import { readFileSync, existsSync } from "fs";
-import { join, resolve, dirname } from "path";
+import { readFileSync, existsSync as existsSync2 } from "fs";
+import { join as join2, resolve, dirname } from "path";
 import { pathToFileURL } from "url";
 var CONFIG_FILES = [
   "aiready.json",
@@ -267,8 +279,8 @@ async function loadConfig(rootDir) {
   let currentDir = resolve(rootDir);
   while (true) {
     for (const configFile of CONFIG_FILES) {
-      const configPath = join(currentDir, configFile);
-      if (existsSync(configPath)) {
+      const configPath = join2(currentDir, configFile);
+      if (existsSync2(configPath)) {
         try {
           let config;
           if (configFile.endsWith(".js")) {
@@ -321,18 +333,18 @@ function mergeConfigWithDefaults(userConfig, defaults) {
 }
 
 // src/utils/cli-helpers.ts
-import { writeFileSync, mkdirSync, existsSync as existsSync2 } from "fs";
-import { join as join2, dirname as dirname2 } from "path";
+import { writeFileSync, mkdirSync, existsSync as existsSync3 } from "fs";
+import { join as join3, dirname as dirname2 } from "path";
 function resolveOutputPath(userPath, defaultFilename, workingDir = process.cwd()) {
   let outputPath;
   if (userPath) {
     outputPath = userPath;
   } else {
-    const aireadyDir = join2(workingDir, ".aiready");
-    outputPath = join2(aireadyDir, defaultFilename);
+    const aireadyDir = join3(workingDir, ".aiready");
+    outputPath = join3(aireadyDir, defaultFilename);
   }
   const parentDir = dirname2(outputPath);
-  if (!existsSync2(parentDir)) {
+  if (!existsSync3(parentDir)) {
     mkdirSync(parentDir, { recursive: true });
   }
   return outputPath;
@@ -350,7 +362,7 @@ async function loadMergedConfig(directory, defaults, cliOptions) {
 function handleJSONOutput(data, outputFile, successMessage) {
   if (outputFile) {
     const dir = dirname2(outputFile);
-    if (!existsSync2(dir)) {
+    if (!existsSync3(dir)) {
       mkdirSync(dir, { recursive: true });
     }
     writeFileSync(outputFile, JSON.stringify(data, null, 2));
@@ -366,22 +378,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.9",
+  "version": "0.7.11",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",