@aiready/change-amplification 0.14.14 → 0.14.16

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/change-amplification@0.14.13 build /Users/pengcao/projects/aiready/packages/change-amplification
+> @aiready/change-amplification@0.14.15 build /Users/pengcao/projects/aiready/packages/change-amplification
 > tsup src/index.ts src/cli.ts --format cjs,esm --dts
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -9,15 +9,15 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-ESM dist/chunk-SPXGOPNW.mjs 4.83 KB
-ESM dist/index.mjs          916.00 B
+CJS dist/index.js 7.53 KB
+CJS dist/cli.js   8.99 KB
+CJS ⚡️ Build success in 43ms
+ESM dist/chunk-KUIEB4UN.mjs 5.32 KB
 ESM dist/cli.mjs            2.41 KB
-ESM ⚡️ Build success in 105ms
-CJS dist/cli.js   8.51 KB
-CJS dist/index.js 7.04 KB
-CJS ⚡️ Build success in 107ms
+ESM dist/index.mjs          916.00 B
+ESM ⚡️ Build success in 48ms
 DTS Build start
-DTS ⚡️ Build success in 5067ms
+DTS ⚡️ Build success in 3155ms
 DTS dist/cli.d.ts    266.00 B
 DTS dist/index.d.ts  937.00 B
 DTS dist/cli.d.mts   266.00 B

package/.turbo/turbo-format-check.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/change-amplification@0.14.13 format-check /Users/pengcao/projects/aiready/packages/change-amplification
+> @aiready/change-amplification@0.14.15 format-check /Users/pengcao/projects/aiready/packages/change-amplification
 > prettier --check . --ignore-path ../../.prettierignore
 
 Checking formatting...

package/.turbo/turbo-lint.log

@@ -1,5 +1,5 @@
 
 
-> @aiready/change-amplification@0.14.13 lint /Users/pengcao/projects/aiready/packages/change-amplification
+> @aiready/change-amplification@0.14.15 lint /Users/pengcao/projects/aiready/packages/change-amplification
 > eslint src --ext .ts
 

package/.turbo/turbo-test.log

@@ -1,24 +1,62 @@
 
 
-> @aiready/change-amplification@0.14.13 test /Users/pengcao/projects/aiready/packages/change-amplification
+> @aiready/change-amplification@0.14.15 test /Users/pengcao/projects/aiready/packages/change-amplification
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/change-amplification
 
