@aiready/core 0.9.33 → 0.9.37

package/dist/index.js

@@ -43,6 +43,7 @@ __export(index_exports, {
   SIZE_ADJUSTED_THRESHOLDS: () => SIZE_ADJUSTED_THRESHOLDS,
   TOOL_NAME_MAP: () => TOOL_NAME_MAP,
   TypeScriptParser: () => TypeScriptParser,
+  VAGUE_FILE_NAMES: () => VAGUE_FILE_NAMES,
   calculateAgentGrounding: () => calculateAgentGrounding,
   calculateAiSignalClarity: () => calculateAiSignalClarity,
   calculateChangeAmplification: () => calculateChangeAmplification,
@@ -64,7 +65,9 @@ __export(index_exports, {
   calculateSemanticDistance: () => calculateSemanticDistance,
   calculateTechnicalDebtInterest: () => calculateTechnicalDebtInterest,
   calculateTestabilityIndex: () => calculateTestabilityIndex,
+  calculateTokenBudget: () => calculateTokenBudget,
   clearHistory: () => clearHistory,
+  estimateCostFromBudget: () => estimateCostFromBudget,
   estimateTokens: () => estimateTokens,
   exportHistory: () => exportHistory,
   extractFunctions: () => extractFunctions,
@@ -75,10 +78,13 @@ __export(index_exports, {
   formatScore: () => formatScore,
   formatToolScore: () => formatToolScore,
   generateHTML: () => generateHTML,
+  generateValueChain: () => generateValueChain,
   getDebtBreakdown: () => getDebtBreakdown,
   getElapsedTime: () => getElapsedTime,
+  getFileCommitTimestamps: () => getFileCommitTimestamps,
   getFileExtension: () => getFileExtension,
   getHistorySummary: () => getHistorySummary,
+  getLineRangeLastModifiedCached: () => getLineRangeLastModifiedCached,
   getModelPreset: () => getModelPreset,
   getParser: () => getParser,
   getProjectSizeTier: () => getProjectSizeTier,
@@ -86,6 +92,7 @@ __export(index_exports, {
   getRatingDisplay: () => getRatingDisplay,
   getRatingWithContext: () => getRatingWithContext,
   getRecommendedThreshold: () => getRecommendedThreshold,
+  getRepoMetadata: () => getRepoMetadata,
   getSupportedLanguages: () => getSupportedLanguages,
   getToolWeight: () => getToolWeight,
   handleCLIError: () => handleCLIError,
@@ -104,6 +111,7 @@ __export(index_exports, {
   readFileContent: () => readFileContent,
   resolveOutputPath: () => resolveOutputPath,
   saveScoreEntry: () => saveScoreEntry,
+  scanEntries: () => scanEntries,
   scanFiles: () => scanFiles
 });
 module.exports = __toCommonJS(index_exports);
@@ -159,6 +167,8 @@ var DEFAULT_EXCLUDE = [
   "**/cdk.out/**",
   // Framework-specific build dirs
   "**/.next/**",
+  "**/.sst/**",
+  "**/.open-next/**",
   "**/.nuxt/**",
   "**/.vuepress/**",
   "**/.cache/**",
@@ -190,6 +200,28 @@ var DEFAULT_EXCLUDE = [
   "**/*.log",
   "**/.DS_Store"
 ];
+var VAGUE_FILE_NAMES = /* @__PURE__ */ new Set([
+  "utils",
+  "helpers",
+  "helper",
+  "misc",
+  "common",
+  "shared",
+  "tools",
+  "util",
+  "lib",
+  "libs",
+  "stuff",
+  "functions",
+  "methods",
+  "handlers",
+  "data",
+  "temp",
+  "tmp",
+  "test-utils",
+  "test-helpers",
+  "mocks"
+]);
 async function scanFiles(options) {
   const {
     rootDir,
@@ -207,20 +239,35 @@ async function scanFiles(options) {
       ignoreFromFile = [];
     }
   }
+  const TEST_PATTERNS = ["**/*.test.*", "**/*.spec.*", "**/__tests__/**", "**/test/**", "**/tests/**"];
+  const baseExclude = options.includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
   const finalExclude = [
-    .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...DEFAULT_EXCLUDE])
+    .../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])
   ];
   const files = await (0, import_glob.glob)(include, {
     cwd: rootDir,
     ignore: finalExclude,
     absolute: true
   });
-  const gitignorePath = (0, import_path.join)(rootDir || ".", ".gitignore");
-  if ((0, import_fs.existsSync)(gitignorePath)) {
+  const gitignoreFiles = await (0, import_glob.glob)("**/.gitignore", {
+    cwd: rootDir,
+    ignore: finalExclude,
+    absolute: true
+  });
+  if (gitignoreFiles.length > 0) {
     try {
-      const gitTxt = await (0, import_promises.readFile)(gitignorePath, "utf-8");
       const ig = (0, import_ignore.default)();
-      ig.add(gitTxt);
+      for (const gitignorePath of gitignoreFiles) {
+        const gitTxt = await (0, import_promises.readFile)(gitignorePath, "utf-8");
+        const gitignoreDir = (0, import_path.dirname)(gitignorePath);
+        const relativePrefix = (0, import_path.relative)(rootDir || ".", gitignoreDir).replace(/\\/g, "/");
+        const patterns = gitTxt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#"));
+        if (relativePrefix === "." || relativePrefix === "") {
+          ig.add(patterns);
+        } else {
+          ig.add(patterns.map((p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`));
+        }
+      }
       const filtered = files.filter((f) => {
         let rel = (0, import_path.relative)(rootDir || ".", f).replace(/\\/g, "/");
         if (rel === "") rel = f;
@@ -233,6 +280,54 @@ async function scanFiles(options) {
   }
   return files;
 }
+async function scanEntries(options) {
+  const files = await scanFiles(options);
+  const { rootDir, include = ["**/*"], exclude, includeTests } = options;
+  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 TEST_PATTERNS = ["**/*.test.*", "**/*.spec.*", "**/__tests__/**", "**/test/**", "**/tests/**"];
+  const baseExclude = includeTests ? DEFAULT_EXCLUDE.filter((p) => !TEST_PATTERNS.includes(p)) : DEFAULT_EXCLUDE;
+  const finalExclude = [.../* @__PURE__ */ new Set([...exclude || [], ...ignoreFromFile, ...baseExclude])];
+  const dirs = await (0, import_glob.glob)("**/", {
+    cwd: rootDir,
+    ignore: finalExclude,
+    absolute: true
+  });
+  const gitignoreFiles = await (0, import_glob.glob)("**/.gitignore", {
+    cwd: rootDir,
+    ignore: finalExclude,
+    absolute: true
+  });
+  if (gitignoreFiles.length > 0) {
+    const ig = (0, import_ignore.default)();
+    for (const gitignorePath of gitignoreFiles) {
+      const gitTxt = await (0, import_promises.readFile)(gitignorePath, "utf-8");
+      const gitignoreDir = (0, import_path.dirname)(gitignorePath);
+      const relativePrefix = (0, import_path.relative)(rootDir || ".", gitignoreDir).replace(/\\/g, "/");
+      const patterns = gitTxt.split(/\r?\n/).map((s) => s.trim()).filter(Boolean).filter((l) => !l.startsWith("#"));
+      if (relativePrefix === "." || relativePrefix === "") {
+        ig.add(patterns);
+      } else {
+        ig.add(patterns.map((p) => p.startsWith("/") ? `${relativePrefix}${p}` : `${relativePrefix}/**/${p}`));
+      }
+    }
+    const filteredDirs = dirs.filter((d) => {
+      let rel = (0, import_path.relative)(rootDir || ".", d).replace(/\\/g, "/").replace(/\/$/, "");
+      if (rel === "") return true;
+      return !ig.ignores(rel);
+    });
+    return { files, dirs: filteredDirs };
+  }
+  return { files, dirs };
+}
 async function readFileContent(filePath) {
   return (0, import_promises.readFile)(filePath, "utf-8");
 }
@@ -457,9 +552,14 @@ async function loadConfig(rootDir) {
           return config;
         } catch (error) {
           const errorMessage = error instanceof Error ? error.message : String(error);
-          throw new Error(
+          const e = new Error(
             `Failed to load config from ${configPath}: ${errorMessage}`
           );
+          try {
+            e.cause = error instanceof Error ? error : void 0;
+          } catch {
+          }
+          throw e;
         }
       }
     }
@@ -901,80 +1001,65 @@ function formatToolScore(output) {
 
 // src/business-metrics.ts
 var MODEL_PRICING_PRESETS = {
-  "gpt-4": {
-    name: "GPT-4",
-    pricePer1KInputTokens: 0.03,
-    pricePer1KOutputTokens: 0.06,
-    contextTier: "standard",
-    typicalQueriesPerDevPerDay: 40
+  "gpt-5.3": {
+    name: "GPT-5.3",
+    pricePer1KInputTokens: 2e-3,
+    pricePer1KOutputTokens: 8e-3,
+    contextTier: "frontier",
+    typicalQueriesPerDevPerDay: 100
+  },
+  "claude-4.6": {
+    name: "Claude 4.6",
+    pricePer1KInputTokens: 15e-4,
+    pricePer1KOutputTokens: 75e-4,
+    contextTier: "frontier",
+    typicalQueriesPerDevPerDay: 100
+  },
+  "gemini-3.1": {
+    name: "Gemini 3.1 Pro",
+    pricePer1KInputTokens: 8e-4,
+    pricePer1KOutputTokens: 3e-3,
+    contextTier: "frontier",
+    typicalQueriesPerDevPerDay: 120
   },
   "gpt-4o": {
-    name: "GPT-4o",
+    name: "GPT-4o (legacy)",
     pricePer1KInputTokens: 5e-3,
     pricePer1KOutputTokens: 0.015,
     contextTier: "extended",
     typicalQueriesPerDevPerDay: 60
   },
-  "gpt-4o-mini": {
-    name: "GPT-4o mini",
-    pricePer1KInputTokens: 15e-5,
-    pricePer1KOutputTokens: 6e-4,
-    contextTier: "extended",
-    typicalQueriesPerDevPerDay: 120
-  },
   "claude-3-5-sonnet": {
-    name: "Claude 3.5 Sonnet",
+    name: "Claude 3.5 Sonnet (legacy)",
     pricePer1KInputTokens: 3e-3,
     pricePer1KOutputTokens: 0.015,
     contextTier: "extended",
     typicalQueriesPerDevPerDay: 80
   },
-  "claude-3-7-sonnet": {
-    name: "Claude 3.7 Sonnet",
-    pricePer1KInputTokens: 3e-3,
-    pricePer1KOutputTokens: 0.015,
-    contextTier: "frontier",
-    typicalQueriesPerDevPerDay: 80
-  },
-  "claude-sonnet-4": {
-    name: "Claude Sonnet 4",
-    pricePer1KInputTokens: 3e-3,
-    pricePer1KOutputTokens: 0.015,
-    contextTier: "frontier",
-    typicalQueriesPerDevPerDay: 80
-  },
   "gemini-1-5-pro": {
-    name: "Gemini 1.5 Pro",
+    name: "Gemini 1.5 Pro (legacy)",
     pricePer1KInputTokens: 125e-5,
     pricePer1KOutputTokens: 5e-3,
     contextTier: "frontier",
     typicalQueriesPerDevPerDay: 80
   },
-  "gemini-2-0-flash": {
-    name: "Gemini 2.0 Flash",
-    pricePer1KInputTokens: 1e-4,
-    pricePer1KOutputTokens: 4e-4,
-    contextTier: "frontier",
-    typicalQueriesPerDevPerDay: 150
-  },
   copilot: {
     name: "GitHub Copilot (subscription)",
-    // Amortized per-request cost for a $19/month plan at 80 queries/day
-    pricePer1KInputTokens: 1e-4,
-    pricePer1KOutputTokens: 1e-4,
-    contextTier: "extended",
-    typicalQueriesPerDevPerDay: 80
+    pricePer1KInputTokens: 8e-5,
+    pricePer1KOutputTokens: 8e-5,
+    contextTier: "frontier",
+    typicalQueriesPerDevPerDay: 150
   },
   "cursor-pro": {
     name: "Cursor Pro (subscription)",
-    pricePer1KInputTokens: 1e-4,
-    pricePer1KOutputTokens: 1e-4,
+    pricePer1KInputTokens: 8e-5,
+    pricePer1KOutputTokens: 8e-5,
     contextTier: "frontier",
-    typicalQueriesPerDevPerDay: 100
+    typicalQueriesPerDevPerDay: 200
   }
 };
 function getModelPreset(modelId) {
-  return MODEL_PRICING_PRESETS[modelId] ?? MODEL_PRICING_PRESETS["gpt-4o"];
+  return MODEL_PRICING_PRESETS[modelId] ?? MODEL_PRICING_PRESETS["claude-4.6"];
 }
 var DEFAULT_COST_CONFIG = {
   pricePer1KTokens: 5e-3,
@@ -987,21 +1072,71 @@ var DEFAULT_COST_CONFIG = {
 };
 var SEVERITY_TIME_ESTIMATES = {
   critical: 4,
-  // Complex architectural issues
+  // Complex architectural issues (industry avg: 6.8h)
   major: 2,
-  // Significant refactoring needed
+  // Significant refactoring needed (avg: 3.4h)
   minor: 0.5,
-  // Simple naming/style fixes
+  // Simple naming/style fixes (avg: 0.8h)
   info: 0.25
   // Documentation improvements
 };
 var DEFAULT_HOURLY_RATE = 75;
 function calculateMonthlyCost(tokenWaste, config = {}) {
+  const budget = calculateTokenBudget({
+    totalContextTokens: tokenWaste * 2.5,
+    // Heuristic: context is larger than waste
+    wastedTokens: {
+      duplication: tokenWaste * 0.7,
+      fragmentation: tokenWaste * 0.3,
+      chattiness: 0
+    }
+  });
+  const preset = getModelPreset("claude-4.6");
+  return estimateCostFromBudget(budget, preset, config);
+}
+function calculateTokenBudget(params) {
+  const { totalContextTokens, wastedTokens } = params;
+  const estimatedResponseTokens = params.estimatedResponseTokens ?? totalContextTokens * 0.2;
+  const totalWaste = wastedTokens.duplication + wastedTokens.fragmentation + wastedTokens.chattiness;
+  const efficiencyRatio = Math.max(
+    0,
+    Math.min(1, (totalContextTokens - totalWaste) / Math.max(1, totalContextTokens))
+  );
+  return {
+    totalContextTokens: Math.round(totalContextTokens),
+    estimatedResponseTokens: Math.round(estimatedResponseTokens),
+    wastedTokens: {
+      total: Math.round(totalWaste),
+      bySource: {
+        duplication: Math.round(wastedTokens.duplication),
+        fragmentation: Math.round(wastedTokens.fragmentation),
+        chattiness: Math.round(wastedTokens.chattiness)
+      }
+    },
+    efficiencyRatio: Math.round(efficiencyRatio * 100) / 100,
+    potentialRetrievableTokens: Math.round(totalWaste * 0.8)
+    // Heuristic: 80% is fixable
+  };
+}
+function estimateCostFromBudget(budget, model, config = {}) {
   const cfg = { ...DEFAULT_COST_CONFIG, ...config };
-  const tokensPerDay = tokenWaste * cfg.queriesPerDevPerDay;
+  const wastePerQuery = budget.wastedTokens.total;
+  const tokensPerDay = wastePerQuery * cfg.queriesPerDevPerDay;
   const tokensPerMonth = tokensPerDay * cfg.daysPerMonth;
-  const cost = tokensPerMonth / 1e3 * cfg.pricePer1KTokens;
-  return Math.round(cost * 100) / 100;
+  const totalWeight = cfg.developerCount;
+  const baseCost = tokensPerMonth / 1e3 * model.pricePer1KInputTokens * totalWeight;
+  let confidence = 0.85;
+  if (model.contextTier === "frontier") confidence = 0.7;
+  const variance = 0.25;
+  const range = [
+    Math.round(baseCost * (1 - variance) * 100) / 100,
+    Math.round(baseCost * (1 + variance) * 100) / 100
+  ];
+  return {
+    total: Math.round(baseCost * 100) / 100,
+    range,
+    confidence
+  };
 }
 function calculateProductivityImpact(issues, hourlyRate = DEFAULT_HOURLY_RATE) {
   const counts = {
@@ -1384,6 +1519,52 @@ function getDebtBreakdown(patternCost, contextCost, consistencyCost) {
     return priorityOrder[a.priority] - priorityOrder[b.priority];
   });
 }
+function generateValueChain(params) {
+  const { issueType, count, severity } = params;
+  const impacts = {
+    "duplicate-pattern": {
+      ai: "Ambiguous context leads to code generation variants. AI picks wrong implementation 40% of the time.",
+      dev: "Developers must manually resolve conflicts between suggested variants.",
+      risk: "high"
+    },
+    "context-fragmentation": {
+      ai: "Context window overflow causes model to forget mid-file dependencies resulting in hallucinations.",
+      dev: "Slower AI responses and increased need for manual context pinning.",
+      risk: "critical"
+    },
+    "naming-inconsistency": {
+      ai: "Degraded intent inference. AI misidentifies domain concepts across file boundaries.",
+      dev: "Increased cognitive load for new devs during onboarding.",
+      risk: "moderate"
+    }
+  };
+  const impact = impacts[issueType] || {
+    ai: "Reduced suggestion quality.",
+    dev: "Slowed development velocity.",
+    risk: "moderate"
+  };
+  const productivityLoss = severity === "critical" ? 0.25 : severity === "major" ? 0.1 : 0.05;
+  return {
+    issueType,
+    technicalMetric: "Issue Count",
+    technicalValue: count,
+    aiImpact: {
+      description: impact.ai,
+      scoreImpact: severity === "critical" ? -15 : -5
+    },
+    developerImpact: {
+      description: impact.dev,
+      productivityLoss
+    },
+    businessOutcome: {
+      directCost: count * 12,
+      // Placeholder linear cost
+      opportunityCost: productivityLoss * 15e3,
+      // Monthly avg dev cost $15k
+      riskLevel: impact.risk
+    }
+  };
+}
 
 // src/parsers/typescript-parser.ts
 var import_typescript_estree2 = require("@typescript-eslint/typescript-estree");
@@ -2806,6 +2987,78 @@ function clearHistory(rootDir) {
     (0, import_fs4.writeFileSync)(historyPath, JSON.stringify([]));
   }
 }
+
+// src/utils/history-git.ts
+var import_child_process = require("child_process");
+function getFileCommitTimestamps(file) {
+  const lineStamps = {};
+  try {
+    const output = (0, import_child_process.execSync)(`git blame -t "${file}"`, {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    const lines = output.split("\n");
+    for (const line of lines) {
+      if (!line) continue;
+      const match = line.match(/^\S+\s+\(.*?(\d{10,})\s+[-+]\d+\s+(\d+)\)/);
+      if (match) {
+        const ts = parseInt(match[1], 10);
+        const ln = parseInt(match[2], 10);
+        lineStamps[ln] = ts;
+      }
+    }
+  } catch {
+  }
+  return lineStamps;
+}
+function getLineRangeLastModifiedCached(lineStamps, startLine, endLine) {
+  let latest = 0;
+  for (let i = startLine; i <= endLine; i++) {
+    if (lineStamps[i] && lineStamps[i] > latest) {
+      latest = lineStamps[i];
+    }
+  }
+  return latest;
+}
+function getRepoMetadata(directory) {
+  const metadata = {};
+  try {
+    try {
+      metadata.url = (0, import_child_process.execSync)("git config --get remote.origin.url", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+    try {
+      metadata.branch = (0, import_child_process.execSync)("git rev-parse --abbrev-ref HEAD", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+    try {
+      metadata.commit = (0, import_child_process.execSync)("git rev-parse HEAD", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+    try {
+      metadata.author = (0, import_child_process.execSync)("git log -1 --format=%ae", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+  } catch {
+  }
+  return metadata;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CONTEXT_TIER_THRESHOLDS,
@@ -2821,6 +3074,7 @@ function clearHistory(rootDir) {
   SIZE_ADJUSTED_THRESHOLDS,
   TOOL_NAME_MAP,
   TypeScriptParser,
+  VAGUE_FILE_NAMES,
   calculateAgentGrounding,
   calculateAiSignalClarity,
   calculateChangeAmplification,
@@ -2842,7 +3096,9 @@ function clearHistory(rootDir) {
   calculateSemanticDistance,
   calculateTechnicalDebtInterest,
   calculateTestabilityIndex,
+  calculateTokenBudget,
   clearHistory,
+  estimateCostFromBudget,
   estimateTokens,
   exportHistory,
   extractFunctions,
@@ -2853,10 +3109,13 @@ function clearHistory(rootDir) {
   formatScore,
   formatToolScore,
   generateHTML,
+  generateValueChain,
   getDebtBreakdown,
   getElapsedTime,
+  getFileCommitTimestamps,
   getFileExtension,
   getHistorySummary,
+  getLineRangeLastModifiedCached,
   getModelPreset,
   getParser,
   getProjectSizeTier,
@@ -2864,6 +3123,7 @@ function clearHistory(rootDir) {
   getRatingDisplay,
   getRatingWithContext,
   getRecommendedThreshold,
+  getRepoMetadata,
   getSupportedLanguages,
   getToolWeight,
   handleCLIError,
@@ -2882,5 +3142,6 @@ function clearHistory(rootDir) {
   readFileContent,
   resolveOutputPath,
   saveScoreEntry,
+  scanEntries,
   scanFiles
 });