@aiready/testability 0.6.0 → 0.6.2

package/.aiready/aiready-report-20260314-225228.json

@@ -0,0 +1,270 @@
+{
+  "summary": {
+    "totalIssues": 0,
+    "criticalIssues": 0,
+    "majorIssues": 0,
+    "totalFiles": 0,
+    "toolsRun": ["testability-index"],
+    "executionTime": 41,
+    "config": {
+      "scan": {
+        "tools": ["testability-index"]
+      },
+      "tools": {
+        "testability-index": {}
+      }
+    },
+    "toolConfigs": {
+      "testability-index": {}
+    }
+  },
+  "testability-index": {
+    "results": [],
+    "summary": {
+      "score": 47,
+      "sourceFiles": 6,
+      "testFiles": 4,
+      "coverageRatio": 0.67,
+      "rating": "poor",
+      "aiChangeSafetyRating": "high-risk",
+      "dimensions": {
+        "testCoverageRatio": 67,
+        "purityScore": 50,
+        "dependencyInjectionScore": 0,
+        "interfaceFocusScore": 73,
+        "observabilityScore": 50
+      }
+    },
+    "metadata": {
+      "toolName": "testability-index",
+      "version": "0.2.5",
+      "timestamp": "2026-03-14T11:52:28.204Z",
+      "rawData": {
+        "sourceFiles": 6,
+        "testFiles": 4,
+        "pureFunctions": 1,
+        "totalFunctions": 2,
+        "injectionPatterns": 0,
+        "totalClasses": 0,
+        "bloatedInterfaces": 1,
+        "totalInterfaces": 3,
+        "externalStateMutations": 1,
+        "hasTestFramework": true
+      },
+      "config": {}
+    }
+  },
+  "testability": {
+    "results": [],
+    "summary": {
+      "score": 47,
+      "sourceFiles": 6,
+      "testFiles": 4,
+      "coverageRatio": 0.67,
+      "rating": "poor",
+      "aiChangeSafetyRating": "high-risk",
+      "dimensions": {
+        "testCoverageRatio": 67,
+        "purityScore": 50,
+        "dependencyInjectionScore": 0,
+        "interfaceFocusScore": 73,
+        "observabilityScore": 50
+      }
+    },
+    "metadata": {
+      "toolName": "testability-index",
+      "version": "0.2.5",
+      "timestamp": "2026-03-14T11:52:28.204Z",
+      "rawData": {
+        "sourceFiles": 6,
+        "testFiles": 4,
+        "pureFunctions": 1,
+        "totalFunctions": 2,
+        "injectionPatterns": 0,
+        "totalClasses": 0,
+        "bloatedInterfaces": 1,
+        "totalInterfaces": 3,
+        "externalStateMutations": 1,
+        "hasTestFramework": true
+      },
+      "config": {}
+    }
+  },
+  "tests": {
+    "results": [],
+    "summary": {
+      "score": 47,
+      "sourceFiles": 6,
+      "testFiles": 4,
+      "coverageRatio": 0.67,
+      "rating": "poor",
+      "aiChangeSafetyRating": "high-risk",
+      "dimensions": {
+        "testCoverageRatio": 67,
+        "purityScore": 50,
+        "dependencyInjectionScore": 0,
+        "interfaceFocusScore": 73,
+        "observabilityScore": 50
+      }
+    },
+    "metadata": {
+      "toolName": "testability-index",
+      "version": "0.2.5",
+      "timestamp": "2026-03-14T11:52:28.204Z",
+      "rawData": {
+        "sourceFiles": 6,
+        "testFiles": 4,
+        "pureFunctions": 1,
+        "totalFunctions": 2,
+        "injectionPatterns": 0,
+        "totalClasses": 0,
+        "bloatedInterfaces": 1,
+        "totalInterfaces": 3,
+        "externalStateMutations": 1,
+        "hasTestFramework": true
+      },
+      "config": {}
+    }
+  },
+  "verification": {
+    "results": [],
+    "summary": {
+      "score": 47,
+      "sourceFiles": 6,
+      "testFiles": 4,
+      "coverageRatio": 0.67,
+      "rating": "poor",
+      "aiChangeSafetyRating": "high-risk",
+      "dimensions": {
+        "testCoverageRatio": 67,
+        "purityScore": 50,
+        "dependencyInjectionScore": 0,
+        "interfaceFocusScore": 73,
+        "observabilityScore": 50
+      }
+    },
+    "metadata": {
+      "toolName": "testability-index",
+      "version": "0.2.5",
+      "timestamp": "2026-03-14T11:52:28.204Z",
+      "rawData": {
+        "sourceFiles": 6,
+        "testFiles": 4,
+        "pureFunctions": 1,
+        "totalFunctions": 2,
+        "injectionPatterns": 0,
+        "totalClasses": 0,
+        "bloatedInterfaces": 1,
+        "totalInterfaces": 3,
+        "externalStateMutations": 1,
+        "hasTestFramework": true
+      },
+      "config": {}
+    }
+  },
+  "testabilityIndex": {
+    "results": [],
+    "summary": {
+      "score": 47,
+      "sourceFiles": 6,
+      "testFiles": 4,
+      "coverageRatio": 0.67,
+      "rating": "poor",
+      "aiChangeSafetyRating": "high-risk",
+      "dimensions": {
+        "testCoverageRatio": 67,
+        "purityScore": 50,
+        "dependencyInjectionScore": 0,
+        "interfaceFocusScore": 73,
+        "observabilityScore": 50
+      }
+    },
+    "metadata": {
+      "toolName": "testability-index",
+      "version": "0.2.5",
+      "timestamp": "2026-03-14T11:52:28.204Z",
+      "rawData": {
+        "sourceFiles": 6,
+        "testFiles": 4,
+        "pureFunctions": 1,
+        "totalFunctions": 2,
+        "injectionPatterns": 0,
+        "totalClasses": 0,
+        "bloatedInterfaces": 1,
+        "totalInterfaces": 3,
+        "externalStateMutations": 1,
+        "hasTestFramework": true
+      },
+      "config": {}
+    }
+  },
+  "results": [],
+  "scoring": {
+    "overall": 47,
+    "rating": "Needs Work",
+    "timestamp": "2026-03-14T11:52:28.205Z",
+    "toolsUsed": ["testability-index"],
+    "breakdown": [
+      {
+        "toolName": "testability-index",
+        "score": 47,
+        "rawMetrics": {
+          "sourceFiles": 6,
+          "testFiles": 4,
+          "pureFunctions": 1,
+          "totalFunctions": 2,
+          "injectionPatterns": 0,
+          "totalClasses": 0,
+          "bloatedInterfaces": 1,
+          "totalInterfaces": 3,
+          "externalStateMutations": 1,
+          "hasTestFramework": true,
+          "rating": "poor",
+          "aiChangeSafetyRating": "high-risk",
+          "coverageRatio": 0.67
+        },
+        "factors": [
+          {
+            "name": "Test Coverage",
+            "impact": 17,
+            "description": "4 test files / 6 source files (67%)"
+          },
+          {
+            "name": "Function Purity",
+            "impact": 0,
+            "description": "1/2 functions are pure"
+          },
+          {
+            "name": "Dependency Injection",
+            "impact": -50,
+            "description": "0/0 classes use DI"
+          },
+          {
+            "name": "Interface Focus",
+            "impact": 23,
+            "description": "1 interfaces have >10 methods"
+          },
+          {
+            "name": "Observability",
+            "impact": 0,
+            "description": "1 functions mutate external state"
+          }
+        ],
+        "recommendations": []
+      }
+    ],
+    "calculation": {
+      "formula": "[(47 × 10)] / 10 = 47",
+      "weights": {
+        "testability-index": 10
+      },
+      "normalized": "[(47 × 10)] / 10 = 47"
+    }
+  },
+  "repository": {
+    "url": "https://github.com/caopengau/aiready.git",
+    "branch": "main",
+    "commit": "3be4936e1c8aa50d6324b014ca8fcf791c6dcfaf",
+    "author": "caopengau@gmail.com"
+  }
+}

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/testability@0.5.0 build /Users/pengcao/projects/aiready/packages/testability
+> @aiready/testability@0.6.2 build /Users/pengcao/projects/aiready/packages/testability
 > tsup src/index.ts src/cli.ts --format cjs,esm --dts
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -10,15 +10,15 @@
 CJS Build start
 ESM Build start
 CJS dist/cli.js   15.61 KB
