@aiready/change-amplification 0.1.4 → 0.1.6

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/change-amplification@0.1.4 build /Users/pengcao/projects/aiready/packages/change-amplification
+> @aiready/change-amplification@0.1.6 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
@@ -10,7 +10,7 @@
 CJS Build start
 ESM Build start
 
-[1:03:47 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
+[10:18:49 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
 
     package.json:33:6:
       33 │       "types": "./dist/index.d.ts"
@@ -31,7 +31,7 @@
 
 
 
-[1:03:47 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
+[10:18:49 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
 
     package.json:38:6:
       38 │       "types": "./dist/cli.d.ts"
@@ -52,7 +52,7 @@
 
 
 
-[1:03:47 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
+[10:18:49 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
 
     package.json:33:6:
       33 │       "types": "./dist/index.d.ts"
@@ -73,7 +73,7 @@
 
 
 
-[1:03:47 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
+[10:18:49 PM]  WARN  ▲ [WARNING] The condition "types" here will never be used as it comes after both "import" and "require" [package.json]
 
     package.json:38:6:
       38 │       "types": "./dist/cli.d.ts"
@@ -93,16 +93,16 @@
 
 
 
+CJS dist/cli.js   8.08 KB
+CJS dist/index.js 5.21 KB
+CJS ⚡️ Build success in 145ms
+ESM dist/cli.mjs            2.78 KB
 ESM dist/index.mjs          110.00 B
-ESM dist/cli.mjs            2.72 KB
-ESM dist/chunk-VW57ZQRN.mjs 3.83 KB
-ESM ⚡️ Build success in 66ms
-CJS dist/index.js 5.13 KB
-CJS dist/cli.js   7.94 KB
-CJS ⚡️ Build success in 67ms
+ESM dist/chunk-A5ACPWWO.mjs 3.92 KB
+ESM ⚡️ Build success in 146ms
 DTS Build start
-DTS ⚡️ Build success in 7604ms
+DTS ⚡️ Build success in 4081ms
 DTS dist/cli.d.ts    152.00 B
-DTS dist/index.d.ts  1013.00 B
+DTS dist/index.d.ts  999.00 B
 DTS dist/cli.d.mts   152.00 B
-DTS dist/index.d.mts 1013.00 B
+DTS dist/index.d.mts 999.00 B

package/.turbo/turbo-test.log

@@ -1,16 +1,16 @@
 
 
-> @aiready/change-amplification@0.1.4 test /Users/pengcao/projects/aiready/packages/change-amplification
+> @aiready/change-amplification@0.1.6 test /Users/pengcao/projects/aiready/packages/change-amplification
 > vitest run
 
+[?25l
+ RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/change-amplification
 
- RUN  v1.6.1 /Users/pengcao/projects/aiready/packages/change-amplification
-
- ✓ src/__tests__/dummy.test.ts  (1 test) 9ms
+ ✓ src/__tests__/dummy.test.ts (1 test) 2ms
 
  Test Files  1 passed (1)
       Tests  1 passed (1)
-   Start at  13:04:26
-   Duration  2.33s (transform 367ms, setup 0ms, collect 466ms, tests 9ms, environment 0ms, prepare 541ms)
+   Start at  22:19:16
+   Duration  285ms (transform 44ms, setup 0ms, import 97ms, tests 2ms, environment 0ms)
 
 [?25h

package/README.md

@@ -7,7 +7,7 @@
 
 ## Overview
 
-High architectural coupling is one of the leading causes of AI agent failure. When an agent modifies a "bottleneck" file with dozens of dependents, the resulting cascade of breakages often exceeds the agent's context window or reasoning capacity. 
+High architectural coupling is one of the leading causes of AI agent failure. When an agent modifies a "bottleneck" file with dozens of dependents, the resulting cascade of breakages often exceeds the agent's context window or reasoning capacity.
 
 The **Change Amplification** analyzer computes graph metrics (fan-in, fan-out, and centrality) to identify these high-risk areas before they cause an "edit explosion."
 

package/dist/chunk-A5ACPWWO.mjs

@@ -0,0 +1,114 @@
+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 { globSync } from "glob";
+import { calculateChangeAmplification } from "@aiready/core";
+import { getParser } from "@aiready/core";
+function collectFiles(dir, options) {
+  const includePatterns = options.include && options.include.length > 0 ? options.include : ["**/*.{ts,tsx,js,jsx,py,go}"];
+  const excludePatterns = options.exclude && options.exclude.length > 0 ? options.exclude : ["**/node_modules/**", "**/dist/**", "**/.git/**"];
+  let matchedFiles = [];
+  for (const pattern of includePatterns) {
+    const files = globSync(pattern, {
+      cwd: dir,
+      ignore: excludePatterns,
+      absolute: true
+    });
+    matchedFiles = matchedFiles.concat(files);
+  }
+  return [...new Set(matchedFiles)];
+}
+async function analyzeChangeAmplification(options) {
+  const rootDir = path.resolve(options.rootDir || ".");
+  const files = collectFiles(rootDir, options);
+  const dependencyGraph = /* @__PURE__ */ new Map();
+  const reverseGraph = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    dependencyGraph.set(file, []);
+    reverseGraph.set(file, []);
+  }
+  for (const file of files) {
+    try {
+      const parser = 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);
+      for (const dep of dependencies) {
+        const depDir = path.dirname(file);
+        const resolvedPath = files.find((f) => {
+          if (dep.startsWith(".")) {
+            return f.startsWith(path.resolve(depDir, dep));
+          } else {
+            return f.includes(dep);
+          }
+        });
+        if (resolvedPath) {
+          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 });
+  const results = [];
+  for (const hotspot of riskResult.hotspots) {
+    const issues = [];
+    if (hotspot.amplificationFactor > 20) {
+      issues.push({
+        type: "change-amplification",
+        severity: hotspot.amplificationFactor > 40 ? "critical" : "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) {
+      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) => i.severity === "critical").length,
+        0
+      ),
+      majorIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => i.severity === "major").length,
+        0
+      ),
+      score: riskResult.score,
+      rating: riskResult.rating,
+      recommendations: riskResult.recommendations
+    },
+    results
+  };
+}
+
+export {
+  __require,
+  analyzeChangeAmplification
+};

package/dist/cli.js

@@ -50,7 +50,11 @@ function collectFiles(dir, options) {
   const excludePatterns = options.exclude && options.exclude.length > 0 ? options.exclude : ["**/node_modules/**", "**/dist/**", "**/.git/**"];
   let matchedFiles = [];
   for (const pattern of includePatterns) {
-    const files = (0, import_glob.globSync)(pattern, { cwd: dir, ignore: excludePatterns, absolute: true });
+    const files = (0, import_glob.globSync)(pattern, {
+      cwd: dir,
+      ignore: excludePatterns,
+      absolute: true
+    });
     matchedFiles = matchedFiles.concat(files);
   }
   return [...new Set(matchedFiles)];
@@ -86,6 +90,7 @@ async function analyzeChangeAmplification(options) {
         }
       }
     } catch (err) {
+      void err;
     }
   }
   const fileMetrics = files.map((file) => {
@@ -121,8 +126,14 @@ async function analyzeChangeAmplification(options) {
     summary: {
       totalFiles: files.length,
       totalIssues: results.reduce((sum, r) => sum + r.issues.length, 0),
-      criticalIssues: results.reduce((sum, r) => sum + r.issues.filter((i) => i.severity === "critical").length, 0),
-      majorIssues: results.reduce((sum, r) => sum + r.issues.filter((i) => i.severity === "major").length, 0),
+      criticalIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => i.severity === "critical").length,
+        0
+      ),
+      majorIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => i.severity === "major").length,
+        0
+      ),
       score: riskResult.score,
       rating: riskResult.rating,
       recommendations: riskResult.recommendations
@@ -169,10 +180,17 @@ var changeAmplificationAction = async (directory, options) => {
         }
       }
     } else {
-      console.log(import_chalk.default.green("\n\u2728 No change amplification issues found. Architecture is well contained."));
+      console.log(
+        import_chalk.default.green(
+          "\n\u2728 No change amplification issues found. Architecture is well contained."
+        )
+      );
     }
   } catch (error) {
-    console.error(import_chalk.default.red("Error during change amplification analysis:"), error);
+    console.error(
+      import_chalk.default.red("Error during change amplification analysis:"),
+      error
+    );
     process.exit(1);
   }
 };

