@aiready/change-amplification 0.11.17 → 0.11.21

package/coverage/sorter.js

@@ -0,0 +1,210 @@
+/* eslint-disable */
+var addSorting = (function() {
+    'use strict';
+    var cols,
+        currentSort = {
+            index: 0,
+            desc: false
+        };
+
+    // returns the summary table element
+    function getTable() {
+        return document.querySelector('.coverage-summary');
+    }
+    // returns the thead element of the summary table
+    function getTableHeader() {
+        return getTable().querySelector('thead tr');
+    }
+    // returns the tbody element of the summary table
+    function getTableBody() {
+        return getTable().querySelector('tbody');
+    }
+    // returns the th element for nth column
+    function getNthColumn(n) {
+        return getTableHeader().querySelectorAll('th')[n];
+    }
+
+    function onFilterInput() {
+        const searchValue = document.getElementById('fileSearch').value;
+        const rows = document.getElementsByTagName('tbody')[0].children;
+
+        // Try to create a RegExp from the searchValue. If it fails (invalid regex),
+        // it will be treated as a plain text search
+        let searchRegex;
+        try {
+            searchRegex = new RegExp(searchValue, 'i'); // 'i' for case-insensitive
+        } catch (error) {
+            searchRegex = null;
+        }
+
+        for (let i = 0; i < rows.length; i++) {
+            const row = rows[i];
+            let isMatch = false;
+
+            if (searchRegex) {
+                // If a valid regex was created, use it for matching
+                isMatch = searchRegex.test(row.textContent);
+            } else {
+                // Otherwise, fall back to the original plain text search
+                isMatch = row.textContent
+                    .toLowerCase()
+                    .includes(searchValue.toLowerCase());
+            }
+
+            row.style.display = isMatch ? '' : 'none';
+        }
+    }
+
+    // loads the search box
+    function addSearchBox() {
+        var template = document.getElementById('filterTemplate');
+        var templateClone = template.content.cloneNode(true);
+        templateClone.getElementById('fileSearch').oninput = onFilterInput;
+        template.parentElement.appendChild(templateClone);
+    }
+
+    // loads all columns
+    function loadColumns() {
+        var colNodes = getTableHeader().querySelectorAll('th'),
+            colNode,
+            cols = [],
+            col,
+            i;
+
+        for (i = 0; i < colNodes.length; i += 1) {
+            colNode = colNodes[i];
+            col = {
+                key: colNode.getAttribute('data-col'),
+                sortable: !colNode.getAttribute('data-nosort'),
+                type: colNode.getAttribute('data-type') || 'string'
+            };
+            cols.push(col);
+            if (col.sortable) {
+                col.defaultDescSort = col.type === 'number';
+                colNode.innerHTML =
+                    colNode.innerHTML + '<span class="sorter"></span>';
+            }
+        }
+        return cols;
+    }
+    // attaches a data attribute to every tr element with an object
+    // of data values keyed by column name
+    function loadRowData(tableRow) {
+        var tableCols = tableRow.querySelectorAll('td'),
+            colNode,
+            col,
+            data = {},
+            i,
+            val;
+        for (i = 0; i < tableCols.length; i += 1) {
+            colNode = tableCols[i];
+            col = cols[i];
+            val = colNode.getAttribute('data-value');
+            if (col.type === 'number') {
+                val = Number(val);
+            }
+            data[col.key] = val;
+        }
+        return data;
+    }
+    // loads all row data
+    function loadData() {
+        var rows = getTableBody().querySelectorAll('tr'),
+            i;
+
+        for (i = 0; i < rows.length; i += 1) {
+            rows[i].data = loadRowData(rows[i]);
+        }
+    }
+    // sorts the table using the data for the ith column
+    function sortByIndex(index, desc) {
+        var key = cols[index].key,
+            sorter = function(a, b) {
+                a = a.data[key];
+                b = b.data[key];
+                return a < b ? -1 : a > b ? 1 : 0;
+            },
+            finalSorter = sorter,
+            tableBody = document.querySelector('.coverage-summary tbody'),
+            rowNodes = tableBody.querySelectorAll('tr'),
+            rows = [],
+            i;
+
+        if (desc) {
+            finalSorter = function(a, b) {
+                return -1 * sorter(a, b);
+            };
+        }
+
+        for (i = 0; i < rowNodes.length; i += 1) {
+            rows.push(rowNodes[i]);
+            tableBody.removeChild(rowNodes[i]);
+        }
+
+        rows.sort(finalSorter);
+
+        for (i = 0; i < rows.length; i += 1) {
+            tableBody.appendChild(rows[i]);
+        }
+    }
+    // removes sort indicators for current column being sorted
+    function removeSortIndicators() {
+        var col = getNthColumn(currentSort.index),
+            cls = col.className;
+
+        cls = cls.replace(/ sorted$/, '').replace(/ sorted-desc$/, '');
+        col.className = cls;
+    }
+    // adds sort indicators for current column being sorted
+    function addSortIndicators() {
+        getNthColumn(currentSort.index).className += currentSort.desc
+            ? ' sorted-desc'
+            : ' sorted';
+    }
+    // adds event listeners for all sorter widgets
+    function enableUI() {
+        var i,
+            el,
+            ithSorter = function ithSorter(i) {
+                var col = cols[i];
+
+                return function() {
+                    var desc = col.defaultDescSort;
+
+                    if (currentSort.index === i) {
+                        desc = !currentSort.desc;
+                    }
+                    sortByIndex(i, desc);
+                    removeSortIndicators();
+                    currentSort.index = i;
+                    currentSort.desc = desc;
+                    addSortIndicators();
+                };
+            };
+        for (i = 0; i < cols.length; i += 1) {
+            if (cols[i].sortable) {
+                // add the click event handler on the th so users
+                // dont have to click on those tiny arrows
+                el = getNthColumn(i).querySelector('.sorter').parentElement;
+                if (el.addEventListener) {
+                    el.addEventListener('click', ithSorter(i));
+                } else {
+                    el.attachEvent('onclick', ithSorter(i));
+                }
+            }
+        }
+    }
+    // adds sorting functionality to the UI
+    return function() {
+        if (!getTable()) {
+            return;
+        }
+        cols = loadColumns();
+        loadData();
+        addSearchBox();
+        addSortIndicators();
+        enableUI();
+    };
+})();
+
+window.addEventListener('load', addSorting);

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ToolProvider, Issue, IssueType, ScanOptions, AnalysisResult } from '@aiready/core';
+import { ToolProvider, Issue, IssueType, ScanOptions, AnalysisResult, ToolScoringOutput } from '@aiready/core';
 
 /**
  * Change Amplification Tool Provider
@@ -27,4 +27,9 @@ interface ChangeAmplificationReport {
 
 declare function analyzeChangeAmplification(options: ChangeAmplificationOptions): Promise<ChangeAmplificationReport>;
 
-export { type ChangeAmplificationIssue, type ChangeAmplificationOptions, ChangeAmplificationProvider, type ChangeAmplificationReport, type FileChangeAmplificationResult, analyzeChangeAmplification };
+/**
+ * Convert change amplification report into a ToolScoringOutput.
+ */
+declare function calculateChangeAmplificationScore(report: ChangeAmplificationReport): ToolScoringOutput;
+
+export { type ChangeAmplificationIssue, type ChangeAmplificationOptions, ChangeAmplificationProvider, type ChangeAmplificationReport, type FileChangeAmplificationResult, analyzeChangeAmplification, calculateChangeAmplificationScore };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ToolProvider, Issue, IssueType, ScanOptions, AnalysisResult } from '@aiready/core';
+import { ToolProvider, Issue, IssueType, ScanOptions, AnalysisResult, ToolScoringOutput } from '@aiready/core';
 
 /**
  * Change Amplification Tool Provider
@@ -27,4 +27,9 @@ interface ChangeAmplificationReport {
 
 declare function analyzeChangeAmplification(options: ChangeAmplificationOptions): Promise<ChangeAmplificationReport>;
 
-export { type ChangeAmplificationIssue, type ChangeAmplificationOptions, ChangeAmplificationProvider, type ChangeAmplificationReport, type FileChangeAmplificationResult, analyzeChangeAmplification };
+/**
+ * Convert change amplification report into a ToolScoringOutput.
+ */
+declare function calculateChangeAmplificationScore(report: ChangeAmplificationReport): ToolScoringOutput;
+
+export { type ChangeAmplificationIssue, type ChangeAmplificationOptions, ChangeAmplificationProvider, type ChangeAmplificationReport, type FileChangeAmplificationResult, analyzeChangeAmplification, calculateChangeAmplificationScore };