-CJS dist/index.js 10.73 KB
-CJS ⚡️ Build success in 73ms
+CJS dist/index.js 10.61 KB
+CJS ⚡️ Build success in 82ms
 ESM dist/cli.mjs            5.75 KB
-ESM dist/index.mjs          1.28 KB
 ESM dist/chunk-QOIBI5E7.mjs 8.31 KB
-ESM ⚡️ Build success in 77ms
+ESM dist/index.mjs          1.17 KB
+ESM ⚡️ Build success in 83ms
 DTS Build start
-DTS ⚡️ Build success in 1201ms
+DTS ⚡️ Build success in 4018ms
 DTS dist/cli.d.ts    20.00 B
-DTS dist/index.d.ts  2.41 KB
+DTS dist/index.d.ts  2.45 KB
 DTS dist/cli.d.mts   20.00 B
-DTS dist/index.d.mts 2.41 KB
+DTS dist/index.d.mts 2.45 KB

package/.turbo/turbo-test.log

@@ -1,19 +1,20 @@
 
 
-> @aiready/testability@0.5.0 test /Users/pengcao/projects/aiready/packages/testability
+> @aiready/testability@0.6.1 test /Users/pengcao/projects/aiready/packages/testability
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/testability
 
- ✓ src/__tests__/scoring.test.ts (3 tests) 2ms
+ ✓ src/__tests__/types.test.ts (4 tests) 7ms
  ✓ src/__tests__/provider.test.ts (2 tests) 3ms