package/dist/cli.mjs

@@ -2,7 +2,7 @@
 import {
   __require,
   analyzeChangeAmplification
-} from "./chunk-VW57ZQRN.mjs";
+} from "./chunk-A5ACPWWO.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -46,10 +46,17 @@ var changeAmplificationAction = async (directory, options) => {
         }
       }
     } else {
-      console.log(chalk.green("\n\u2728 No change amplification issues found. Architecture is well contained."));
+      console.log(
+        chalk.green(
+          "\n\u2728 No change amplification issues found. Architecture is well contained."
+        )
+      );
     }
   } catch (error) {
-    console.error(chalk.red("Error during change amplification analysis:"), error);
+    console.error(
+      chalk.red("Error during change amplification analysis:"),
+      error
+    );
     process.exit(1);
   }
 };

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 import { Issue, ScanOptions } from '@aiready/core';
 
-interface ChangeAmplificationOptions extends ScanOptions {
-}
+type ChangeAmplificationOptions = ScanOptions;
 interface ChangeAmplificationIssue extends Issue {
     type: 'change-amplification';
 }

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 import { Issue, ScanOptions } from '@aiready/core';
 
-interface ChangeAmplificationOptions extends ScanOptions {
-}
+type ChangeAmplificationOptions = ScanOptions;
 interface ChangeAmplificationIssue extends Issue {
     type: 'change-amplification';
 }