package/dist/index.js

@@ -31,10 +31,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ChangeAmplificationProvider: () => ChangeAmplificationProvider,
-  analyzeChangeAmplification: () => analyzeChangeAmplification
+  analyzeChangeAmplification: () => analyzeChangeAmplification,
+  calculateChangeAmplificationScore: () => calculateChangeAmplificationScore
 });
 module.exports = __toCommonJS(index_exports);
-var import_core3 = require("@aiready/core");
+var import_core4 = require("@aiready/core");
 
 // src/provider.ts
 var import_core2 = require("@aiready/core");
@@ -205,10 +206,40 @@ var ChangeAmplificationProvider = {
   defaultWeight: 8
 };
 
+// src/scoring.ts
+var import_core3 = require("@aiready/core");
+function calculateChangeAmplificationScore(report) {
+  const { summary } = report;
+  const factors = [
+    {
+      name: "Graph Stability",
+      impact: Math.round(summary.score - 50),
+      description: summary.score < 30 ? "High coupling detected in core modules" : "Stable dependency structure"
+    }
+  ];
+  const recommendations = summary.recommendations.map((rec) => ({
+    action: rec,
+    estimatedImpact: 10,
+    priority: summary.score < 50 ? "high" : "medium"
+  }));
+  return {
+    toolName: import_core3.ToolName.ChangeAmplification,
+    score: summary.score,
+    rawMetrics: {
+      totalFiles: summary.totalFiles,
+      totalIssues: summary.totalIssues,
+      rating: summary.rating
+    },
+    factors,
+    recommendations
+  };
+}
+
 // src/index.ts
