@aiready/core 0.23.21 → 0.23.22

package/dist/index.mjs

@@ -52,7 +52,7 @@ import {
   getToolWeight,
   normalizeToolName,
   parseWeightString
-} from "./chunk-WVNVC2PP.mjs";
+} from "./chunk-E55RNGGK.mjs";
 import {
   TypeScriptParser
 } from "./chunk-UTCRW3N7.mjs";
@@ -2026,6 +2026,99 @@ function predictAcceptanceRate(toolOutputs) {
   return { rate: Math.round(rate * 100) / 100, confidence, factors };
 }
 
+// src/business-metrics.ts
+function calculateBusinessROI(params) {
+  const model = getModelPreset(params.modelId || "claude-4.6");
+  const devCount = params.developerCount || 5;
+  const budget = calculateTokenBudget({
+    totalContextTokens: params.tokenWaste * 2.5,
+    wastedTokens: {
+      duplication: params.tokenWaste * 0.7,
+      fragmentation: params.tokenWaste * 0.3,
+      chattiness: 0
+    }
+  });
+  const cost = estimateCostFromBudget(budget, model, {
+    developerCount: devCount
+  });
+  const productivity = calculateProductivityImpact(params.issues);
+  const monthlySavings = cost.total;
+  const productivityGainHours = productivity.totalHours;
+  const annualValue = (monthlySavings + productivityGainHours * 75) * 12;
+  return {
+    monthlySavings: Math.round(monthlySavings),
+    productivityGainHours: Math.round(productivityGainHours),
+    annualValue: Math.round(annualValue)
+  };
+}
+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)}%`;
+}
+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,
+      opportunityCost: productivityLoss * 15e3,
+      riskLevel: impact.risk
+    }
+  };
+}
+
 // src/business/risk-metrics.ts
 function calculateKnowledgeConcentration(params) {
   const { uniqueConceptFiles, totalFiles, singleAuthorFiles, orphanFiles } = params;
@@ -2120,99 +2213,6 @@ function calculateComprehensionDifficulty(contextBudget, importDepth, fragmentat
   };
 }
 
-// src/business-metrics.ts
-function calculateBusinessROI(params) {
-  const model = getModelPreset(params.modelId || "claude-4.6");
-  const devCount = params.developerCount || 5;
-  const budget = calculateTokenBudget({
-    totalContextTokens: params.tokenWaste * 2.5,
-    wastedTokens: {
-      duplication: params.tokenWaste * 0.7,
-      fragmentation: params.tokenWaste * 0.3,
-      chattiness: 0
-    }
-  });
-  const cost = estimateCostFromBudget(budget, model, {
-    developerCount: devCount
-  });
-  const productivity = calculateProductivityImpact(params.issues);
-  const monthlySavings = cost.total;
-  const productivityGainHours = productivity.totalHours;
-  const annualValue = (monthlySavings + productivityGainHours * 75) * 12;
-  return {
-    monthlySavings: Math.round(monthlySavings),
-    productivityGainHours: Math.round(productivityGainHours),
-    annualValue: Math.round(annualValue)
-  };
-}
-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)}%`;
-}
-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,
-      opportunityCost: productivityLoss * 15e3,
-      riskLevel: impact.risk
-    }
-  };
-}
-
 // src/metrics/remediation-utils.ts
 function collectFutureProofRecommendations(params) {
   const recommendations = [];
@@ -2279,6 +2279,136 @@ function collectBaseFutureProofRecommendations(params) {
   return recommendations;
 }
 
+// src/future-proof-metrics.ts
+function calculateFutureProofScore(params) {
+  const loadScore = 100 - params.cognitiveLoad.score;
+  const entropyScore = 100 - params.patternEntropy.entropy * 100;
+  const cohesionScore = params.conceptCohesion.score * 100;
+  const overall = Math.round(
+    loadScore * 0.4 + entropyScore * 0.3 + cohesionScore * 0.3
+  );
+  const factors = [
+    {
+      name: "Cognitive Load",
+      impact: Math.round(loadScore - 50),
+      description: params.cognitiveLoad.rating
+    },
+    {
+      name: "Pattern Entropy",
+      impact: Math.round(entropyScore - 50),
+      description: params.patternEntropy.rating
+    },
+    {
+      name: "Concept Cohesion",
+      impact: Math.round(cohesionScore - 50),
+      description: params.conceptCohesion.rating
+    }
+  ];
+  const recommendations = collectBaseFutureProofRecommendations({
+    patternEntropy: params.patternEntropy,
+    conceptCohesion: params.conceptCohesion
+  });
+  const semanticDistanceAvg = params.semanticDistances?.length ? params.semanticDistances.reduce((s, d) => s + d.distance, 0) / params.semanticDistances.length : 0;
+  return {
+    toolName: "future-proof",
+    score: overall,
+    rawMetrics: {
+      cognitiveLoadScore: params.cognitiveLoad.score,
+      entropyScore: params.patternEntropy.entropy,
+      cohesionScore: params.conceptCohesion.score,
+      semanticDistanceAvg
+    },
+    factors,
+    recommendations
+  };
+}
+function calculateExtendedFutureProofScore(params) {
+  const loadScore = 100 - params.cognitiveLoad.score;
+  const entropyScore = 100 - params.patternEntropy.entropy * 100;
+  const cohesionScore = params.conceptCohesion.score * 100;
+  const aiSignalClarityScore = 100 - params.aiSignalClarity.score;
+  const groundingScore = params.agentGrounding.score;
+  const testabilityScore = params.testability.score;
+  const docDriftScore = params.docDrift ? 100 - params.docDrift.score : 100;
+  const depsHealthScore = params.dependencyHealth?.score ?? 100;
+  let totalWeight = 0.8;
+  let overall = loadScore * 0.15 + entropyScore * 0.1 + cohesionScore * 0.1 + aiSignalClarityScore * 0.15 + groundingScore * 0.15 + testabilityScore * 0.15;
+  if (params.docDrift) {
+    overall += docDriftScore * 0.1;
+    totalWeight += 0.1;
+  }
+  if (params.dependencyHealth) {
+    overall += depsHealthScore * 0.1;
+    totalWeight += 0.1;
+  }
+  overall = Math.round(overall / totalWeight);
+  const factors = [
+    {
+      name: "Cognitive Load",
+      impact: Math.round(loadScore - 50),
+      description: params.cognitiveLoad.rating
+    },
+    {
+      name: "Pattern Entropy",
+      impact: Math.round(entropyScore - 50),
+      description: params.patternEntropy.rating
+    },
+    {
+      name: "Concept Cohesion",
+      impact: Math.round(cohesionScore - 50),
+      description: params.conceptCohesion.rating
+    },
+    {
+      name: "AI Signal Clarity",
+      impact: Math.round(aiSignalClarityScore - 50),
+      description: `${params.aiSignalClarity.rating} risk`
+    },
+    {
+      name: "Agent Grounding",
+      impact: Math.round(groundingScore - 50),
+      description: params.agentGrounding.rating
+    },
+    {
+      name: "Testability",
+      impact: Math.round(testabilityScore - 50),
+      description: params.testability.rating
+    }
+  ];
+  if (params.docDrift) {
+    factors.push({
+      name: "Documentation Drift",
+      impact: Math.round(docDriftScore - 50),
+      description: params.docDrift.rating
+    });
+  }
+  if (params.dependencyHealth) {
+    factors.push({
+      name: "Dependency Health",
+      impact: Math.round(depsHealthScore - 50),
+      description: params.dependencyHealth.rating
+    });
+  }
+  const recommendations = collectFutureProofRecommendations(params);
+  const semanticDistanceAvg = params.semanticDistances?.length ? params.semanticDistances.reduce((s, d) => s + d.distance, 0) / params.semanticDistances.length : 0;
+  return {
+    toolName: "future-proof",
+    score: overall,
+    rawMetrics: {
+      cognitiveLoadScore: params.cognitiveLoad.score,
+      entropyScore: params.patternEntropy.entropy,
+      cohesionScore: params.conceptCohesion.score,
+      aiSignalClarityScore: params.aiSignalClarity.score,
+      agentGroundingScore: params.agentGrounding.score,
+      testabilityScore: params.testability.score,
+      docDriftScore: params.docDrift?.score,
+      dependencyHealthScore: params.dependencyHealth?.score,
+      semanticDistanceAvg
+    },
+    factors,
+    recommendations
+  };
+}
+
 // src/metrics/cognitive-load.ts
 function calculateCognitiveLoad(params) {
   const {
@@ -2485,136 +2615,6 @@ function calculateConceptCohesion(params) {
   };
 }
 
-// src/future-proof-metrics.ts
-function calculateFutureProofScore(params) {
-  const loadScore = 100 - params.cognitiveLoad.score;
-  const entropyScore = 100 - params.patternEntropy.entropy * 100;
-  const cohesionScore = params.conceptCohesion.score * 100;
-  const overall = Math.round(
-    loadScore * 0.4 + entropyScore * 0.3 + cohesionScore * 0.3
-  );
-  const factors = [
-    {
-      name: "Cognitive Load",
-      impact: Math.round(loadScore - 50),
-      description: params.cognitiveLoad.rating
-    },
-    {
-      name: "Pattern Entropy",
-      impact: Math.round(entropyScore - 50),
-      description: params.patternEntropy.rating
-    },
-    {
-      name: "Concept Cohesion",
-      impact: Math.round(cohesionScore - 50),
-      description: params.conceptCohesion.rating
-    }
-  ];
-  const recommendations = collectBaseFutureProofRecommendations({
-    patternEntropy: params.patternEntropy,
-    conceptCohesion: params.conceptCohesion
-  });
-  const semanticDistanceAvg = params.semanticDistances?.length ? params.semanticDistances.reduce((s, d) => s + d.distance, 0) / params.semanticDistances.length : 0;
-  return {
-    toolName: "future-proof",
-    score: overall,
-    rawMetrics: {
-      cognitiveLoadScore: params.cognitiveLoad.score,
-      entropyScore: params.patternEntropy.entropy,
-      cohesionScore: params.conceptCohesion.score,
-      semanticDistanceAvg
-    },
-    factors,
-    recommendations
-  };
-}
-function calculateExtendedFutureProofScore(params) {
-  const loadScore = 100 - params.cognitiveLoad.score;
-  const entropyScore = 100 - params.patternEntropy.entropy * 100;
-  const cohesionScore = params.conceptCohesion.score * 100;
-  const aiSignalClarityScore = 100 - params.aiSignalClarity.score;
-  const groundingScore = params.agentGrounding.score;
-  const testabilityScore = params.testability.score;
-  const docDriftScore = params.docDrift ? 100 - params.docDrift.score : 100;
-  const depsHealthScore = params.dependencyHealth?.score ?? 100;
-  let totalWeight = 0.8;
-  let overall = loadScore * 0.15 + entropyScore * 0.1 + cohesionScore * 0.1 + aiSignalClarityScore * 0.15 + groundingScore * 0.15 + testabilityScore * 0.15;
-  if (params.docDrift) {
-    overall += docDriftScore * 0.1;
-    totalWeight += 0.1;
-  }
-  if (params.dependencyHealth) {
-    overall += depsHealthScore * 0.1;
-    totalWeight += 0.1;
-  }
-  overall = Math.round(overall / totalWeight);
-  const factors = [
-    {
-      name: "Cognitive Load",
-      impact: Math.round(loadScore - 50),
-      description: params.cognitiveLoad.rating
-    },
-    {
-      name: "Pattern Entropy",
-      impact: Math.round(entropyScore - 50),
-      description: params.patternEntropy.rating
-    },
-    {
-      name: "Concept Cohesion",
-      impact: Math.round(cohesionScore - 50),
-      description: params.conceptCohesion.rating
-    },
-    {
-      name: "AI Signal Clarity",
-      impact: Math.round(aiSignalClarityScore - 50),
-      description: `${params.aiSignalClarity.rating} risk`
-    },
-    {
-      name: "Agent Grounding",
-      impact: Math.round(groundingScore - 50),
-      description: params.agentGrounding.rating
-    },
-    {
-      name: "Testability",
-      impact: Math.round(testabilityScore - 50),
-      description: params.testability.rating
-    }
-  ];
-  if (params.docDrift) {
-    factors.push({
-      name: "Documentation Drift",
-      impact: Math.round(docDriftScore - 50),
-      description: params.docDrift.rating
-    });
-  }
-  if (params.dependencyHealth) {
-    factors.push({
-      name: "Dependency Health",
-      impact: Math.round(depsHealthScore - 50),
-      description: params.dependencyHealth.rating
-    });
-  }
-  const recommendations = collectFutureProofRecommendations(params);
-  const semanticDistanceAvg = params.semanticDistances?.length ? params.semanticDistances.reduce((s, d) => s + d.distance, 0) / params.semanticDistances.length : 0;
-  return {
-    toolName: "future-proof",
-    score: overall,
-    rawMetrics: {
-      cognitiveLoadScore: params.cognitiveLoad.score,
-      entropyScore: params.patternEntropy.entropy,
-      cohesionScore: params.conceptCohesion.score,
-      aiSignalClarityScore: params.aiSignalClarity.score,
-      agentGroundingScore: params.agentGrounding.score,
-      testabilityScore: params.testability.score,
-      docDriftScore: params.docDrift?.score,
-      dependencyHealthScore: params.dependencyHealth?.score,
-      semanticDistanceAvg
-    },
-    factors,
-    recommendations
-  };
-}
-
 // src/metrics/ai-signal-clarity.ts
 function calculateAiSignalClarity(params) {
   const {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/core",
-  "version": "0.23.21",
+  "version": "0.23.22",
   "description": "Shared utilities for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -12,9 +12,9 @@
       "import": "./dist/index.mjs"
     },
     "./client": {
-      "types": "./dist/client.d.ts",
-      "require": "./dist/client.js",
-      "import": "./dist/client.mjs"
+      "types": "./dist/client/index.d.ts",
+      "require": "./dist/client/index.js",
+      "import": "./dist/client/index.mjs"
     }
   },
   "keywords": [
@@ -57,8 +57,8 @@
     "zod": "^4.3.6"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/client.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts src/client.ts --format cjs,esm --watch",
+    "build": "tsup src/index.ts src/client/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts src/client/index.ts --format cjs,esm --watch",
     "test": "vitest run --hookTimeout=30000",
     "lint": "eslint src",
     "clean": "rm -rf dist",