package/dist/index.js

@@ -45,7 +45,11 @@ function collectFiles(dir, options) {
   const excludePatterns = options.exclude && options.exclude.length > 0 ? options.exclude : ["**/node_modules/**", "**/dist/**", "**/.git/**"];
   let matchedFiles = [];
   for (const pattern of includePatterns) {
-    const files = (0, import_glob.globSync)(pattern, { cwd: dir, ignore: excludePatterns, absolute: true });
+    const files = (0, import_glob.globSync)(pattern, {
+      cwd: dir,
+      ignore: excludePatterns,
+      absolute: true
+    });
     matchedFiles = matchedFiles.concat(files);
   }
   return [...new Set(matchedFiles)];
@@ -81,6 +85,7 @@ async function analyzeChangeAmplification(options) {
         }
       }
     } catch (err) {
+      void err;
     }
   }
   const fileMetrics = files.map((file) => {
@@ -116,8 +121,14 @@ async function analyzeChangeAmplification(options) {
     summary: {
       totalFiles: files.length,
       totalIssues: results.reduce((sum, r) => sum + r.issues.length, 0),
-      criticalIssues: results.reduce((sum, r) => sum + r.issues.filter((i) => i.severity === "critical").length, 0),
-      majorIssues: results.reduce((sum, r) => sum + r.issues.filter((i) => i.severity === "major").length, 0),
+      criticalIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => i.severity === "critical").length,
+        0
+      ),
+      majorIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => i.severity === "major").length,
+        0
+      ),
       score: riskResult.score,
       rating: riskResult.rating,
       recommendations: riskResult.recommendations

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   analyzeChangeAmplification
-} from "./chunk-VW57ZQRN.mjs";
+} from "./chunk-A5ACPWWO.mjs";
 export {
   analyzeChangeAmplification
 };

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@aiready/change-amplification",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "AI-Readiness: Change Amplification Detection",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@typescript-eslint/typescript-estree": "^7.8.0",
-    "commander": "^12.0.0",
-    "glob": "^10.3.12",
+    "@typescript-eslint/typescript-estree": "^8.0.0",
+    "commander": "^14.0.0",
+    "glob": "^13.0.0",
     "chalk": "^5.3.0",