- ✓ src/__tests__/analyzer.test.ts (5 tests) 791ms
-     ✓ detects test frameworks in multiple languages  766ms
+ ✓ src/__tests__/scoring.test.ts (3 tests) 2ms
+ ✓ src/__tests__/analyzer.test.ts (5 tests) 1716ms
+     ✓ detects test frameworks in multiple languages  1688ms
 
- Test Files  3 passed (3)
-      Tests  10 passed (10)
-   Start at  16:14:23
-   Duration  1.47s (transform 581ms, setup 0ms, import 1.46s, tests 796ms, environment 0ms)
+ Test Files  4 passed (4)
+      Tests  14 passed (14)
+   Start at  02:00:17
+   Duration  4.74s (transform 1.12s, setup 0ms, import 6.16s, tests 1.73s, environment 0ms)
 
 [?25h

package/dist/index.d.mts

@@ -1,9 +1,10 @@
-import { ToolProvider, Issue, IssueType, ToolScoringOutput } from '@aiready/core';
+import * as _aiready_core from '@aiready/core';
+import { Issue, IssueType, ToolScoringOutput } from '@aiready/core';
 
 /**
  * Testability Tool Provider
  */
-declare const TestabilityProvider: ToolProvider;
+declare const TestabilityProvider: _aiready_core.ToolProvider;
 
 interface TestabilityOptions {
     /** Root directory to scan */

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { ToolProvider, Issue, IssueType, ToolScoringOutput } from '@aiready/core';
+import * as _aiready_core from '@aiready/core';
+import { Issue, IssueType, ToolScoringOutput } from '@aiready/core';
 
 /**
  * Testability Tool Provider
  */
-declare const TestabilityProvider: ToolProvider;
+declare const TestabilityProvider: _aiready_core.ToolProvider;
 
 interface TestabilityOptions {
     /** Root directory to scan */

package/dist/index.js

@@ -282,39 +282,38 @@ function calculateTestabilityScore(report) {
 }
 
 // src/provider.ts
-var TestabilityProvider = {
+var TestabilityProvider = (0, import_core3.createProvider)({
   id: import_core3.ToolName.TestabilityIndex,
   alias: ["testability", "tests", "verification"],
-  async analyze(options) {
-    const report = await analyzeTestability(options);
-    const results = report.issues.map((i) => ({
-      fileName: i.location.file,
-      issues: [i],
+  version: "0.2.5",
+  defaultWeight: 10,
+  async analyzeReport(options) {
+    return analyzeTestability(options);
+  },
+  getResults(report) {
+    return report.issues.map((issue) => ({
+      fileName: issue.location.file,
+      issues: [issue],
       metrics: {
         testabilityScore: report.summary.score
       }
     }));
-    return import_core3.SpokeOutputSchema.parse({
-      results,
-      summary: report.summary,
-      metadata: {
-        toolName: import_core3.ToolName.TestabilityIndex,
-        version: "0.2.5",
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        rawData: report.rawData
-      }
-    });
   },
-  score(output, options) {
+  getSummary(report) {
+    return report.summary;
+  },
+  getMetadata(report) {
+    return { rawData: report.rawData };
+  },
+  score(output) {
     const report = {
       summary: output.summary,
       rawData: output.metadata.rawData,
       recommendations: output.summary.recommendations || []
     };
     return calculateTestabilityScore(report);
-  },
-  defaultWeight: 10
-};
+  }
+});
 
 // src/index.ts
 import_core4.ToolRegistry.register(TestabilityProvider);

package/dist/index.mjs

@@ -8,42 +8,41 @@ import { ToolRegistry } from "@aiready/core";
 
 // src/provider.ts
 import {
-  ToolName,
-  SpokeOutputSchema
+  createProvider,
+  ToolName
 } from "@aiready/core";
-var TestabilityProvider = {
+var TestabilityProvider = createProvider({
   id: ToolName.TestabilityIndex,
   alias: ["testability", "tests", "verification"],
-  async analyze(options) {
-    const report = await analyzeTestability(options);
-    const results = report.issues.map((i) => ({
-      fileName: i.location.file,
-      issues: [i],
+  version: "0.2.5",
+  defaultWeight: 10,
+  async analyzeReport(options) {
+    return analyzeTestability(options);
+  },
+  getResults(report) {
+    return report.issues.map((issue) => ({
+      fileName: issue.location.file,
+      issues: [issue],
       metrics: {
         testabilityScore: report.summary.score
       }
     }));
-    return SpokeOutputSchema.parse({
-      results,
-      summary: report.summary,
-      metadata: {
-        toolName: ToolName.TestabilityIndex,
-        version: "0.2.5",
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        rawData: report.rawData
-      }
-    });
   },
-  score(output, options) {
+  getSummary(report) {
+    return report.summary;
+  },
+  getMetadata(report) {
+    return { rawData: report.rawData };
+  },
+  score(output) {
     const report = {
       summary: output.summary,
       rawData: output.metadata.rawData,
       recommendations: output.summary.recommendations || []
     };
     return calculateTestabilityScore(report);
-  },
-  defaultWeight: 10
-};
+  }
+});
 
 // src/index.ts
 ToolRegistry.register(TestabilityProvider);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/testability",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Measures how safely and verifiably AI-generated changes can be made to your codebase",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -40,7 +40,7 @@
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
     "glob": "^13.0.0",
-    "@aiready/core": "0.23.0"
+    "@aiready/core": "0.23.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/__tests__/provider.test.ts

@@ -18,7 +18,7 @@ describe('Testability Provider', () => {
     const output = await TestabilityProvider.analyze({ rootDir: '.' });
 
     expect(output.summary.score).toBe(90);
-    expect(output.metadata.toolName).toBe('testability-index');
+    expect(output.metadata!.toolName).toBe('testability-index');
   });
 
   it('should score an output', () => {

package/src/__tests__/types.test.ts

@@ -0,0 +1,72 @@
+import { describe, it, expect } from 'vitest';
+import type { TestabilityOptions, TestabilityReport } from '../types';
+
+describe('Testability Types', () => {
+  describe('TestabilityOptions', () => {
+    it('should allow required rootDir', () => {
+      const options: TestabilityOptions = {
+        rootDir: '/test/project',
+      };
+
+      expect(options.rootDir).toBe('/test/project');
+    });
+
+    it('should allow optional minCoverageRatio', () => {
+      const options: TestabilityOptions = {
+        rootDir: '/test/project',
+        minCoverageRatio: 0.5,
+      };
+
+      expect(options.minCoverageRatio).toBe(0.5);
+    });
+
+    it('should allow custom test patterns', () => {
+      const options: TestabilityOptions = {
+        rootDir: '/test/project',
+        testPatterns: ['**/*.test.ts', '**/*.spec.ts', '**/*.e2e.ts'],
+      };
+
+      expect(options.testPatterns).toHaveLength(3);
+    });
+  });
+
+  describe('TestabilityReport', () => {
+    it('should structure summary correctly', () => {
+      const report: TestabilityReport = {
+        summary: {
+          sourceFiles: 100,
+          testFiles: 30,
+          coverageRatio: 0.3,
+          score: 60,
+          rating: 'moderate',
+          aiChangeSafetyRating: 'moderate-risk',
+          dimensions: {
+            testCoverageRatio: 30,
+            purityScore: 70,
+            dependencyInjectionScore: 50,
+            interfaceFocusScore: 80,
+            observabilityScore: 60,
+          },
+        },
+        issues: [],
+        rawData: {
+          sourceFiles: 100,
+          testFiles: 30,
+          pureFunctions: 80,
+          totalFunctions: 100,
+          injectionPatterns: 5,
+          totalClasses: 20,
+          bloatedInterfaces: 10,
+          totalInterfaces: 50,
+          externalStateMutations: 15,
+          hasTestFramework: true,
+        },
+        recommendations: ['Add more tests to reach 30% coverage'],
+      };
+
+      expect(report.summary.sourceFiles).toBe(100);
+      expect(report.summary.coverageRatio).toBe(0.3);
+      expect(report.rawData.hasTestFramework).toBe(true);
+    });
+  });
+});

package/src/analyzer.ts

@@ -115,7 +115,9 @@ function detectTestFramework(rootDir: string): boolean {
       try {
         const content = readFileSync(p, 'utf-8');
         if (m.deps.some((d) => content.includes(d))) return true;
-      } catch {}
+      } catch {
+        // Ignore file read errors
+      }
     }
   }
   return false;

package/src/provider.ts

@@ -1,11 +1,8 @@
 import {
-  ToolProvider,
+  AnalysisResult,
+  createProvider,
   ToolName,
-  SpokeOutput,
   ScanOptions,
-  ToolScoringOutput,
-  AnalysisResult,
-  SpokeOutputSchema,
 } from '@aiready/core';
 import { analyzeTestability } from './analyzer';
 import { calculateTestabilityScore } from './scoring';
@@ -14,42 +11,35 @@ import { TestabilityOptions, TestabilityReport } from './types';
 /**
  * Testability Tool Provider
  */
-export const TestabilityProvider: ToolProvider = {
+export const TestabilityProvider = createProvider({
   id: ToolName.TestabilityIndex,
   alias: ['testability', 'tests', 'verification'],
-
-  async analyze(options: ScanOptions): Promise<SpokeOutput> {
-    const report = await analyzeTestability(options as TestabilityOptions);
-
-    const results: AnalysisResult[] = report.issues.map((i) => ({
-      fileName: i.location.file,
-      issues: [i] as any[],
+  version: '0.2.5',
+  defaultWeight: 10,
+  async analyzeReport(options: ScanOptions) {
+    return analyzeTestability(options as TestabilityOptions);
+  },
+  getResults(report): AnalysisResult[] {
+    return report.issues.map((issue) => ({
+      fileName: issue.location.file,
+      issues: [issue] as any[],
       metrics: {
         testabilityScore: report.summary.score,
       },
     }));
-
-    return SpokeOutputSchema.parse({
-      results,
-      summary: report.summary,
-      metadata: {
-        toolName: ToolName.TestabilityIndex,
-        version: '0.2.5',
-        timestamp: new Date().toISOString(),
-        rawData: report.rawData,
-      },
-    });
   },
-
-  score(output: SpokeOutput, options: ScanOptions): ToolScoringOutput {
+  getSummary(report) {
+    return report.summary;
+  },
+  getMetadata(report) {
+    return { rawData: report.rawData };
+  },
+  score(output) {
     const report = {
       summary: output.summary,
       rawData: (output.metadata as any).rawData,
       recommendations: (output.summary as any).recommendations || [],
     } as unknown as TestabilityReport;
-
     return calculateTestabilityScore(report);
   },
-
-  defaultWeight: 10,
-};
+});