@aiready/core 0.9.23 → 0.9.25

package/dist/client.d.mts

@@ -23,6 +23,96 @@ interface Metrics {
     complexityScore?: number;
     consistencyScore?: number;
     docFreshnessScore?: number;
+    estimatedMonthlyCost?: number;
+    estimatedDeveloperHours?: number;
+    comprehensionDifficultyIndex?: number;
+}
+/**
+ * Cost estimation configuration
+ */
+interface CostConfig {
+    /** Price per 1K tokens (default: $0.01 for GPT-4) */
+    pricePer1KTokens: number;
+    /** Average AI queries per developer per day */
+    queriesPerDevPerDay: number;
+    /** Number of developers on the team */
+    developerCount: number;
+    /** Days per month (default: 30) */
+    daysPerMonth: number;
+}
+/**
+ * Productivity impact estimates
+ */
+interface ProductivityImpact {
+    /** Estimated hours to fix all issues */
+    totalHours: number;
+    /** Average hourly rate for developers */
+    hourlyRate: number;
+    /** Estimated total fix cost */
+    totalCost: number;
+    /** Breakdown by severity */
+    bySeverity: {
+        critical: {
+            hours: number;
+            cost: number;
+        };
+        major: {
+            hours: number;
+            cost: number;
+        };
+        minor: {
+            hours: number;
+            cost: number;
+        };
+    };
+}
+/**
+ * AI acceptance rate prediction
+ * Based on research correlating code quality to AI suggestion acceptance
+ */
+interface AcceptancePrediction {
+    /** Predicted acceptance rate (0-1) */
+    rate: number;
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Factors affecting acceptance */
+    factors: {
+        name: string;
+        impact: number;
+    }[];
+}
+/**
+ * Comprehension difficulty score (future-proof abstraction)
+ * Normalized 0-100 scale: lower = easier for AI to understand
+ */
+interface ComprehensionDifficulty {
+    /** Overall difficulty score (0-100) */
+    score: number;
+    /** Factors contributing to difficulty */
+    factors: {
+        name: string;
+        contribution: number;
+        description: string;
+    }[];
+    /** Interpretation */
+    rating: 'trivial' | 'easy' | 'moderate' | 'difficult' | 'expert';
+}
+/**
+ * Extended report with business metrics
+ */
+interface BusinessReport extends Report {
+    businessMetrics: {
+        /** Estimated monthly cost impact of AI context waste */
+        estimatedMonthlyCost: number;
+        /** Estimated developer hours to address issues */
+        estimatedDeveloperHours: number;
+        /** Predicted AI suggestion acceptance rate */
+        aiAcceptanceRate: number;
+        /** Comprehension difficulty assessment */
+        comprehensionDifficulty: ComprehensionDifficulty;
+        /** Timestamp for trend tracking */
+        period?: string;
+    };
 }
 interface ScanOptions {
     rootDir: string;
@@ -454,4 +544,4 @@ declare function formatToolScore(output: ToolScoringOutput): string;
  */
 declare function generateHTML(graph: GraphData): string;
 
-export { type AIReadyConfig, type AnalysisResult, type CommonASTNode, DEFAULT_TOOL_WEIGHTS, type ExportInfo, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, type IssueType, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, type Metrics, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type Report, type ScanOptions, type ScoringConfig, type ScoringResult, type SourceLocation, type SourceRange, TOOL_NAME_MAP, type ToolScoringOutput, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString };
+export { type AIReadyConfig, type AcceptancePrediction, type AnalysisResult, type BusinessReport, type CommonASTNode, type ComprehensionDifficulty, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, type IssueType, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, type Metrics, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, type Report, type ScanOptions, type ScoringConfig, type ScoringResult, type SourceLocation, type SourceRange, TOOL_NAME_MAP, type ToolScoringOutput, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString };

package/dist/client.d.ts

@@ -23,6 +23,96 @@ interface Metrics {
     complexityScore?: number;
     consistencyScore?: number;
     docFreshnessScore?: number;
+    estimatedMonthlyCost?: number;
+    estimatedDeveloperHours?: number;
+    comprehensionDifficultyIndex?: number;
+}
+/**
+ * Cost estimation configuration
+ */
+interface CostConfig {
+    /** Price per 1K tokens (default: $0.01 for GPT-4) */
+    pricePer1KTokens: number;
+    /** Average AI queries per developer per day */
+    queriesPerDevPerDay: number;
+    /** Number of developers on the team */
+    developerCount: number;
+    /** Days per month (default: 30) */
+    daysPerMonth: number;
+}
+/**
+ * Productivity impact estimates
+ */
+interface ProductivityImpact {
+    /** Estimated hours to fix all issues */
+    totalHours: number;
+    /** Average hourly rate for developers */
+    hourlyRate: number;
+    /** Estimated total fix cost */
+    totalCost: number;
+    /** Breakdown by severity */
+    bySeverity: {
+        critical: {
+            hours: number;
+            cost: number;
+        };
+        major: {
+            hours: number;
+            cost: number;
+        };
+        minor: {
+            hours: number;
+            cost: number;
+        };
+    };
+}
+/**
+ * AI acceptance rate prediction
+ * Based on research correlating code quality to AI suggestion acceptance
+ */
+interface AcceptancePrediction {
+    /** Predicted acceptance rate (0-1) */
+    rate: number;
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Factors affecting acceptance */
+    factors: {
+        name: string;
+        impact: number;
+    }[];
+}
+/**
+ * Comprehension difficulty score (future-proof abstraction)
+ * Normalized 0-100 scale: lower = easier for AI to understand
+ */
+interface ComprehensionDifficulty {
+    /** Overall difficulty score (0-100) */
+    score: number;
+    /** Factors contributing to difficulty */
+    factors: {
+        name: string;
+        contribution: number;
+        description: string;
+    }[];
+    /** Interpretation */
+    rating: 'trivial' | 'easy' | 'moderate' | 'difficult' | 'expert';
+}
+/**
+ * Extended report with business metrics
+ */
+interface BusinessReport extends Report {
+    businessMetrics: {
+        /** Estimated monthly cost impact of AI context waste */
+        estimatedMonthlyCost: number;
+        /** Estimated developer hours to address issues */
+        estimatedDeveloperHours: number;
+        /** Predicted AI suggestion acceptance rate */
+        aiAcceptanceRate: number;
+        /** Comprehension difficulty assessment */
+        comprehensionDifficulty: ComprehensionDifficulty;
+        /** Timestamp for trend tracking */
+        period?: string;
+    };
 }
 interface ScanOptions {
     rootDir: string;
@@ -454,4 +544,4 @@ declare function formatToolScore(output: ToolScoringOutput): string;
  */
 declare function generateHTML(graph: GraphData): string;
 
-export { type AIReadyConfig, type AnalysisResult, type CommonASTNode, DEFAULT_TOOL_WEIGHTS, type ExportInfo, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, type IssueType, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, type Metrics, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type Report, type ScanOptions, type ScoringConfig, type ScoringResult, type SourceLocation, type SourceRange, TOOL_NAME_MAP, type ToolScoringOutput, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString };
+export { type AIReadyConfig, type AcceptancePrediction, type AnalysisResult, type BusinessReport, type CommonASTNode, type ComprehensionDifficulty, type CostConfig, DEFAULT_TOOL_WEIGHTS, type ExportInfo, type GraphData, type GraphEdge, type GraphIssueSeverity, type GraphMetadata, type GraphNode, type ImportInfo, type Issue, type IssueType, LANGUAGE_EXTENSIONS, Language, type LanguageConfig, type LanguageParser, type Location, type Metrics, type NamingConvention, ParseError, type ParseResult, type ParseStatistics, type ProductivityImpact, type Report, type ScanOptions, type ScoringConfig, type ScoringResult, type SourceLocation, type SourceRange, TOOL_NAME_MAP, type ToolScoringOutput, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { ScanOptions, AIReadyConfig, LanguageParser, Language, ParseResult, NamingConvention } from './client.mjs';
-export { AnalysisResult, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueType, LANGUAGE_EXTENSIONS, LanguageConfig, Location, Metrics, ParseError, ParseStatistics, Report, ScoringConfig, ScoringResult, SourceLocation, SourceRange, TOOL_NAME_MAP, ToolScoringOutput, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
+import { ScanOptions, AIReadyConfig, CostConfig, ComprehensionDifficulty, ProductivityImpact, ToolScoringOutput, AcceptancePrediction, LanguageParser, Language, ParseResult, NamingConvention } from './client.mjs';
+export { AnalysisResult, BusinessReport, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueType, LANGUAGE_EXTENSIONS, LanguageConfig, Location, Metrics, ParseError, ParseStatistics, Report, ScoringConfig, ScoringResult, SourceLocation, SourceRange, TOOL_NAME_MAP, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString } from './client.mjs';
 
 declare const DEFAULT_EXCLUDE: string[];
 /**
@@ -112,6 +112,59 @@ declare function handleCLIError(error: unknown, commandName: string): never;
  */
 declare function getElapsedTime(startTime: number): string;
 
+/**
+ * Business Value Metrics Module
+ *
+ * Provides business-aligned metrics that quantify ROI and survive technology changes.
+ * These metrics connect technical measurements to developer productivity and cost impact.
+ */
+
+/**
+ * Default cost configuration
+ * Based on GPT-4 pricing and typical team usage
+ */
+declare const DEFAULT_COST_CONFIG: CostConfig;
+/**
+ * Calculate estimated monthly cost of AI context waste
+ *
+ * Formula: (tokenWaste / 1000) × pricePer1K × queriesPerDev × devCount × days
+ */
+declare function calculateMonthlyCost(tokenWaste: number, config?: Partial<CostConfig>): number;
+/**
+ * Calculate productivity impact from issues
+ */
+declare function calculateProductivityImpact(issues: {
+    severity: string;
+}[], hourlyRate?: number): ProductivityImpact;
+/**
+ * Predict AI suggestion acceptance rate based on code quality
+ *
+ * Research shows:
+ * - High consistency correlates with 30%+ higher acceptance
+ * - Low context budget improves understanding by ~40%
+ * - Good naming patterns reduce clarification needs by 50%
+ */
+declare function predictAcceptanceRate(toolOutputs: Map<string, ToolScoringOutput>): AcceptancePrediction;
+/**
+ * Calculate Comprehension Difficulty Index
+ *
+ * A future-proof abstraction that normalizes multiple factors
+ * into a single difficulty score. Lower = easier for AI.
+ */
+declare function calculateComprehensionDifficulty(contextBudget: number, importDepth: number, fragmentation: number, consistencyScore: number, totalFiles: number): ComprehensionDifficulty;
+/**
+ * Format cost for display
+ */
+declare function formatCost(cost: number): string;
+/**
+ * Format hours for display
+ */
+declare function formatHours(hours: number): string;
+/**
+ * Format acceptance rate for display
+ */
+declare function formatAcceptanceRate(rate: number): string;
+
 /**
  * Parser Factory - Manages language-specific parsers
  *
@@ -240,4 +293,4 @@ declare class PythonParser implements LanguageParser {
     private extractExportsRegex;
 }
 
-export { AIReadyConfig, type ASTNode, type CLIOptions, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, Language, LanguageParser, NamingConvention, ParseResult, ParserFactory, PythonParser, ScanOptions, TypeScriptParser, calculateImportSimilarity, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, getParser, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, readFileContent, resolveOutputPath, scanFiles };
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type CLIOptions, ComprehensionDifficulty, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, Language, LanguageParser, NamingConvention, ParseResult, ParserFactory, ProductivityImpact, PythonParser, ScanOptions, ToolScoringOutput, TypeScriptParser, calculateComprehensionDifficulty, calculateImportSimilarity, calculateMonthlyCost, calculateProductivityImpact, estimateTokens, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, getElapsedTime, getFileExtension, getParser, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, scanFiles };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ScanOptions, AIReadyConfig, LanguageParser, Language, ParseResult, NamingConvention } from './client.js';
-export { AnalysisResult, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueType, LANGUAGE_EXTENSIONS, LanguageConfig, Location, Metrics, ParseError, ParseStatistics, Report, ScoringConfig, ScoringResult, SourceLocation, SourceRange, TOOL_NAME_MAP, ToolScoringOutput, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
+import { ScanOptions, AIReadyConfig, CostConfig, ComprehensionDifficulty, ProductivityImpact, ToolScoringOutput, AcceptancePrediction, LanguageParser, Language, ParseResult, NamingConvention } from './client.js';
+export { AnalysisResult, BusinessReport, CommonASTNode, DEFAULT_TOOL_WEIGHTS, ExportInfo, GraphData, GraphEdge, GraphIssueSeverity, GraphMetadata, GraphNode, ImportInfo, Issue, IssueType, LANGUAGE_EXTENSIONS, LanguageConfig, Location, Metrics, ParseError, ParseStatistics, Report, ScoringConfig, ScoringResult, SourceLocation, SourceRange, TOOL_NAME_MAP, calculateOverallScore, formatScore, formatToolScore, generateHTML, getRating, getRatingDisplay, getToolWeight, normalizeToolName, parseWeightString } from './client.js';
 
 declare const DEFAULT_EXCLUDE: string[];
 /**
@@ -112,6 +112,59 @@ declare function handleCLIError(error: unknown, commandName: string): never;
  */
 declare function getElapsedTime(startTime: number): string;
 
+/**
+ * Business Value Metrics Module
+ *
+ * Provides business-aligned metrics that quantify ROI and survive technology changes.
+ * These metrics connect technical measurements to developer productivity and cost impact.
+ */
+
+/**
+ * Default cost configuration
+ * Based on GPT-4 pricing and typical team usage
+ */
+declare const DEFAULT_COST_CONFIG: CostConfig;
+/**
+ * Calculate estimated monthly cost of AI context waste
+ *
+ * Formula: (tokenWaste / 1000) × pricePer1K × queriesPerDev × devCount × days
+ */
+declare function calculateMonthlyCost(tokenWaste: number, config?: Partial<CostConfig>): number;
+/**
+ * Calculate productivity impact from issues
+ */
+declare function calculateProductivityImpact(issues: {
+    severity: string;
+}[], hourlyRate?: number): ProductivityImpact;
+/**
+ * Predict AI suggestion acceptance rate based on code quality
+ *
+ * Research shows:
+ * - High consistency correlates with 30%+ higher acceptance
+ * - Low context budget improves understanding by ~40%
+ * - Good naming patterns reduce clarification needs by 50%
+ */
+declare function predictAcceptanceRate(toolOutputs: Map<string, ToolScoringOutput>): AcceptancePrediction;
+/**
+ * Calculate Comprehension Difficulty Index
+ *
+ * A future-proof abstraction that normalizes multiple factors
+ * into a single difficulty score. Lower = easier for AI.
+ */
+declare function calculateComprehensionDifficulty(contextBudget: number, importDepth: number, fragmentation: number, consistencyScore: number, totalFiles: number): ComprehensionDifficulty;
+/**
+ * Format cost for display
+ */
+declare function formatCost(cost: number): string;
+/**
+ * Format hours for display
+ */
+declare function formatHours(hours: number): string;
+/**
+ * Format acceptance rate for display
+ */
+declare function formatAcceptanceRate(rate: number): string;
+
 /**
  * Parser Factory - Manages language-specific parsers
  *
@@ -240,4 +293,4 @@ declare class PythonParser implements LanguageParser {
     private extractExportsRegex;
 }
 
-export { AIReadyConfig, type ASTNode, type CLIOptions, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, Language, LanguageParser, NamingConvention, ParseResult, ParserFactory, PythonParser, ScanOptions, TypeScriptParser, calculateImportSimilarity, estimateTokens, extractFunctions, extractImports, getElapsedTime, getFileExtension, getParser, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, readFileContent, resolveOutputPath, scanFiles };
+export { AIReadyConfig, type ASTNode, AcceptancePrediction, type CLIOptions, ComprehensionDifficulty, CostConfig, DEFAULT_COST_CONFIG, DEFAULT_EXCLUDE, type ExportWithImports, type FileImport, Language, LanguageParser, NamingConvention, ParseResult, ParserFactory, ProductivityImpact, PythonParser, ScanOptions, ToolScoringOutput, TypeScriptParser, calculateComprehensionDifficulty, calculateImportSimilarity, calculateMonthlyCost, calculateProductivityImpact, estimateTokens, extractFunctions, extractImports, formatAcceptanceRate, formatCost, formatHours, getElapsedTime, getFileExtension, getParser, getSupportedLanguages, handleCLIError, handleJSONOutput, isFileSupported, isSourceFile, loadConfig, loadMergedConfig, mergeConfigWithDefaults, parseCode, parseFileExports, predictAcceptanceRate, readFileContent, resolveOutputPath, scanFiles };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,11 +17,20 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_COST_CONFIG: () => DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE: () => DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS: () => DEFAULT_TOOL_WEIGHTS,
   LANGUAGE_EXTENSIONS: () => LANGUAGE_EXTENSIONS,
@@ -29,11 +40,17 @@ __export(index_exports, {
   PythonParser: () => PythonParser,
   TOOL_NAME_MAP: () => TOOL_NAME_MAP,
   TypeScriptParser: () => TypeScriptParser,
+  calculateComprehensionDifficulty: () => calculateComprehensionDifficulty,
   calculateImportSimilarity: () => calculateImportSimilarity,
+  calculateMonthlyCost: () => calculateMonthlyCost,
   calculateOverallScore: () => calculateOverallScore,
+  calculateProductivityImpact: () => calculateProductivityImpact,
   estimateTokens: () => estimateTokens,
   extractFunctions: () => extractFunctions,
   extractImports: () => extractImports,
+  formatAcceptanceRate: () => formatAcceptanceRate,
+  formatCost: () => formatCost,
+  formatHours: () => formatHours,
   formatScore: () => formatScore,
   formatToolScore: () => formatToolScore,
   generateHTML: () => generateHTML,
@@ -55,6 +72,7 @@ __export(index_exports, {
   parseCode: () => parseCode,
   parseFileExports: () => parseFileExports,
   parseWeightString: () => parseWeightString,
+  predictAcceptanceRate: () => predictAcceptanceRate,
   readFileContent: () => readFileContent,
   resolveOutputPath: () => resolveOutputPath,
   scanFiles: () => scanFiles
@@ -97,6 +115,7 @@ var import_glob = require("glob");
 var import_promises = require("fs/promises");
 var import_fs = require("fs");
 var import_path = require("path");
+var import_ignore = __toESM(require("ignore"));
 var DEFAULT_EXCLUDE = [
   // Dependencies
   "**/node_modules/**",
@@ -165,6 +184,22 @@ async function scanFiles(options) {
     ignore: finalExclude,
     absolute: true
   });
+  const gitignorePath = (0, import_path.join)(rootDir || ".", ".gitignore");
+  if ((0, import_fs.existsSync)(gitignorePath)) {
+    try {
+      const gitTxt = await (0, import_promises.readFile)(gitignorePath, "utf-8");
+      const ig = (0, import_ignore.default)();
+      ig.add(gitTxt);
+      const filtered = files.filter((f) => {
+        let rel = (0, import_path.relative)(rootDir || ".", f).replace(/\\/g, "/");
+        if (rel === "") rel = f;
+        return !ig.ignores(rel);
+      });
+      return filtered;
+    } catch (e) {
+      return files;
+    }
+  }
   return files;
 }
 async function readFileContent(filePath) {
@@ -783,6 +818,167 @@ function formatToolScore(output) {
   return result;
 }
 
+// src/business-metrics.ts
+var DEFAULT_COST_CONFIG = {
+  pricePer1KTokens: 0.01,
+  // $0.01 per 1K tokens (GPT-4)
+  queriesPerDevPerDay: 50,
+  // Average AI queries per developer
+  developerCount: 5,
+  // Default team size
+  daysPerMonth: 30
+};
+var SEVERITY_TIME_ESTIMATES = {
+  critical: 4,
+  // Complex architectural issues
+  major: 2,
+  // Significant refactoring needed
+  minor: 0.5,
+  // Simple naming/style fixes
+  info: 0.25
+  // Documentation improvements
+};
+var DEFAULT_HOURLY_RATE = 75;
+function calculateMonthlyCost(tokenWaste, config = {}) {
+  const cfg = { ...DEFAULT_COST_CONFIG, ...config };
+  const tokensPerDay = tokenWaste * cfg.queriesPerDevPerDay;
+  const tokensPerMonth = tokensPerDay * cfg.daysPerMonth;
+  const cost = tokensPerMonth / 1e3 * cfg.pricePer1KTokens;
+  return Math.round(cost * 100) / 100;
+}
+function calculateProductivityImpact(issues, hourlyRate = DEFAULT_HOURLY_RATE) {
+  const counts = {
+    critical: issues.filter((i) => i.severity === "critical").length,
+    major: issues.filter((i) => i.severity === "major").length,
+    minor: issues.filter((i) => i.severity === "minor").length,
+    info: issues.filter((i) => i.severity === "info").length
+  };
+  const hours = {
+    critical: counts.critical * SEVERITY_TIME_ESTIMATES.critical,
+    major: counts.major * SEVERITY_TIME_ESTIMATES.major,
+    minor: counts.minor * SEVERITY_TIME_ESTIMATES.minor,
+    info: counts.info * SEVERITY_TIME_ESTIMATES.info
+  };
+  const totalHours = hours.critical + hours.major + hours.minor + hours.info;
+  const totalCost = totalHours * hourlyRate;
+  return {
+    totalHours: Math.round(totalHours * 10) / 10,
+    hourlyRate,
+    totalCost: Math.round(totalCost),
+    bySeverity: {
+      critical: { hours: Math.round(hours.critical * 10) / 10, cost: Math.round(hours.critical * hourlyRate) },
+      major: { hours: Math.round(hours.major * 10) / 10, cost: Math.round(hours.major * hourlyRate) },
+      minor: { hours: Math.round(hours.minor * 10) / 10, cost: Math.round(hours.minor * hourlyRate) }
+    }
+  };
+}
+function predictAcceptanceRate(toolOutputs) {
+  const factors = [];
+  const patterns = toolOutputs.get("pattern-detect");
+  if (patterns) {
+    const patternImpact = (patterns.score - 50) * 0.3;
+    factors.push({
+      name: "Semantic Duplication",
+      impact: Math.round(patternImpact)
+    });
+  }
+  const context = toolOutputs.get("context-analyzer");
+  if (context) {
+    const contextImpact = (context.score - 50) * 0.4;
+    factors.push({
+      name: "Context Efficiency",
+      impact: Math.round(contextImpact)
+    });
+  }
+  const consistency = toolOutputs.get("consistency");
+  if (consistency) {
+    const consistencyImpact = (consistency.score - 50) * 0.3;
+    factors.push({
+      name: "Code Consistency",
+      impact: Math.round(consistencyImpact)
+    });
+  }
+  const baseRate = 0.65;
+  const totalImpact = factors.reduce((sum, f) => sum + f.impact / 100, 0);
+  const rate = Math.max(0.1, Math.min(0.95, baseRate + totalImpact));
+  const confidence = toolOutputs.size >= 3 ? 0.8 : toolOutputs.size >= 2 ? 0.6 : 0.4;
+  return {
+    rate: Math.round(rate * 100) / 100,
+    confidence,
+    factors
+  };
+}
+function calculateComprehensionDifficulty(contextBudget, importDepth, fragmentation, consistencyScore, totalFiles) {
+  const budgetFactor = Math.min(100, Math.max(0, (contextBudget - 5e3) / 250));
+  const depthFactor = Math.min(100, Math.max(0, (importDepth - 5) * 10));
+  const fragmentationFactor = Math.min(100, Math.max(0, (fragmentation - 0.3) * 250));
+  const consistencyFactor = Math.min(100, Math.max(0, 100 - consistencyScore));
+  const fileFactor = Math.min(100, Math.max(0, (totalFiles - 50) / 5));
+  const score = Math.round(
+    budgetFactor * 0.35 + depthFactor * 0.2 + fragmentationFactor * 0.2 + consistencyFactor * 0.15 + fileFactor * 0.1
+  );
+  let rating;
+  if (score < 20) rating = "trivial";
+  else if (score < 40) rating = "easy";
+  else if (score < 60) rating = "moderate";
+  else if (score < 80) rating = "difficult";
+  else rating = "expert";
+  return {
+    score,
+    rating,
+    factors: [
+      {
+        name: "Context Budget",
+        contribution: Math.round(budgetFactor * 0.35),
+        description: `${Math.round(contextBudget)} tokens required`
+      },
+      {
+        name: "Import Depth",
+        contribution: Math.round(depthFactor * 0.2),
+        description: `${importDepth.toFixed(1)} average levels`
+      },
+      {
+        name: "Code Fragmentation",
+        contribution: Math.round(fragmentationFactor * 0.2),
+        description: `${(fragmentation * 100).toFixed(0)}% fragmentation`
+      },
+      {
+        name: "Consistency",
+        contribution: Math.round(consistencyFactor * 0.15),
+        description: `${consistencyScore}/100 consistency score`
+      },
+      {
+        name: "Project Scale",
+        contribution: Math.round(fileFactor * 0.1),
+        description: `${totalFiles} files analyzed`
+      }
+    ]
+  };
+}
+function formatCost(cost) {
+  if (cost < 1) {
+    return `$${cost.toFixed(2)}`;
+  } else if (cost < 1e3) {
+    return `$${cost.toFixed(0)}`;
+  } else {
+    return `$${(cost / 1e3).toFixed(1)}k`;
+  }
+}
+function formatHours(hours) {
+  if (hours < 1) {
+    return `${Math.round(hours * 60)}min`;
+  } else if (hours < 8) {
+    return `${hours.toFixed(1)}h`;
+  } else if (hours < 40) {
+    return `${Math.round(hours)}h`;
+  } else {
+    return `${(hours / 40).toFixed(1)} weeks`;
+  }
+}
+function formatAcceptanceRate(rate) {
+  return `${Math.round(rate * 100)}%`;
+}
+
 // src/parsers/typescript-parser.ts
 var import_typescript_estree2 = require("@typescript-eslint/typescript-estree");
 var TypeScriptParser = class {
@@ -1264,6 +1460,7 @@ function getSupportedLanguages() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS,
   LANGUAGE_EXTENSIONS,
@@ -1273,11 +1470,17 @@ function getSupportedLanguages() {
   PythonParser,
   TOOL_NAME_MAP,
   TypeScriptParser,
+  calculateComprehensionDifficulty,
   calculateImportSimilarity,
+  calculateMonthlyCost,
   calculateOverallScore,
+  calculateProductivityImpact,
   estimateTokens,
   extractFunctions,
   extractImports,
+  formatAcceptanceRate,
+  formatCost,
+  formatHours,
   formatScore,
   formatToolScore,
   generateHTML,
@@ -1299,6 +1502,7 @@ function getSupportedLanguages() {
   parseCode,
   parseFileExports,
   parseWeightString,
+  predictAcceptanceRate,
   readFileContent,
   resolveOutputPath,
   scanFiles

package/dist/index.mjs

@@ -19,7 +19,8 @@ import {
 import { glob } from "glob";
 import { readFile } from "fs/promises";
 import { existsSync } from "fs";
-import { join } from "path";
+import { join, relative } from "path";
+import ignorePkg from "ignore";
 var DEFAULT_EXCLUDE = [
   // Dependencies
   "**/node_modules/**",
@@ -88,6 +89,22 @@ async function scanFiles(options) {
     ignore: finalExclude,
     absolute: true
   });
+  const gitignorePath = join(rootDir || ".", ".gitignore");
+  if (existsSync(gitignorePath)) {
+    try {
+      const gitTxt = await readFile(gitignorePath, "utf-8");
+      const ig = ignorePkg();
+      ig.add(gitTxt);
+      const filtered = files.filter((f) => {
+        let rel = relative(rootDir || ".", f).replace(/\\/g, "/");
+        if (rel === "") rel = f;
+        return !ig.ignores(rel);
+      });
+      return filtered;
+    } catch (e) {
+      return files;
+    }
+  }
   return files;
 }
 async function readFileContent(filePath) {
@@ -396,6 +413,167 @@ function getElapsedTime(startTime) {
   return ((Date.now() - startTime) / 1e3).toFixed(2);
 }
 
+// src/business-metrics.ts
+var DEFAULT_COST_CONFIG = {
+  pricePer1KTokens: 0.01,
+  // $0.01 per 1K tokens (GPT-4)
+  queriesPerDevPerDay: 50,
+  // Average AI queries per developer
+  developerCount: 5,
+  // Default team size
+  daysPerMonth: 30
+};
+var SEVERITY_TIME_ESTIMATES = {
+  critical: 4,
+  // Complex architectural issues
+  major: 2,
+  // Significant refactoring needed
+  minor: 0.5,
+  // Simple naming/style fixes
+  info: 0.25
+  // Documentation improvements
+};
+var DEFAULT_HOURLY_RATE = 75;
+function calculateMonthlyCost(tokenWaste, config = {}) {
+  const cfg = { ...DEFAULT_COST_CONFIG, ...config };
+  const tokensPerDay = tokenWaste * cfg.queriesPerDevPerDay;
+  const tokensPerMonth = tokensPerDay * cfg.daysPerMonth;
+  const cost = tokensPerMonth / 1e3 * cfg.pricePer1KTokens;
+  return Math.round(cost * 100) / 100;
+}
+function calculateProductivityImpact(issues, hourlyRate = DEFAULT_HOURLY_RATE) {
+  const counts = {
+    critical: issues.filter((i) => i.severity === "critical").length,
+    major: issues.filter((i) => i.severity === "major").length,
+    minor: issues.filter((i) => i.severity === "minor").length,
+    info: issues.filter((i) => i.severity === "info").length
+  };
+  const hours = {
+    critical: counts.critical * SEVERITY_TIME_ESTIMATES.critical,
+    major: counts.major * SEVERITY_TIME_ESTIMATES.major,
+    minor: counts.minor * SEVERITY_TIME_ESTIMATES.minor,
+    info: counts.info * SEVERITY_TIME_ESTIMATES.info
+  };
+  const totalHours = hours.critical + hours.major + hours.minor + hours.info;
+  const totalCost = totalHours * hourlyRate;
+  return {
+    totalHours: Math.round(totalHours * 10) / 10,
+    hourlyRate,
+    totalCost: Math.round(totalCost),
+    bySeverity: {
+      critical: { hours: Math.round(hours.critical * 10) / 10, cost: Math.round(hours.critical * hourlyRate) },
+      major: { hours: Math.round(hours.major * 10) / 10, cost: Math.round(hours.major * hourlyRate) },
+      minor: { hours: Math.round(hours.minor * 10) / 10, cost: Math.round(hours.minor * hourlyRate) }
+    }
+  };
+}
+function predictAcceptanceRate(toolOutputs) {
+  const factors = [];
+  const patterns = toolOutputs.get("pattern-detect");
+  if (patterns) {
+    const patternImpact = (patterns.score - 50) * 0.3;
+    factors.push({
+      name: "Semantic Duplication",
+      impact: Math.round(patternImpact)
+    });
+  }
+  const context = toolOutputs.get("context-analyzer");
+  if (context) {
+    const contextImpact = (context.score - 50) * 0.4;
+    factors.push({
+      name: "Context Efficiency",
+      impact: Math.round(contextImpact)
+    });
+  }
+  const consistency = toolOutputs.get("consistency");
+  if (consistency) {
+    const consistencyImpact = (consistency.score - 50) * 0.3;
+    factors.push({
+      name: "Code Consistency",
+      impact: Math.round(consistencyImpact)
+    });
+  }
+  const baseRate = 0.65;
+  const totalImpact = factors.reduce((sum, f) => sum + f.impact / 100, 0);
+  const rate = Math.max(0.1, Math.min(0.95, baseRate + totalImpact));
+  const confidence = toolOutputs.size >= 3 ? 0.8 : toolOutputs.size >= 2 ? 0.6 : 0.4;
+  return {
+    rate: Math.round(rate * 100) / 100,
+    confidence,
+    factors
+  };
+}
+function calculateComprehensionDifficulty(contextBudget, importDepth, fragmentation, consistencyScore, totalFiles) {
+  const budgetFactor = Math.min(100, Math.max(0, (contextBudget - 5e3) / 250));
+  const depthFactor = Math.min(100, Math.max(0, (importDepth - 5) * 10));
+  const fragmentationFactor = Math.min(100, Math.max(0, (fragmentation - 0.3) * 250));
+  const consistencyFactor = Math.min(100, Math.max(0, 100 - consistencyScore));
+  const fileFactor = Math.min(100, Math.max(0, (totalFiles - 50) / 5));
+  const score = Math.round(
+    budgetFactor * 0.35 + depthFactor * 0.2 + fragmentationFactor * 0.2 + consistencyFactor * 0.15 + fileFactor * 0.1
+  );
+  let rating;
+  if (score < 20) rating = "trivial";
+  else if (score < 40) rating = "easy";
+  else if (score < 60) rating = "moderate";
+  else if (score < 80) rating = "difficult";
+  else rating = "expert";
+  return {
+    score,
+    rating,
+    factors: [
+      {
+        name: "Context Budget",
+        contribution: Math.round(budgetFactor * 0.35),
+        description: `${Math.round(contextBudget)} tokens required`
+      },
+      {
+        name: "Import Depth",
+        contribution: Math.round(depthFactor * 0.2),
+        description: `${importDepth.toFixed(1)} average levels`
+      },
+      {
+        name: "Code Fragmentation",
+        contribution: Math.round(fragmentationFactor * 0.2),
+        description: `${(fragmentation * 100).toFixed(0)}% fragmentation`
+      },
+      {
+        name: "Consistency",
+        contribution: Math.round(consistencyFactor * 0.15),
+        description: `${consistencyScore}/100 consistency score`
+      },
+      {
+        name: "Project Scale",
+        contribution: Math.round(fileFactor * 0.1),
+        description: `${totalFiles} files analyzed`
+      }
+    ]
+  };
+}
+function formatCost(cost) {
+  if (cost < 1) {
+    return `$${cost.toFixed(2)}`;
+  } else if (cost < 1e3) {
+    return `$${cost.toFixed(0)}`;
+  } else {
+    return `$${(cost / 1e3).toFixed(1)}k`;
+  }
+}
+function formatHours(hours) {
+  if (hours < 1) {
+    return `${Math.round(hours * 60)}min`;
+  } else if (hours < 8) {
+    return `${hours.toFixed(1)}h`;
+  } else if (hours < 40) {
+    return `${Math.round(hours)}h`;
+  } else {
+    return `${(hours / 40).toFixed(1)} weeks`;
+  }
+}
+function formatAcceptanceRate(rate) {
+  return `${Math.round(rate * 100)}%`;
+}
+
 // src/parsers/typescript-parser.ts
 import { parse as parse2 } from "@typescript-eslint/typescript-estree";
 var TypeScriptParser = class {
@@ -876,6 +1054,7 @@ function getSupportedLanguages() {
   return ParserFactory.getInstance().getSupportedLanguages();
 }
 export {
+  DEFAULT_COST_CONFIG,
   DEFAULT_EXCLUDE,
   DEFAULT_TOOL_WEIGHTS,
   LANGUAGE_EXTENSIONS,
@@ -885,11 +1064,17 @@ export {
   PythonParser,
   TOOL_NAME_MAP,
   TypeScriptParser,
+  calculateComprehensionDifficulty,
   calculateImportSimilarity,
+  calculateMonthlyCost,
   calculateOverallScore,
+  calculateProductivityImpact,
   estimateTokens,
   extractFunctions,
   extractImports,
+  formatAcceptanceRate,
+  formatCost,
+  formatHours,
   formatScore,
   formatToolScore,
   generateHTML,
@@ -911,6 +1096,7 @@ export {
   parseCode,
   parseFileExports,
   parseWeightString,
+  predictAcceptanceRate,
   readFileContent,
   resolveOutputPath,
   scanFiles

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.9.23",
+  "version": "0.9.25",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -47,6 +47,7 @@
     "@typescript-eslint/typescript-estree": "^8.53.0",
     "chalk": "^5.4.1",
     "glob": "^13.0.0",
+    "ignore": "^7.0.0",
     "typescript": "^5.9.3"
   },
   "scripts": {