-    "@aiready/core": "0.9.31"
+    "@aiready/core": "0.9.33"
   },
   "devDependencies": {
-    "@types/node": "^20.12.7",
-    "@typescript-eslint/types": "^7.8.0",
+    "@types/node": "^24.0.0",
+    "@typescript-eslint/types": "^8.0.0",
     "tsup": "^8.0.2",
     "typescript": "^5.4.5",
-    "vitest": "^1.6.0"
+    "vitest": "^4.0.0"
   },
   "exports": {
     ".": {

package/src/analyzer.ts

@@ -2,30 +2,48 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { globSync } from 'glob';
 import { calculateChangeAmplification } from '@aiready/core';
-import type { ChangeAmplificationOptions, ChangeAmplificationReport, FileChangeAmplificationResult, ChangeAmplificationIssue } from './types';
+import type {
+  ChangeAmplificationOptions,
+  ChangeAmplificationReport,
+  FileChangeAmplificationResult,
+  ChangeAmplificationIssue,
+} from './types';
 import { getParser } from '@aiready/core';
 
-function collectFiles(dir: string, options: ChangeAmplificationOptions): string[] {
-  const includePatterns = options.include && options.include.length > 0 ? options.include : ['**/*.{ts,tsx,js,jsx,py,go}'];
-  const excludePatterns = options.exclude && options.exclude.length > 0 ? options.exclude : ['**/node_modules/**', '**/dist/**', '**/.git/**'];
+function collectFiles(
+  dir: string,
+  options: ChangeAmplificationOptions
+): string[] {
+  const includePatterns =
+    options.include && options.include.length > 0
+      ? options.include
+      : ['**/*.{ts,tsx,js,jsx,py,go}'];
+  const excludePatterns =
+    options.exclude && options.exclude.length > 0
+      ? options.exclude
+      : ['**/node_modules/**', '**/dist/**', '**/.git/**'];
 
   let matchedFiles: string[] = [];
   for (const pattern of includePatterns) {
-    const files = globSync(pattern, { cwd: dir, ignore: excludePatterns, absolute: true });
+    const files = globSync(pattern, {
+      cwd: dir,
+      ignore: excludePatterns,
+      absolute: true,
+    });
     matchedFiles = matchedFiles.concat(files);
   }
   return [...new Set(matchedFiles)];
 }
 
 export async function analyzeChangeAmplification(
-  options: ChangeAmplificationOptions,
+  options: ChangeAmplificationOptions
 ): Promise<ChangeAmplificationReport> {
   const rootDir = path.resolve(options.rootDir || '.');
   const files = collectFiles(rootDir, options);
 
   // Compute graph metrics: fanIn and fanOut
   const dependencyGraph = new Map<string, string[]>(); // key: file, value: imported files
-  const reverseGraph = new Map<string, string[]>();    // key: file, value: files that import it
+  const reverseGraph = new Map<string, string[]>(); // key: file, value: files that import it
 
   // Initialize graph
   for (const file of files) {
@@ -41,7 +59,7 @@ export async function analyzeChangeAmplification(
 
       const content = fs.readFileSync(file, 'utf8');
       const parseResult = parser.parse(content, file);
-      const dependencies = parseResult.imports.map(i => i.source);
+      const dependencies = parseResult.imports.map((i) => i.source);
 
       for (const dep of dependencies) {
         // Resolve simple relative or absolute imports for the graph
@@ -49,7 +67,7 @@ export async function analyzeChangeAmplification(
         const depDir = path.dirname(file);
 
         // Find if this dependency resolves to one of our mapped files
-        const resolvedPath = files.find(f => {
+        const resolvedPath = files.find((f) => {
           if (dep.startsWith('.')) {
             return f.startsWith(path.resolve(depDir, dep));
           } else {
@@ -63,11 +81,11 @@ export async function analyzeChangeAmplification(
         }
       }
     } catch (err) {
-      // Ignore parse errors silently
+      void err;
     }
   }
 
-  const fileMetrics = files.map(file => {
+  const fileMetrics = files.map((file) => {
     const fanOut = dependencyGraph.get(file)?.length || 0;
     const fanIn = reverseGraph.get(file)?.length || 0;
     return { file, fanOut, fanIn };
@@ -85,7 +103,7 @@ export async function analyzeChangeAmplification(
         severity: hotspot.amplificationFactor > 40 ? 'critical' : '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}.`
+        suggestion: `Reduce coupling. Fan-out is ${hotspot.fanOut}, Fan-in is ${hotspot.fanIn}.`,
       });
     }
 
@@ -96,7 +114,7 @@ export async function analyzeChangeAmplification(
         issues,
         metrics: {
           aiSignalClarityScore: 100 - hotspot.amplificationFactor, // Just a rough score
-        }
+        },
       });
     }
   }
@@ -105,8 +123,15 @@ export async function analyzeChangeAmplification(
     summary: {
       totalFiles: files.length,
       totalIssues: results.reduce((sum, r) => sum + r.issues.length, 0),
-      criticalIssues: results.reduce((sum, r) => sum + r.issues.filter(i => i.severity === 'critical').length, 0),
-      majorIssues: results.reduce((sum, r) => sum + r.issues.filter(i => i.severity === 'major').length, 0),
+      criticalIssues: results.reduce(
+        (sum, r) =>
+          sum + r.issues.filter((i) => i.severity === 'critical').length,
+        0
+      ),
+      majorIssues: results.reduce(
+        (sum, r) => sum + r.issues.filter((i) => i.severity === 'major').length,
+        0
+      ),
       score: riskResult.score,
       rating: riskResult.rating,
       recommendations: riskResult.recommendations,

package/src/cli.ts

@@ -6,7 +6,10 @@ import * as fs from 'fs';
 import { analyzeChangeAmplification } from './analyzer';
 import type { ChangeAmplificationOptions } from './types';
 
-export const changeAmplificationAction = async (directory: string, options: any) => {
+export const changeAmplificationAction = async (
+  directory: string,
+  options: any
+) => {
   try {
     const resolvedDir = path.resolve(process.cwd(), directory);
     const finalOptions: ChangeAmplificationOptions = {
@@ -18,7 +21,8 @@ export const changeAmplificationAction = async (directory: string, options: any)
     const report = await analyzeChangeAmplification(finalOptions);
 
     if (options.output === 'json') {
-      const outputPath = options.outputFile || `change-amplification-report-${Date.now()}.json`;
+      const outputPath =
+        options.outputFile || `change-amplification-report-${Date.now()}.json`;
       fs.writeFileSync(outputPath, JSON.stringify(report, null, 2));
       return;
     }
@@ -41,16 +45,24 @@ export const changeAmplificationAction = async (directory: string, options: any)
       for (const result of report.results) {
         console.log(`\n📄 ${chalk.cyan(result.fileName)}`);
         for (const issue of result.issues) {
-          const color = issue.severity === 'critical' ? chalk.red : chalk.yellow;
+          const color =
+            issue.severity === 'critical' ? chalk.red : chalk.yellow;
           console.log(`  ${color('■')} ${issue.message}`);
           console.log(`    ${chalk.dim('Suggestion: ' + issue.suggestion)}`);
         }
       }
     } else {
-      console.log(chalk.green('\n✨ No change amplification issues found. Architecture is well contained.'));
+      console.log(
+        chalk.green(
+          '\n✨ No change amplification issues found. Architecture is well contained.'
+        )
+      );
     }
   } catch (error) {
-    console.error(chalk.red('Error during change amplification analysis:'), error);
+    console.error(
+      chalk.red('Error during change amplification analysis:'),
+      error
+    );
     process.exit(1);
   }
 };

package/src/types.ts

@@ -1,8 +1,6 @@
 import type { ScanOptions, Issue } from '@aiready/core';
 
-export interface ChangeAmplificationOptions extends ScanOptions {
-  // Add any specific configurations needed for change amplification here
-}
+export type ChangeAmplificationOptions = ScanOptions;
 
 export interface ChangeAmplificationIssue extends Issue {
   type: 'change-amplification';