-import_core3.ToolRegistry.register(ChangeAmplificationProvider);
+import_core4.ToolRegistry.register(ChangeAmplificationProvider);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ChangeAmplificationProvider,
-  analyzeChangeAmplification
+  analyzeChangeAmplification,
+  calculateChangeAmplificationScore
 });

package/dist/index.mjs

@@ -46,9 +46,39 @@ var ChangeAmplificationProvider = {
   defaultWeight: 8
 };
 
+// src/scoring.ts
+import { ToolName as ToolName2 } from "@aiready/core";
+function calculateChangeAmplificationScore(report) {
+  const { summary } = report;
+  const factors = [
+    {
+      name: "Graph Stability",
+      impact: Math.round(summary.score - 50),
+      description: summary.score < 30 ? "High coupling detected in core modules" : "Stable dependency structure"
+    }
+  ];
+  const recommendations = summary.recommendations.map((rec) => ({
+    action: rec,
+    estimatedImpact: 10,
+    priority: summary.score < 50 ? "high" : "medium"
+  }));
+  return {
+    toolName: ToolName2.ChangeAmplification,
+    score: summary.score,
+    rawMetrics: {
+      totalFiles: summary.totalFiles,
+      totalIssues: summary.totalIssues,
+      rating: summary.rating
+    },
+    factors,
+    recommendations
+  };
+}
+
 // src/index.ts
 ToolRegistry.register(ChangeAmplificationProvider);
 export {
   ChangeAmplificationProvider,
-  analyzeChangeAmplification
+  analyzeChangeAmplification,
+  calculateChangeAmplificationScore
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/change-amplification",
-  "version": "0.11.17",
+  "version": "0.11.21",
   "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.21.17"
+    "@aiready/core": "0.21.21"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/__tests__/cli.test.ts

@@ -0,0 +1,35 @@
+import { describe, it, expect, vi } from 'vitest';
+import { changeAmplificationAction } from '../cli';
+import * as analyzer from '../analyzer';
+import * as fs from 'fs';
+
+vi.mock('../analyzer', () => ({
+  analyzeChangeAmplification: vi.fn().mockResolvedValue({
+    summary: {
+      score: 100,
+      rating: 'isolated',
+      criticalIssues: 0,
+      majorIssues: 0,
+      recommendations: [],
+    },
+    results: [],
+  }),
+}));
+
+vi.mock('fs', () => ({
+  writeFileSync: vi.fn(),
+}));
+
+describe('Change Amplification CLI', () => {
+  it('should run analysis and return scoring in json mode', async () => {
+    await changeAmplificationAction('.', { output: 'json' });
+    expect(fs.writeFileSync).toHaveBeenCalled();
+  });
+
+  it('should run analysis and print to console in default mode', async () => {
+    const consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => {});
+    await changeAmplificationAction('.', { output: 'console' });
+    expect(consoleSpy).toHaveBeenCalled();
+    consoleSpy.mockRestore();
+  });
+});

