@aiready/core 0.9.33 → 0.9.37

package/dist/index.mjs

@@ -24,7 +24,7 @@ import {
 import { glob } from "glob";
 import { readFile } from "fs/promises";
 import { existsSync } from "fs";
-import { join, relative } from "path";
+import { join, relative, dirname } from "path";
 import ignorePkg from "ignore";
 var DEFAULT_EXCLUDE = [
   // Dependencies
@@ -40,6 +40,8 @@ var DEFAULT_EXCLUDE = [
   "**/cdk.out/**",
   // Framework-specific build dirs
   "**/.next/**",
+  "**/.sst/**",
+  "**/.open-next/**",
   "**/.nuxt/**",
   "**/.vuepress/**",
   "**/.cache/**",
@@ -71,6 +73,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,
@@ -88,20 +112,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 glob(include, {
     cwd: rootDir,
     ignore: finalExclude,
     absolute: true
   });
-  const gitignorePath = join(rootDir || ".", ".gitignore");
-  if (existsSync(gitignorePath)) {
+  const gitignoreFiles = await glob("**/.gitignore", {
+    cwd: rootDir,
+    ignore: finalExclude,
+    absolute: true
+  });
+  if (gitignoreFiles.length > 0) {
     try {
-      const gitTxt = await readFile(gitignorePath, "utf-8");
       const ig = ignorePkg();
-      ig.add(gitTxt);
+      for (const gitignorePath of gitignoreFiles) {
+        const gitTxt = await readFile(gitignorePath, "utf-8");
+        const gitignoreDir = dirname(gitignorePath);
+        const relativePrefix = 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 = relative(rootDir || ".", f).replace(/\\/g, "/");
         if (rel === "") rel = f;
@@ -114,6 +153,54 @@ async function scanFiles(options) {
   }
   return files;
 }
+async function scanEntries(options) {
+  const files = await scanFiles(options);
+  const { rootDir, include = ["**/*"], exclude, includeTests } = options;
+  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 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 glob("**/", {
+    cwd: rootDir,
+    ignore: finalExclude,
+    absolute: true
+  });
+  const gitignoreFiles = await glob("**/.gitignore", {
+    cwd: rootDir,
+    ignore: finalExclude,
+    absolute: true
+  });
+  if (gitignoreFiles.length > 0) {
+    const ig = ignorePkg();
+    for (const gitignorePath of gitignoreFiles) {
+      const gitTxt = await readFile(gitignorePath, "utf-8");
+      const gitignoreDir = dirname(gitignorePath);
+      const relativePrefix = 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 = 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 readFile(filePath, "utf-8");
 }
@@ -306,7 +393,7 @@ function estimateTokens(text) {
 
 // src/utils/config.ts
 import { readFileSync, existsSync as existsSync2 } from "fs";
-import { join as join2, resolve, dirname } from "path";
+import { join as join2, resolve, dirname as dirname2 } from "path";
 import { pathToFileURL } from "url";
 var CONFIG_FILES = [
   "aiready.json",
@@ -338,13 +425,18 @@ 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;
         }
       }
     }
-    const parent = dirname(currentDir);
+    const parent = dirname2(currentDir);
     if (parent === currentDir) {
       break;
     }
@@ -377,7 +469,7 @@ function mergeConfigWithDefaults(userConfig, defaults) {
 
 // src/utils/cli-helpers.ts
 import { writeFileSync, mkdirSync, existsSync as existsSync3 } from "fs";
-import { join as join3, dirname as dirname2 } from "path";
+import { join as join3, dirname as dirname3 } from "path";
 function resolveOutputPath(userPath, defaultFilename, workingDir = process.cwd()) {
   let outputPath;
   if (userPath) {
@@ -386,7 +478,7 @@ function resolveOutputPath(userPath, defaultFilename, workingDir = process.cwd()
     const aireadyDir = join3(workingDir, ".aiready");
     outputPath = join3(aireadyDir, defaultFilename);
   }
-  const parentDir = dirname2(outputPath);
+  const parentDir = dirname3(outputPath);
   if (!existsSync3(parentDir)) {
     mkdirSync(parentDir, { recursive: true });
   }
@@ -404,7 +496,7 @@ async function loadMergedConfig(directory, defaults, cliOptions) {
 }
 function handleJSONOutput(data, outputFile, successMessage) {
   if (outputFile) {
-    const dir = dirname2(outputFile);
+    const dir = dirname3(outputFile);
     if (!existsSync3(dir)) {
       mkdirSync(dir, { recursive: true });
     }
@@ -424,80 +516,65 @@ function getElapsedTime(startTime) {
 
 // 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,
@@ -510,21 +587,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 = {
@@ -907,6 +1034,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
 import { parse as parse2 } from "@typescript-eslint/typescript-estree";
@@ -2258,7 +2431,7 @@ function calculateExtendedFutureProofScore(params) {
 
 // src/utils/history.ts
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync4, mkdirSync as mkdirSync2 } from "fs";
-import { join as join4, dirname as dirname3 } from "path";
+import { join as join4, dirname as dirname4 } from "path";
 function getHistoryPath(rootDir) {
   return join4(rootDir, ".aiready", "history.json");
 }
@@ -2277,7 +2450,7 @@ function loadScoreHistory(rootDir) {
 }
 function saveScoreEntry(rootDir, entry) {
   const historyPath = getHistoryPath(rootDir);
-  const historyDir = dirname3(historyPath);
+  const historyDir = dirname4(historyPath);
   if (!existsSync4(historyDir)) {
     mkdirSync2(historyDir, { recursive: true });
   }
@@ -2329,6 +2502,78 @@ function clearHistory(rootDir) {
     writeFileSync2(historyPath, JSON.stringify([]));
   }
 }
+
+// src/utils/history-git.ts
+import { execSync } from "child_process";
+function getFileCommitTimestamps(file) {
+  const lineStamps = {};
+  try {
+    const output = 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 = execSync("git config --get remote.origin.url", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+    try {
+      metadata.branch = execSync("git rev-parse --abbrev-ref HEAD", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+    try {
+      metadata.commit = execSync("git rev-parse HEAD", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+    try {
+      metadata.author = execSync("git log -1 --format=%ae", {
+        cwd: directory,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }).trim();
+    } catch {
+    }
+  } catch {
+  }
+  return metadata;
+}
 export {
   CONTEXT_TIER_THRESHOLDS,
   DEFAULT_COST_CONFIG,
@@ -2343,6 +2588,7 @@ export {
   SIZE_ADJUSTED_THRESHOLDS,
   TOOL_NAME_MAP,
   TypeScriptParser,
+  VAGUE_FILE_NAMES,
   calculateAgentGrounding,
   calculateAiSignalClarity,
   calculateChangeAmplification,
@@ -2364,7 +2610,9 @@ export {
   calculateSemanticDistance,
   calculateTechnicalDebtInterest,
   calculateTestabilityIndex,
+  calculateTokenBudget,
   clearHistory,
+  estimateCostFromBudget,
   estimateTokens,
   exportHistory,
   extractFunctions,
@@ -2375,10 +2623,13 @@ export {
   formatScore,
   formatToolScore,
   generateHTML,
+  generateValueChain,
   getDebtBreakdown,
   getElapsedTime,
+  getFileCommitTimestamps,
   getFileExtension,
   getHistorySummary,
+  getLineRangeLastModifiedCached,
   getModelPreset,
   getParser,
   getProjectSizeTier,
@@ -2386,6 +2637,7 @@ export {
   getRatingDisplay,
   getRatingWithContext,
   getRecommendedThreshold,
+  getRepoMetadata,
   getSupportedLanguages,
   getToolWeight,
   handleCLIError,
@@ -2404,5 +2656,6 @@ export {
   readFileContent,
   resolveOutputPath,
   saveScoreEntry,
+  scanEntries,
   scanFiles
 };

package/package.json

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