@aiready/core 0.21.4 → 0.21.8

package/dist/index.d.mts

@@ -100,6 +100,61 @@ declare function readFileContent(filePath: string): Promise<string>;
 declare function getFileExtension(filePath: string): string;
 declare function isSourceFile(filePath: string): boolean;
 
+/**
+ * Common CLI configuration interface
+ */
+interface CLIOptions {
+    rootDir: string;
+    include?: string[];
+    exclude?: string[];
+    [key: string]: any;
+}
+/**
+ * Resolve output file path, defaulting to .aiready directory
+ * Creates parent directories if they don't exist.
+ * @param userPath - User-provided output path (optional)
+ * @param defaultFilename - Default filename to use
+ * @param workingDir - Working directory (default: process.cwd())
+ * @returns Resolved absolute path
+ */
+declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
+/**
+ * Load and merge configuration with CLI options
+ */
+declare function loadMergedConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<T & {
+    rootDir: string;
+}>;
+/**
+ * Handle JSON output for CLI commands
+ */
+declare function handleJSONOutput(data: any, outputFile?: string, successMessage?: string): void;
+/**
+ * Common error handler for CLI commands
+ */
+declare function handleCLIError(error: unknown, commandName: string): never;
+/**
+ * Calculate elapsed time and format for display
+ */
+declare function getElapsedTime(startTime: number): string;
+/**
+ * Generate a visual score bar for console output
+ */
+declare function getScoreBar(val: number): string;
+/**
+ * Get status icon for safety ratings
+ */
+declare function getSafetyIcon(rating: string): string;
+/**
+ * Emit progress update with throttling to reduce log noise
+ */
+declare function emitProgress(processed: number, total: number, toolId: string, message: string, onProgress?: (processed: number, total: number, message: string) => void, throttleCount?: number): void;
+/**
+ * Get chalk color function for a given severity
+ * @param severity severity level
+ * @param chalk chalk instance
+ */
+declare function getSeverityColor(severity: string, chalk: any): any;
+
 interface ExportWithImports {
     name: string;
     type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default';
@@ -159,57 +214,6 @@ declare function estimateTokens(text: string): number;
 declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
 declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
 
-/**
- * Common CLI configuration interface
- */
-interface CLIOptions {
-    rootDir: string;
-    include?: string[];
-    exclude?: string[];
-    [key: string]: any;
-}
-/**
- * Resolve output file path, defaulting to .aiready directory
- * Creates parent directories if they don't exist.
- * @param userPath - User-provided output path (optional)
- * @param defaultFilename - Default filename to use
- * @param workingDir - Working directory (default: process.cwd())
- * @returns Resolved absolute path
- */
-declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
-/**
- * Load and merge configuration with CLI options
- */
-declare function loadMergedConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<T & {
-    rootDir: string;
-}>;
-/**
- * Handle JSON output for CLI commands
- */
-declare function handleJSONOutput(data: any, outputFile?: string, successMessage?: string): void;
-/**
- * Common error handler for CLI commands
- */
-declare function handleCLIError(error: unknown, commandName: string): never;
-/**
- * Calculate elapsed time and format for display
- */
-declare function getElapsedTime(startTime: number): string;
-/**
- * Generate a visual score bar for console output
- */
-declare function getScoreBar(val: number): string;
-/**
- * Get status icon for safety ratings
- */
-declare function getSafetyIcon(rating: string): string;
-/**
- * Get chalk color function for a given severity
- * @param severity severity level
- * @param chalk chalk instance
- */
-declare function getSeverityColor(severity: string, chalk: any): any;
-
 /**
  * AI model pricing presets for cost estimation.
  * Prices are input token costs per 1K tokens (USD), as of Q1 2026.
@@ -851,4 +855,4 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };

package/dist/index.d.ts

@@ -100,6 +100,61 @@ declare function readFileContent(filePath: string): Promise<string>;
 declare function getFileExtension(filePath: string): string;
 declare function isSourceFile(filePath: string): boolean;
 
+/**
+ * Common CLI configuration interface
+ */
+interface CLIOptions {
+    rootDir: string;
+    include?: string[];
+    exclude?: string[];
+    [key: string]: any;
+}
+/**
+ * Resolve output file path, defaulting to .aiready directory
+ * Creates parent directories if they don't exist.
+ * @param userPath - User-provided output path (optional)
+ * @param defaultFilename - Default filename to use
+ * @param workingDir - Working directory (default: process.cwd())
+ * @returns Resolved absolute path
+ */
+declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
+/**
+ * Load and merge configuration with CLI options
+ */
+declare function loadMergedConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<T & {
+    rootDir: string;
+}>;
+/**
+ * Handle JSON output for CLI commands
+ */
+declare function handleJSONOutput(data: any, outputFile?: string, successMessage?: string): void;
+/**
+ * Common error handler for CLI commands
+ */
+declare function handleCLIError(error: unknown, commandName: string): never;
+/**
+ * Calculate elapsed time and format for display
+ */
+declare function getElapsedTime(startTime: number): string;
+/**
+ * Generate a visual score bar for console output
+ */
+declare function getScoreBar(val: number): string;
+/**
+ * Get status icon for safety ratings
+ */
+declare function getSafetyIcon(rating: string): string;
+/**
+ * Emit progress update with throttling to reduce log noise
+ */
+declare function emitProgress(processed: number, total: number, toolId: string, message: string, onProgress?: (processed: number, total: number, message: string) => void, throttleCount?: number): void;
+/**
+ * Get chalk color function for a given severity
+ * @param severity severity level
+ * @param chalk chalk instance
+ */
+declare function getSeverityColor(severity: string, chalk: any): any;
+
 interface ExportWithImports {
     name: string;
     type: 'function' | 'class' | 'const' | 'type' | 'interface' | 'default';
@@ -159,57 +214,6 @@ declare function estimateTokens(text: string): number;
 declare function loadConfig(rootDir: string): Promise<AIReadyConfig | null>;
 declare function mergeConfigWithDefaults(userConfig: AIReadyConfig | null, defaults: any): any;
 
-/**
- * Common CLI configuration interface
- */
-interface CLIOptions {
-    rootDir: string;
-    include?: string[];
-    exclude?: string[];
-    [key: string]: any;
-}
-/**
- * Resolve output file path, defaulting to .aiready directory
- * Creates parent directories if they don't exist.
- * @param userPath - User-provided output path (optional)
- * @param defaultFilename - Default filename to use
- * @param workingDir - Working directory (default: process.cwd())
- * @returns Resolved absolute path
- */
-declare function resolveOutputPath(userPath: string | undefined, defaultFilename: string, workingDir?: string): string;
-/**
- * Load and merge configuration with CLI options
- */
-declare function loadMergedConfig<T extends Record<string, any>>(directory: string, defaults: T, cliOptions: Partial<T>): Promise<T & {
-    rootDir: string;
-}>;
-/**
- * Handle JSON output for CLI commands
- */
-declare function handleJSONOutput(data: any, outputFile?: string, successMessage?: string): void;
-/**
- * Common error handler for CLI commands
- */
-declare function handleCLIError(error: unknown, commandName: string): never;
-/**
- * Calculate elapsed time and format for display
- */
-declare function getElapsedTime(startTime: number): string;
-/**
- * Generate a visual score bar for console output
- */
-declare function getScoreBar(val: number): string;
-/**
- * Get status icon for safety ratings
- */
-declare function getSafetyIcon(rating: string): string;
-/**
- * Get chalk color function for a given severity
- * @param severity severity level
- * @param chalk chalk instance
- */
-declare function getSeverityColor(severity: string, chalk: any): any;
-
 /**
  * AI model pricing presets for cost estimation.
  * Prices are input token costs per 1K tokens (USD), as of Q1 2026.
@@ -851,4 +855,4 @@ declare function getRepoMetadata(directory: string): {
     author?: string;
 };
 
-export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type AgentGroundingScore, type AiSignalClarity, type AiSignalClaritySignal, type CLIOptions, type ChangeAmplificationScore, type CognitiveLoad, ComprehensionDifficulty, type ConceptCohesion, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type DependencyHealthScore, type DocDriftRisk, type ExportWithImports, type FileImport, type FileWithDomain, type KnowledgeConcentrationRisk, Language, LanguageParser, type LoadFactor, MODEL_PRICING_PRESETS, ModelContextTier, type ModelPricingPreset, NamingConvention, ParseResult, ParserFactory, type PatternEntropy, ProductivityImpact, PythonParser, SEVERITY_TIME_ESTIMATES, ScanOptions, type ScoreHistoryEntry, type ScoreTrend, type SemanticDistance, SpokeOutput, type TechnicalDebtInterest, TechnicalValueChain, TechnicalValueChainSummary, type TestabilityIndex, TokenBudget, ToolName, type ToolProvider, ToolRegistry, ToolScoringOutput, TypeScriptParser, VAGUE_FILE_NAMES, calculateAgentGrounding, calculateAiSignalClarity, calculateBusinessROI, calculateChangeAmplification, calculateCognitiveLoad, calculateComprehensionDifficulty, calculateConceptCohesion, calculateDebtInterest, calculateDependencyHealth, calculateDocDrift, calculateExtendedFutureProofScore, calculateFutureProofScore, calculateImportSimilarity, calculateKnowledgeConcentration, calculateMonthlyCost, calculatePatternEntropy, calculateProductivityImpact, calculateSemanticDistance, calculateTechnicalValueChain, calculateTestabilityIndex, calculateTokenBudget, clearHistory, emitProgress, estimateCostFromBudget, estimateTokens, exportHistory, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, generateValueChain, getElapsedTime, getFileCommitTimestamps, getFileExtension, getHistorySummary, getLineRangeLastModifiedCached, getModelPreset, getParser, getRepoMetadata, getSafetyIcon, getScoreBar, getSeverityColor, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, loadScoreHistory, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, saveScoreEntry, scanEntries, scanFiles, validateSpokeOutput, validateWithSchema };

package/dist/index.js

@@ -87,6 +87,7 @@ __export(index_exports, {
   calculateTestabilityIndex: () => calculateTestabilityIndex,
   calculateTokenBudget: () => calculateTokenBudget,
   clearHistory: () => clearHistory,
+  emitProgress: () => emitProgress,
   estimateCostFromBudget: () => estimateCostFromBudget,
   estimateTokens: () => estimateTokens,
   exportHistory: () => exportHistory,
@@ -663,6 +664,94 @@ function isSourceFile(filePath) {
   return ["ts", "tsx", "js", "jsx", "py", "java", "go", "rs"].includes(ext);
 }
 
+// src/utils/cli-helpers.ts
+var import_fs2 = require("fs");
+var import_path2 = 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 parentDir = (0, import_path2.dirname)(outputPath);
+  if (!(0, import_fs2.existsSync)(parentDir)) {
+    (0, import_fs2.mkdirSync)(parentDir, { recursive: true });
+  }
+  return outputPath;
+}
+async function loadMergedConfig(directory, defaults, cliOptions) {
+  const config = await loadConfig(directory);
+  const mergedConfig = mergeConfigWithDefaults(config, defaults);
+  const result = {
+    ...mergedConfig,
+    ...cliOptions,
+    rootDir: directory
+  };
+  return result;
+}
+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 });
+    }
+    (0, import_fs2.writeFileSync)(outputFile, JSON.stringify(data, null, 2));
+    console.log(successMessage || `\u2705 Results saved to ${outputFile}`);
+  } else {
+    console.log(JSON.stringify(data, null, 2));
+  }
+}
+function handleCLIError(error, commandName) {
+  console.error(`\u274C ${commandName} failed:`, error);
+  process.exit(1);
+}
+function getElapsedTime(startTime) {
+  return ((Date.now() - startTime) / 1e3).toFixed(2);
+}
+function getScoreBar(val) {
+  return "\u2588".repeat(Math.round(val / 10)).padEnd(10, "\u2591");
+}
+function getSafetyIcon(rating) {
+  switch (rating) {
+    case "safe":
+      return "\u2705";
+    case "moderate-risk":
+      return "\u26A0\uFE0F ";
+    case "high-risk":
+      return "\u{1F534}";
+    case "blind-risk":
+      return "\u{1F480}";
+    default:
+      return "\u2753";
+  }
+}
+function emitProgress(processed, total, toolId, message, onProgress, throttleCount = 50) {
+  if (!onProgress) return;
+  if (processed % throttleCount === 0 || processed === total) {
+    onProgress(processed, total, `${message} (${processed}/${total})`);
+  }
+}
+function getSeverityColor(severity, chalk) {
+  switch (severity.toLowerCase()) {
+    case "critical":
+    case "high-risk":
+    case "blind-risk":
+      return chalk.red;
+    case "major":
+    case "moderate-risk":
+      return chalk.yellow;
+    case "minor":
+    case "safe":
+      return chalk.green;
+    case "info":
+      return chalk.blue;
+    default:
+      return chalk.white;
+  }
+}
+
 // src/utils/ast-parser.ts
 var import_typescript_estree = require("@typescript-eslint/typescript-estree");
 function parseFileExports(code, filePath) {
@@ -843,8 +932,8 @@ function estimateTokens(text) {
 }
 
 // src/utils/config.ts
-var import_fs2 = require("fs");
-var import_path2 = require("path");
+var import_fs3 = require("fs");
+var import_path3 = require("path");
 var import_url = require("url");
 var CONFIG_FILES = [
   "aiready.json",
@@ -855,11 +944,11 @@ var CONFIG_FILES = [
   ".aireadyrc.js"
 ];
 async function loadConfig(rootDir) {
-  let currentDir = (0, import_path2.resolve)(rootDir);
+  let currentDir = (0, import_path3.resolve)(rootDir);
   while (true) {
     for (const configFile of CONFIG_FILES) {
-      const configPath = (0, import_path2.join)(currentDir, configFile);
-      if ((0, import_fs2.existsSync)(configPath)) {
+      const configPath = (0, import_path3.join)(currentDir, configFile);
+      if ((0, import_fs3.existsSync)(configPath)) {
         try {
           let config;
           if (configFile.endsWith(".js")) {
@@ -867,7 +956,7 @@ async function loadConfig(rootDir) {
             const module2 = await import(`${fileUrl}?t=${Date.now()}`);
             config = module2.default || module2;
           } else {
-            const content = (0, import_fs2.readFileSync)(configPath, "utf-8");
+            const content = (0, import_fs3.readFileSync)(configPath, "utf-8");
             config = JSON.parse(content);
           }
           if (typeof config !== "object" || config === null) {
@@ -887,7 +976,7 @@ async function loadConfig(rootDir) {
         }
       }
     }
-    const parent = (0, import_path2.dirname)(currentDir);
+    const parent = (0, import_path3.dirname)(currentDir);
     if (parent === currentDir) {
       break;
     }
@@ -918,88 +1007,6 @@ function mergeConfigWithDefaults(userConfig, defaults) {
   return result;
 }
 
-// src/utils/cli-helpers.ts
-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_path3.join)(workingDir, ".aiready");
-    outputPath = (0, import_path3.join)(aireadyDir, defaultFilename);
-  }
-  const parentDir = (0, import_path3.dirname)(outputPath);
-  if (!(0, import_fs3.existsSync)(parentDir)) {
-    (0, import_fs3.mkdirSync)(parentDir, { recursive: true });
-  }
-  return outputPath;
-}
-async function loadMergedConfig(directory, defaults, cliOptions) {
-  const config = await loadConfig(directory);
-  const mergedConfig = mergeConfigWithDefaults(config, defaults);
-  const result = {
-    ...mergedConfig,
-    ...cliOptions,
-    rootDir: directory
-  };
-  return result;
-}
-function handleJSONOutput(data, outputFile, successMessage) {
-  if (outputFile) {
-    const dir = (0, import_path3.dirname)(outputFile);
-    if (!(0, import_fs3.existsSync)(dir)) {
-      (0, import_fs3.mkdirSync)(dir, { recursive: true });
-    }
-    (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));
-  }
-}
-function handleCLIError(error, commandName) {
-  console.error(`\u274C ${commandName} failed:`, error);
-  process.exit(1);
-}
-function getElapsedTime(startTime) {
-  return ((Date.now() - startTime) / 1e3).toFixed(2);
-}
-function getScoreBar(val) {
-  return "\u2588".repeat(Math.round(val / 10)).padEnd(10, "\u2591");
-}
-function getSafetyIcon(rating) {
-  switch (rating) {
-    case "safe":
-      return "\u2705";
-    case "moderate-risk":
-      return "\u26A0\uFE0F ";
-    case "high-risk":
-      return "\u{1F534}";
-    case "blind-risk":
-      return "\u{1F480}";
-    default:
-      return "\u2753";
-  }
-}
-function getSeverityColor(severity, chalk) {
-  switch (severity.toLowerCase()) {
-    case "critical":
-    case "high-risk":
-    case "blind-risk":
-      return chalk.red;
-    case "major":
-    case "moderate-risk":
-      return chalk.yellow;
-    case "minor":
-    case "safe":
-      return chalk.green;
-    case "info":
-      return chalk.blue;
-    default:
-      return chalk.white;
-  }
-}
-
 // src/utils/visualization.ts
 function generateHTML(graph) {
   const payload = JSON.stringify(graph, null, 2);
@@ -2941,8 +2948,8 @@ function calculateChangeAmplification(params) {
   const maxAmplification = hotspots[0].amplificationFactor;
   const avgAmplification = hotspots.reduce((sum, h) => sum + h.amplificationFactor, 0) / hotspots.length;
   const avgPenalty = Math.log2(avgAmplification + 1) * 15;
-  const maxPenalty = maxAmplification > 30 ? (maxAmplification - 30) * 1.5 : 0;
-  const score = Math.max(0, Math.min(100, 100 - avgPenalty - maxPenalty));
+  const maxPenalty = maxAmplification > 30 ? Math.log10(maxAmplification - 29) * 30 : 0;
+  const score = Math.max(5, Math.min(100, 100 - avgPenalty - maxPenalty));
   let rating = "isolated";
   if (score < 40) rating = "explosive";
   else if (score < 70) rating = "amplified";
@@ -3313,6 +3320,7 @@ function getRepoMetadata(directory) {
   calculateTestabilityIndex,
   calculateTokenBudget,
   clearHistory,
+  emitProgress,
   estimateCostFromBudget,
   estimateTokens,
   exportHistory,

package/dist/index.mjs

@@ -375,6 +375,94 @@ function isSourceFile(filePath) {
   return ["ts", "tsx", "js", "jsx", "py", "java", "go", "rs"].includes(ext);
 }
 
+// src/utils/cli-helpers.ts
+import { writeFileSync, mkdirSync, existsSync as existsSync2 } from "fs";
+import { join as join2, 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 parentDir = dirname2(outputPath);
+  if (!existsSync2(parentDir)) {
+    mkdirSync(parentDir, { recursive: true });
+  }
+  return outputPath;
+}
+async function loadMergedConfig(directory, defaults, cliOptions) {
+  const config = await loadConfig(directory);
+  const mergedConfig = mergeConfigWithDefaults(config, defaults);
+  const result = {
+    ...mergedConfig,
+    ...cliOptions,
+    rootDir: directory
+  };
+  return result;
+}
+function handleJSONOutput(data, outputFile, successMessage) {
+  if (outputFile) {
+    const dir = dirname2(outputFile);
+    if (!existsSync2(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(outputFile, JSON.stringify(data, null, 2));
+    console.log(successMessage || `\u2705 Results saved to ${outputFile}`);
+  } else {
+    console.log(JSON.stringify(data, null, 2));
+  }
+}
+function handleCLIError(error, commandName) {
+  console.error(`\u274C ${commandName} failed:`, error);
+  process.exit(1);
+}
+function getElapsedTime(startTime) {
+  return ((Date.now() - startTime) / 1e3).toFixed(2);
+}
+function getScoreBar(val) {
+  return "\u2588".repeat(Math.round(val / 10)).padEnd(10, "\u2591");
+}
+function getSafetyIcon(rating) {
+  switch (rating) {
+    case "safe":
+      return "\u2705";
+    case "moderate-risk":
+      return "\u26A0\uFE0F ";
+    case "high-risk":
+      return "\u{1F534}";
+    case "blind-risk":
+      return "\u{1F480}";
+    default:
+      return "\u2753";
+  }
+}
+function emitProgress(processed, total, toolId, message, onProgress, throttleCount = 50) {
+  if (!onProgress) return;
+  if (processed % throttleCount === 0 || processed === total) {
+    onProgress(processed, total, `${message} (${processed}/${total})`);
+  }
+}
+function getSeverityColor(severity, chalk) {
+  switch (severity.toLowerCase()) {
+    case "critical":
+    case "high-risk":
+    case "blind-risk":
+      return chalk.red;
+    case "major":
+    case "moderate-risk":
+      return chalk.yellow;
+    case "minor":
+    case "safe":
+      return chalk.green;
+    case "info":
+      return chalk.blue;
+    default:
+      return chalk.white;
+  }
+}
+
 // src/utils/ast-parser.ts
 import { parse } from "@typescript-eslint/typescript-estree";
 function parseFileExports(code, filePath) {
@@ -555,8 +643,8 @@ function estimateTokens(text) {
 }
 
 // src/utils/config.ts
-import { readFileSync, existsSync as existsSync2 } from "fs";
-import { join as join2, resolve, dirname as dirname2 } from "path";
+import { readFileSync, existsSync as existsSync3 } from "fs";
+import { join as join3, resolve, dirname as dirname3 } from "path";
 import { pathToFileURL } from "url";
 var CONFIG_FILES = [
   "aiready.json",
@@ -570,8 +658,8 @@ async function loadConfig(rootDir) {
   let currentDir = resolve(rootDir);
   while (true) {
     for (const configFile of CONFIG_FILES) {
-      const configPath = join2(currentDir, configFile);
-      if (existsSync2(configPath)) {
+      const configPath = join3(currentDir, configFile);
+      if (existsSync3(configPath)) {
         try {
           let config;
           if (configFile.endsWith(".js")) {
@@ -599,7 +687,7 @@ async function loadConfig(rootDir) {
         }
       }
     }
-    const parent = dirname2(currentDir);
+    const parent = dirname3(currentDir);
     if (parent === currentDir) {
       break;
     }
@@ -630,88 +718,6 @@ function mergeConfigWithDefaults(userConfig, defaults) {
   return result;
 }
 
-// src/utils/cli-helpers.ts
-import { writeFileSync, mkdirSync, existsSync as existsSync3 } from "fs";
-import { join as join3, dirname as dirname3 } from "path";
-function resolveOutputPath(userPath, defaultFilename, workingDir = process.cwd()) {
-  let outputPath;
-  if (userPath) {
-    outputPath = userPath;
-  } else {
-    const aireadyDir = join3(workingDir, ".aiready");
-    outputPath = join3(aireadyDir, defaultFilename);
-  }
-  const parentDir = dirname3(outputPath);
-  if (!existsSync3(parentDir)) {
-    mkdirSync(parentDir, { recursive: true });
-  }
-  return outputPath;
-}
-async function loadMergedConfig(directory, defaults, cliOptions) {
-  const config = await loadConfig(directory);
-  const mergedConfig = mergeConfigWithDefaults(config, defaults);
-  const result = {
-    ...mergedConfig,
-    ...cliOptions,
-    rootDir: directory
-  };
-  return result;
-}
-function handleJSONOutput(data, outputFile, successMessage) {
-  if (outputFile) {
-    const dir = dirname3(outputFile);
-    if (!existsSync3(dir)) {
-      mkdirSync(dir, { recursive: true });
-    }
-    writeFileSync(outputFile, JSON.stringify(data, null, 2));
-    console.log(successMessage || `\u2705 Results saved to ${outputFile}`);
-  } else {
-    console.log(JSON.stringify(data, null, 2));
-  }
-}
-function handleCLIError(error, commandName) {
-  console.error(`\u274C ${commandName} failed:`, error);
-  process.exit(1);
-}
-function getElapsedTime(startTime) {
-  return ((Date.now() - startTime) / 1e3).toFixed(2);
-}
-function getScoreBar(val) {
-  return "\u2588".repeat(Math.round(val / 10)).padEnd(10, "\u2591");
-}
-function getSafetyIcon(rating) {
-  switch (rating) {
-    case "safe":
-      return "\u2705";
-    case "moderate-risk":
-      return "\u26A0\uFE0F ";
-    case "high-risk":
-      return "\u{1F534}";
-    case "blind-risk":
-      return "\u{1F480}";
-    default:
-      return "\u2753";
-  }
-}
-function getSeverityColor(severity, chalk) {
-  switch (severity.toLowerCase()) {
-    case "critical":
-    case "high-risk":
-    case "blind-risk":
-      return chalk.red;
-    case "major":
-    case "moderate-risk":
-      return chalk.yellow;
-    case "minor":
-    case "safe":
-      return chalk.green;
-    case "info":
-      return chalk.blue;
-    default:
-      return chalk.white;
-  }
-}
-
 // src/business/pricing-models.ts
 var MODEL_PRICING_PRESETS = {
   "gpt-5.3": {
@@ -2296,8 +2302,8 @@ function calculateChangeAmplification(params) {
   const maxAmplification = hotspots[0].amplificationFactor;
   const avgAmplification = hotspots.reduce((sum, h) => sum + h.amplificationFactor, 0) / hotspots.length;
   const avgPenalty = Math.log2(avgAmplification + 1) * 15;
-  const maxPenalty = maxAmplification > 30 ? (maxAmplification - 30) * 1.5 : 0;
-  const score = Math.max(0, Math.min(100, 100 - avgPenalty - maxPenalty));
+  const maxPenalty = maxAmplification > 30 ? Math.log10(maxAmplification - 29) * 30 : 0;
+  const score = Math.max(5, Math.min(100, 100 - avgPenalty - maxPenalty));
   let rating = "isolated";
   if (score < 40) rating = "explosive";
   else if (score < 70) rating = "amplified";
@@ -2667,6 +2673,7 @@ export {
   calculateTestabilityIndex,
   calculateTokenBudget,
   clearHistory,
+  emitProgress,
   estimateCostFromBudget,
   estimateTokens,
   exportHistory,

package/package.json

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