- ✓ src/__tests__/dummy.test.ts (1 test) 2ms
- ✓ src/__tests__/cli.test.ts (2 tests) 9ms
+[?2026h
+ ❯ src/__tests__/scoring.test.ts [queued]
+
+ Test Files 0 passed (5)
+      Tests 0 passed (0)
+   Start at 23:35:29
+   Duration 370ms
+[?2026l[?2026h
+ ❯ src/__tests__/analyzer.test.ts [queued]
+ ❯ src/__tests__/cli.test.ts [queued]
+ ❯ src/__tests__/dummy.test.ts 0/1
+ ❯ src/__tests__/provider.test.ts [queued]
+ ❯ src/__tests__/scoring.test.ts [queued]
+
+ Test Files 0 passed (5)
+      Tests 0 passed (1)
+   Start at 23:35:29
+   Duration 474ms
+[?2026l[?2026h ✓ src/__tests__/dummy.test.ts (1 test) 1ms
+
+ ❯ src/__tests__/analyzer.test.ts [queued]
+ ❯ src/__tests__/cli.test.ts [queued]
+ ❯ src/__tests__/provider.test.ts [queued]
+ ❯ src/__tests__/scoring.test.ts [queued]
+
+ Test Files 1 passed (5)
+      Tests 1 passed (1)
+   Start at 23:35:29
+   Duration 908ms
+[?2026l[?2026h
+ ❯ src/__tests__/analyzer.test.ts [queued]
+ ❯ src/__tests__/cli.test.ts 0/2
+ ❯ src/__tests__/provider.test.ts [queued]
+ ❯ src/__tests__/scoring.test.ts [queued]
+
+ Test Files 1 passed (5)
+      Tests 1 passed (3)
+   Start at 23:35:29
+   Duration 1.54s
+[?2026l ✓ src/__tests__/cli.test.ts (2 tests) 4ms
 stdout | src/__tests__/analyzer.test.ts > analyzeChangeAmplification reproduction > should see how it gets to 0
 Resulting score for highly coupled: 27
 Rating: explosive
 
- ✓ src/__tests__/analyzer.test.ts (2 tests) 7ms
- ✓ src/__tests__/provider.test.ts (2 tests) 3ms
+ ✓ src/__tests__/analyzer.test.ts (2 tests) 5ms
+ ✓ src/__tests__/provider.test.ts (2 tests) 4ms
  ✓ src/__tests__/scoring.test.ts (2 tests) 2ms
 
  Test Files  5 passed (5)
       Tests  9 passed (9)
-   Start at  20:52:15
-   Duration  6.14s (transform 4.12s, setup 0ms, import 19.73s, tests 22ms, environment 0ms)
+   Start at  23:35:29
+   Duration  1.65s (transform 1.47s, setup 0ms, import 4.83s, tests 16ms, environment 0ms)
 
 [?25h

package/.turbo/turbo-type-check.log

@@ -1,5 +1,5 @@
 
 
-> @aiready/change-amplification@0.14.13 type-check /Users/pengcao/projects/aiready/packages/change-amplification
+> @aiready/change-amplification@0.14.15 type-check /Users/pengcao/projects/aiready/packages/change-amplification
 > tsc --noEmit
 

package/dist/chunk-BAPK2YBZ.mjs

@@ -0,0 +1,148 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/analyzer.ts
+import * as fs from "fs";
+import * as path from "path";
+import {
+  scanFiles,
+  calculateChangeAmplification,
+  getParser,
+  Severity,
+  IssueType
+} from "@aiready/core";
+async function analyzeChangeAmplification(options) {
+  const files = await scanFiles({
+    ...options,
+    include: options.include || ["**/*.{ts,tsx,js,jsx,py,go}"]
+  });
+  const dependencyGraph = /* @__PURE__ */ new Map();
+  const reverseGraph = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    dependencyGraph.set(file, []);
+    reverseGraph.set(file, []);
+  }
+  let processed = 0;
+  for (const file of files) {
+    processed++;
+    if (processed % 50 === 0 || processed === files.length) {
+      options.onProgress?.(
+        processed,
+        files.length,
+        `analyzing dependencies (${processed}/${files.length})`
+      );
+    }
+    try {
+      const parser = await getParser(file);
+      if (!parser) continue;
+      const content = fs.readFileSync(file, "utf8");
+      const parseResult = parser.parse(content, file);
+      const dependencies = parseResult.imports.map((i) => i.source);
+      const extensions = [".ts", ".tsx", ".js", ".jsx"];
+      for (const dep of dependencies) {
+        const depDir = path.dirname(file);
+        let resolvedPath;
+        if (dep.startsWith(".")) {
+          const absoluteDepBase = path.resolve(depDir, dep);
+          for (const ext of extensions) {
+            const withExt = absoluteDepBase + ext;
+            if (files.includes(withExt)) {
+              resolvedPath = withExt;
+              break;
+            }
+          }
+          if (!resolvedPath) {
+            for (const ext of extensions) {
+              const withIndex = path.join(absoluteDepBase, `index${ext}`);
+              if (files.includes(withIndex)) {
+                resolvedPath = withIndex;
+                break;
+              }
+            }
+          }
+        } else {
+          const depWithoutExt = dep.replace(/\.(ts|tsx|js|jsx)$/, "");
+          resolvedPath = files.find((f) => {
+            const fWithoutExt = f.replace(/\.(ts|tsx|js|jsx)$/, "");
+            return fWithoutExt === depWithoutExt || fWithoutExt.endsWith(`/${depWithoutExt}`);
+          });
+        }
+        if (resolvedPath && resolvedPath !== file) {
+          dependencyGraph.get(file)?.push(resolvedPath);
+          reverseGraph.get(resolvedPath)?.push(file);
+        }
+      }
+    } catch (err) {
+      void err;
+    }
+  }
+  const fileMetrics = files.map((file) => {
+    const fanOut = dependencyGraph.get(file)?.length || 0;
+    const fanIn = reverseGraph.get(file)?.length || 0;
+    return { file, fanOut, fanIn };
+  });
+  const riskResult = calculateChangeAmplification({ files: fileMetrics });
+  let finalScore = riskResult.score;
+  if (finalScore === 0 && files.length > 0 && riskResult.rating !== "explosive") {
+    finalScore = 10;
+  }
+  const results = [];
+  const getLevel = (s) => {
+    if (s === Severity.Critical || s === "critical") return 4;
+    if (s === Severity.Major || s === "major") return 3;
+    if (s === Severity.Minor || s === "minor") return 2;
+    if (s === Severity.Info || s === "info") return 1;
+    return 0;
+  };
+  for (const hotspot of riskResult.hotspots) {
+    const issues = [];
+    const fileName = path.basename(hotspot.file);
+    const isBarrelFile = fileName === "index.ts" || fileName === "index.js" || fileName === "index.tsx" || fileName === "index.jsx" || fileName.startsWith("all-") || fileName.endsWith(".meta.ts") || fileName.endsWith(".meta.js");
+    if (hotspot.amplificationFactor > 20 && !isBarrelFile) {
+      issues.push({
+        type: IssueType.ChangeAmplification,
+        severity: hotspot.amplificationFactor > 40 ? Severity.Critical : Severity.Major,
+        message: `High change amplification detected (Factor: ${hotspot.amplificationFactor}). Changes here cascade heavily.`,
+        location: { file: hotspot.file, line: 1 },
+        suggestion: `Reduce coupling. Fan-out is ${hotspot.fanOut}, Fan-in is ${hotspot.fanIn}.`
+      });
+    }
+    if (hotspot.amplificationFactor > 5 && !isBarrelFile) {
+      results.push({
+        fileName: hotspot.file,
+        issues,
+        metrics: {
+          aiSignalClarityScore: 100 - hotspot.amplificationFactor
+          // Just a rough score
+        }
+      });
+    }
+  }
+  return {
+    summary: {
+      totalFiles: files.length,
+      totalIssues: results.reduce((sum, r) => sum + r.issues.length, 0),
+      criticalIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => getLevel(i.severity) === 4).length,
+        0
+      ),
+      majorIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => getLevel(i.severity) === 3).length,
+        0
+      ),
+      score: finalScore,
+      rating: riskResult.rating,
+      recommendations: riskResult.recommendations
+    },
+    results
+  };
+}
+
+export {
+  __require,
+  analyzeChangeAmplification
+};

package/dist/chunk-KUIEB4UN.mjs

@@ -0,0 +1,148 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/analyzer.ts
+import * as fs from "fs";
+import * as path from "path";
+import {
+  scanFiles,
+  calculateChangeAmplification,
+  getParser,
+  Severity,
+  IssueType
+} from "@aiready/core";
+async function analyzeChangeAmplification(options) {
+  const files = await scanFiles({
+    ...options,
+    include: options.include || ["**/*.{ts,tsx,js,jsx,py,go}"]
+  });
+  const dependencyGraph = /* @__PURE__ */ new Map();
+  const reverseGraph = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    dependencyGraph.set(file, []);
+    reverseGraph.set(file, []);
+  }
+  let processed = 0;
+  for (const file of files) {
+    processed++;
+    if (processed % 50 === 0 || processed === files.length) {
+      options.onProgress?.(
+        processed,
+        files.length,
+        `analyzing dependencies (${processed}/${files.length})`
+      );
+    }
+    try {
+      const parser = await getParser(file);
+      if (!parser) continue;
+      const content = fs.readFileSync(file, "utf8");
+      const parseResult = parser.parse(content, file);
+      const dependencies = parseResult.imports.map((i) => i.source);
+      const extensions = [".ts", ".tsx", ".js", ".jsx"];
+      for (const dep of dependencies) {
+        const depDir = path.dirname(file);
+        let resolvedPath;
+        if (dep.startsWith(".")) {
+          const absoluteDepBase = path.resolve(depDir, dep);
+          for (const ext of extensions) {
+            const withExt = absoluteDepBase + ext;
+            if (files.includes(withExt)) {
+              resolvedPath = withExt;
+              break;
+            }
+          }
+          if (!resolvedPath) {
+            for (const ext of extensions) {
+              const withIndex = path.join(absoluteDepBase, `index${ext}`);
+              if (files.includes(withIndex)) {
+                resolvedPath = withIndex;
+                break;
+              }
+            }
+          }
+        } else {
+          const depWithoutExt = dep.replace(/\.(ts|tsx|js|jsx)$/, "");
+          resolvedPath = files.find((f) => {
+            const fWithoutExt = f.replace(/\.(ts|tsx|js|jsx)$/, "");
+            return fWithoutExt === depWithoutExt || fWithoutExt.endsWith(`/${depWithoutExt}`);
+          });
+        }
+        if (resolvedPath && resolvedPath !== file) {
+          dependencyGraph.get(file)?.push(resolvedPath);
+          reverseGraph.get(resolvedPath)?.push(file);
+        }
+      }
+    } catch (err) {
+      void err;
+    }
+  }
+  const fileMetrics = files.map((file) => {
+    const fanOut = dependencyGraph.get(file)?.length || 0;
+    const fanIn = reverseGraph.get(file)?.length || 0;
+    return { file, fanOut, fanIn };
+  });
+  const riskResult = calculateChangeAmplification({ files: fileMetrics });
+  let finalScore = riskResult.score;
+  if (finalScore === 0 && files.length > 0 && riskResult.rating !== "explosive") {
+    finalScore = 10;
+  }
+  const results = [];
+  const getLevel = (s) => {
+    if (s === Severity.Critical || s === "critical") return 4;
+    if (s === Severity.Major || s === "major") return 3;
+    if (s === Severity.Minor || s === "minor") return 2;
+    if (s === Severity.Info || s === "info") return 1;
+    return 0;
+  };
+  for (const hotspot of riskResult.hotspots) {
+    const issues = [];
+    const fileName = path.basename(hotspot.file).toLowerCase();
+    const isSharedUtility = fileName === "index.ts" || fileName === "index.js" || fileName === "index.tsx" || fileName === "index.jsx" || fileName.includes("logger") || fileName.includes("log.ts") || fileName.includes("constants") || fileName.includes("types.ts") || fileName.includes("enums.ts") || fileName.startsWith("all-") || fileName.endsWith(".meta.ts") || fileName.endsWith(".meta.js");
+    if (hotspot.amplificationFactor > 20 && !isSharedUtility) {
+      issues.push({
+        type: IssueType.ChangeAmplification,
+        severity: hotspot.amplificationFactor > 40 ? Severity.Critical : Severity.Major,
+        message: `High change amplification detected (Factor: ${hotspot.amplificationFactor}). Changes here cascade heavily.`,
+        location: { file: hotspot.file, line: 1 },
+        suggestion: `Reduce coupling. Fan-out is ${hotspot.fanOut}, Fan-in is ${hotspot.fanIn}.`
+      });
+    }
+    if (hotspot.amplificationFactor > 5 && !isSharedUtility) {
+      results.push({
+        fileName: hotspot.file,
+        issues,
+        metrics: {
+          aiSignalClarityScore: 100 - hotspot.amplificationFactor
+          // Just a rough score
+        }
+      });
+    }
+  }
+  return {
+    summary: {
+      totalFiles: files.length,
+      totalIssues: results.reduce((sum, r) => sum + r.issues.length, 0),
+      criticalIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => getLevel(i.severity) === 4).length,
+        0
+      ),
+      majorIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => getLevel(i.severity) === 3).length,
+        0
+      ),
+      score: finalScore,
+      rating: riskResult.rating,
+      recommendations: riskResult.recommendations
+    },
+    results
+  };
+}
+
+export {
+  __require,
+  analyzeChangeAmplification
+};