package/src/__tests__/provider.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect, vi } from 'vitest';
+import { ChangeAmplificationProvider } from '../provider';
+import * as analyzer from '../analyzer';
+
+vi.mock('../analyzer', () => ({
+  analyzeChangeAmplification: vi.fn(),
+}));
+
+describe('Change Amplification Provider', () => {
+  it('should analyze and return SpokeOutput', async () => {
+    vi.mocked(analyzer.analyzeChangeAmplification).mockResolvedValue({
+      summary: {
+        totalFiles: 1,
+        totalIssues: 0,
+        criticalIssues: 0,
+        majorIssues: 0,
+        score: 90,
+        rating: 'stable',
+        recommendations: [],
+      },
+      results: [],
+    });
+
+    const output = await ChangeAmplificationProvider.analyze({ rootDir: '.' });
+
+    expect(output.summary.totalFiles).toBe(1);
+    expect(output.metadata.toolName).toBe('change-amplification');
+  });
+
+  it('should score an output', () => {
+    const mockOutput = {
+      summary: { score: 85, recommendations: ['Decouple logic'] } as any,
+      results: [],
+    };
+
+    const scoring = ChangeAmplificationProvider.score(mockOutput as any, {
+      rootDir: '.',
+    });
+    expect(scoring.score).toBe(85);
+    expect(scoring.recommendations[0].action).toBe('Decouple logic');
+  });
+});

package/src/__tests__/scoring.test.ts

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { calculateChangeAmplificationScore } from '../scoring';
+import { ChangeAmplificationReport } from '../types';
+import { ToolName } from '@aiready/core';
+
+describe('Change Amplification Scoring', () => {
+  const mockReport: ChangeAmplificationReport = {
+    summary: {
+      totalFiles: 100,
+      totalIssues: 5,
+      criticalIssues: 1,
+      majorIssues: 4,
+      score: 80,
+      rating: 'stable',
+      recommendations: ['Keep it up'],
+    },
+    results: [],
+  };
+
+  it('should map report to ToolScoringOutput correctly', () => {
+    const scoring = calculateChangeAmplificationScore(mockReport);
+
+    expect(scoring.toolName).toBe(ToolName.ChangeAmplification);
+    expect(scoring.score).toBe(80);
+    expect(scoring.factors[0].name).toBe('Graph Stability');
+    expect(scoring.factors[0].impact).toBe(30); // 80 - 50
+  });
+
+  it('should detect instability for low scores', () => {
+    const lowScoreReport: ChangeAmplificationReport = {
+      ...mockReport,
+      summary: {
+        ...mockReport.summary,
+        score: 20,
+        rating: 'explosive',
+      },
+    };
+
+    const scoring = calculateChangeAmplificationScore(lowScoreReport);
+    expect(scoring.factors[0].description).toContain('High coupling');
+    expect(scoring.recommendations[0].priority).toBe('high');
+  });
+});

package/src/index.ts

@@ -5,6 +5,7 @@ import { ChangeAmplificationProvider } from './provider';
 ToolRegistry.register(ChangeAmplificationProvider);
 
 export { analyzeChangeAmplification } from './analyzer';
+export { calculateChangeAmplificationScore } from './scoring';
 export { ChangeAmplificationProvider };
 export type {
   ChangeAmplificationOptions,

package/src/scoring.ts

@@ -0,0 +1,42 @@
+import { ToolName } from '@aiready/core';
+import type { ToolScoringOutput } from '@aiready/core';
+import type { ChangeAmplificationReport } from './types';
+
+/**
+ * Convert change amplification report into a ToolScoringOutput.
+ */
+export function calculateChangeAmplificationScore(
+  report: ChangeAmplificationReport
+): ToolScoringOutput {
+  const { summary } = report;
+
+  const factors: ToolScoringOutput['factors'] = [
+    {
+      name: 'Graph Stability',
+      impact: Math.round(summary.score - 50),
+      description:
+        summary.score < 30
+          ? 'High coupling detected in core modules'
+          : 'Stable dependency structure',
+    },
+  ];
+
+  const recommendations: ToolScoringOutput['recommendations'] =
+    summary.recommendations.map((rec) => ({
+      action: rec,
+      estimatedImpact: 10,
+      priority: summary.score < 50 ? 'high' : 'medium',
+    }));
+
+  return {
+    toolName: ToolName.ChangeAmplification,
+    score: summary.score,
+    rawMetrics: {
+      totalFiles: summary.totalFiles,
+      totalIssues: summary.totalIssues,
+      rating: summary.rating,
+    },
+    factors,
+    recommendations,
+  };
+}