package/dist/cli.js

@@ -128,7 +128,9 @@ async function analyzeChangeAmplification(options) {
   };
   for (const hotspot of riskResult.hotspots) {
     const issues = [];
-    if (hotspot.amplificationFactor > 20) {
+    const fileName = path.basename(hotspot.file).toLowerCase();
+    const isSharedUtility = fileName === "index.ts" || fileName === "index.js" || fileName === "index.tsx" || fileName === "index.jsx" || fileName.includes("logger") || fileName.includes("log.ts") || fileName.includes("constants") || fileName.includes("types.ts") || fileName.includes("enums.ts") || fileName.startsWith("all-") || fileName.endsWith(".meta.ts") || fileName.endsWith(".meta.js");
+    if (hotspot.amplificationFactor > 20 && !isSharedUtility) {
       issues.push({
         type: import_core.IssueType.ChangeAmplification,
         severity: hotspot.amplificationFactor > 40 ? import_core.Severity.Critical : import_core.Severity.Major,
@@ -137,7 +139,7 @@ async function analyzeChangeAmplification(options) {
         suggestion: `Reduce coupling. Fan-out is ${hotspot.fanOut}, Fan-in is ${hotspot.fanIn}.`
       });
     }
-    if (hotspot.amplificationFactor > 5) {
+    if (hotspot.amplificationFactor > 5 && !isSharedUtility) {
       results.push({
         fileName: hotspot.file,
         issues,

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import {
   __require,
   analyzeChangeAmplification
-} from "./chunk-SPXGOPNW.mjs";
+} from "./chunk-KUIEB4UN.mjs";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/index.js

@@ -128,7 +128,9 @@ async function analyzeChangeAmplification(options) {
   };
   for (const hotspot of riskResult.hotspots) {
     const issues = [];
-    if (hotspot.amplificationFactor > 20) {
+    const fileName = path.basename(hotspot.file).toLowerCase();
+    const isSharedUtility = fileName === "index.ts" || fileName === "index.js" || fileName === "index.tsx" || fileName === "index.jsx" || fileName.includes("logger") || fileName.includes("log.ts") || fileName.includes("constants") || fileName.includes("types.ts") || fileName.includes("enums.ts") || fileName.startsWith("all-") || fileName.endsWith(".meta.ts") || fileName.endsWith(".meta.js");
+    if (hotspot.amplificationFactor > 20 && !isSharedUtility) {
       issues.push({
         type: import_core.IssueType.ChangeAmplification,
         severity: hotspot.amplificationFactor > 40 ? import_core.Severity.Critical : import_core.Severity.Major,
@@ -137,7 +139,7 @@ async function analyzeChangeAmplification(options) {
         suggestion: `Reduce coupling. Fan-out is ${hotspot.fanOut}, Fan-in is ${hotspot.fanIn}.`
       });
     }
-    if (hotspot.amplificationFactor > 5) {
+    if (hotspot.amplificationFactor > 5 && !isSharedUtility) {
       results.push({
         fileName: hotspot.file,
         issues,

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   analyzeChangeAmplification
-} from "./chunk-SPXGOPNW.mjs";
+} from "./chunk-KUIEB4UN.mjs";
 
 // src/index.ts
 import { ToolRegistry } from "@aiready/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/change-amplification",
-  "version": "0.14.14",
+  "version": "0.14.16",
   "description": "AI-Readiness: Change Amplification Detection",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -10,7 +10,7 @@
     "commander": "^14.0.0",
     "glob": "^13.0.0",
     "chalk": "^5.3.0",
-    "@aiready/core": "0.24.15"
+    "@aiready/core": "0.24.19"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -42,6 +42,8 @@
     "test:watch": "vitest",
     "lint": "eslint src --ext .ts",
     "type-check": "tsc --noEmit",
-    "format-check": "prettier --check . --ignore-path ../../.prettierignore"
+    "format-check": "prettier --check . --ignore-path ../../.prettierignore",
+    "format": "prettier --write . --ignore-path ../../.prettierignore",
+    "lint:fix": "eslint . --fix"
   }
 }

package/src/analyzer.ts

@@ -135,7 +135,25 @@ export async function analyzeChangeAmplification(
 
   for (const hotspot of riskResult.hotspots) {
     const issues: ChangeAmplificationIssue[] = [];
-    if (hotspot.amplificationFactor > 20) {
+
+    // Check if this is a barrel/index file or a common utility pattern (intentional re-export or shared use)
+    const fileName = path.basename(hotspot.file).toLowerCase();
+    const isSharedUtility =
+      fileName === 'index.ts' ||
+      fileName === 'index.js' ||
+      fileName === 'index.tsx' ||
+      fileName === 'index.jsx' ||
+      fileName.includes('logger') ||
+      fileName.includes('log.ts') ||
+      fileName.includes('constants') ||
+      fileName.includes('types.ts') ||
+      fileName.includes('enums.ts') ||
+      fileName.startsWith('all-') ||
+      fileName.endsWith('.meta.ts') ||
+      fileName.endsWith('.meta.js');
+
+    // Only flag high amplification if it's NOT a barrel file or shared utility
+    if (hotspot.amplificationFactor > 20 && !isSharedUtility) {
       issues.push({
         type: IssueType.ChangeAmplification,
         severity:
@@ -147,7 +165,8 @@ export async function analyzeChangeAmplification(
     }
 
     // We only push results for files that have either high fan-in or fan-out
-    if (hotspot.amplificationFactor > 5) {
+    // Also exclude barrel files and shared utilities from the results
+    if (hotspot.amplificationFactor > 5 && !isSharedUtility) {
       results.push({
         fileName: hotspot.file,
         issues,