@aiready/testability 0.1.1

package/dist/cli.js

@@ -0,0 +1,498 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var import_commander = require("commander");
+
+// src/analyzer.ts
+var import_fs = require("fs");
+var import_path = require("path");
+var import_typescript_estree = require("@typescript-eslint/typescript-estree");
+var import_core = require("@aiready/core");
+var SRC_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx"]);
+var DEFAULT_EXCLUDES = ["node_modules", "dist", ".git", "coverage", ".turbo", "build"];
+var TEST_PATTERNS = [
+  /\.(test|spec)\.(ts|tsx|js|jsx)$/,
+  /__tests__\//,
+  /\/tests?\//,
+  /\/e2e\//,
+  /\/fixtures\//
+];
+function isTestFile(filePath, extra) {
+  if (TEST_PATTERNS.some((p) => p.test(filePath))) return true;
+  if (extra) return extra.some((p) => filePath.includes(p));
+  return false;
+}
+function isSourceFile(filePath) {
+  return SRC_EXTENSIONS.has((0, import_path.extname)(filePath));
+}
+function collectFiles(dir, options, depth = 0) {
+  if (depth > (options.maxDepth ?? 20)) return [];
+  const excludes = [...DEFAULT_EXCLUDES, ...options.exclude ?? []];
+  const files = [];
+  let entries;
+  try {
+    entries = (0, import_fs.readdirSync)(dir);
+  } catch {
+    return files;
+  }
+  for (const entry of entries) {
+    if (excludes.some((ex) => entry === ex || entry.includes(ex))) continue;
+    const full = (0, import_path.join)(dir, entry);
+    let stat;
+    try {
+      stat = (0, import_fs.statSync)(full);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      files.push(...collectFiles(full, options, depth + 1));
+    } else if (stat.isFile() && isSourceFile(full)) {
+      if (!options.include || options.include.some((p) => full.includes(p))) {
+        files.push(full);
+      }
+    }
+  }
+  return files;
+}
+function countMethodsInInterface(node) {
+  if (node.type === "TSInterfaceDeclaration") {
+    return node.body.body.filter(
+      (m) => m.type === "TSMethodSignature" || m.type === "TSPropertySignature"
+    ).length;
+  }
+  if (node.type === "TSTypeAliasDeclaration" && node.typeAnnotation.type === "TSTypeLiteral") {
+    return node.typeAnnotation.members.length;
+  }
+  return 0;
+}
+function hasDependencyInjection(node) {
+  for (const member of node.body.body) {
+    if (member.type === "MethodDefinition" && member.key.type === "Identifier" && member.key.name === "constructor") {
+      const fn = member.value;
+      if (fn.params && fn.params.length > 0) {
+        const typedParams = fn.params.filter((p) => {
+          const param = p;
+          return param.typeAnnotation != null || param.parameter?.typeAnnotation != null;
+        });
+        if (typedParams.length > 0) return true;
+      }
+    }
+  }
+  return false;
+}
+function isPureFunction(fn) {
+  let hasReturn = false;
+  let hasSideEffect = false;
+  function walk(node) {
+    if (node.type === "ReturnStatement" && node.argument) hasReturn = true;
+    if (node.type === "AssignmentExpression" && node.left.type === "MemberExpression") hasSideEffect = true;
+    if (node.type === "CallExpression" && node.callee.type === "MemberExpression" && node.callee.object.type === "Identifier" && ["console", "process", "window", "document", "fs"].includes(node.callee.object.name)) hasSideEffect = true;
+    for (const key of Object.keys(node)) {
+      if (key === "parent") continue;
+      const child = node[key];
+      if (child && typeof child === "object") {
+        if (Array.isArray(child)) {
+          child.forEach((c) => c?.type && walk(c));
+        } else if (child.type) {
+          walk(child);
+        }
+      }
+    }
+  }
+  if (fn.body?.type === "BlockStatement") {
+    fn.body.body.forEach((s) => walk(s));
+  } else if (fn.body) {
+    hasReturn = true;
+  }
+  return hasReturn && !hasSideEffect;
+}
+function hasExternalStateMutation(fn) {
+  let found = false;
+  function walk(node) {
+    if (found) return;
+    if (node.type === "AssignmentExpression" && node.left.type === "MemberExpression") found = true;
+    for (const key of Object.keys(node)) {
+      if (key === "parent") continue;
+      const child = node[key];
+      if (child && typeof child === "object") {
+        if (Array.isArray(child)) child.forEach((c) => c?.type && walk(c));
+        else if (child.type) walk(child);
+      }
+    }
+  }
+  if (fn.body?.type === "BlockStatement") fn.body.body.forEach((s) => walk(s));
+  return found;
+}
+function analyzeFileTestability(filePath) {
+  const result = {
+    pureFunctions: 0,
+    totalFunctions: 0,
+    injectionPatterns: 0,
+    totalClasses: 0,
+    bloatedInterfaces: 0,
+    totalInterfaces: 0,
+    externalStateMutations: 0
+  };
+  let code;
+  try {
+    code = (0, import_fs.readFileSync)(filePath, "utf-8");
+  } catch {
+    return result;
+  }
+  let ast;
+  try {
+    ast = (0, import_typescript_estree.parse)(code, {
+      jsx: filePath.endsWith(".tsx") || filePath.endsWith(".jsx"),
+      range: false,
+      loc: false
+    });
+  } catch {
+    return result;
+  }
+  function visit(node) {
+    if (node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression") {
+      result.totalFunctions++;
+      if (isPureFunction(node)) result.pureFunctions++;
+      if (hasExternalStateMutation(node)) result.externalStateMutations++;
+    }
+    if (node.type === "ClassDeclaration" || node.type === "ClassExpression") {
+      result.totalClasses++;
+      if (hasDependencyInjection(node)) result.injectionPatterns++;
+    }
+    if (node.type === "TSInterfaceDeclaration" || node.type === "TSTypeAliasDeclaration") {
+      result.totalInterfaces++;
+      const methodCount = countMethodsInInterface(node);
+      if (methodCount > 10) result.bloatedInterfaces++;
+    }
+    for (const key of Object.keys(node)) {
+      if (key === "parent") continue;
+      const child = node[key];
+      if (child && typeof child === "object") {
+        if (Array.isArray(child)) child.forEach((c) => c?.type && visit(c));
+        else if (child.type) visit(child);
+      }
+    }
+  }
+  ast.body.forEach(visit);
+  return result;
+}
+function detectTestFramework(rootDir) {
+  const pkgPath = (0, import_path.join)(rootDir, "package.json");
+  if (!(0, import_fs.existsSync)(pkgPath)) return false;
+  try {
+    const pkg = JSON.parse((0, import_fs.readFileSync)(pkgPath, "utf-8"));
+    const allDeps = {
+      ...pkg.dependencies ?? {},
+      ...pkg.devDependencies ?? {}
+    };
+    const testFrameworks = ["jest", "vitest", "mocha", "jasmine", "ava", "tap", "pytest", "unittest"];
+    return testFrameworks.some((fw) => allDeps[fw]);
+  } catch {
+    return false;
+  }
+}
+async function analyzeTestability(options) {
+  const allFiles = collectFiles(options.rootDir, options);
+  const sourceFiles = allFiles.filter((f) => !isTestFile(f, options.testPatterns));
+  const testFiles = allFiles.filter((f) => isTestFile(f, options.testPatterns));
+  const aggregated = {
+    pureFunctions: 0,
+    totalFunctions: 0,
+    injectionPatterns: 0,
+    totalClasses: 0,
+    bloatedInterfaces: 0,
+    totalInterfaces: 0,
+    externalStateMutations: 0
+  };
+  for (const f of sourceFiles) {
+    const a = analyzeFileTestability(f);
+    for (const key of Object.keys(aggregated)) {
+      aggregated[key] += a[key];
+    }
+  }
+  const hasTestFramework = detectTestFramework(options.rootDir);
+  const indexResult = (0, import_core.calculateTestabilityIndex)({
+    testFiles: testFiles.length,
+    sourceFiles: sourceFiles.length,
+    pureFunctions: aggregated.pureFunctions,
+    totalFunctions: Math.max(1, aggregated.totalFunctions),
+    injectionPatterns: aggregated.injectionPatterns,
+    totalClasses: Math.max(1, aggregated.totalClasses),
+    bloatedInterfaces: aggregated.bloatedInterfaces,
+    totalInterfaces: Math.max(1, aggregated.totalInterfaces),
+    externalStateMutations: aggregated.externalStateMutations,
+    hasTestFramework
+  });
+  const issues = [];
+  const minCoverage = options.minCoverageRatio ?? 0.3;
+  const actualRatio = sourceFiles.length > 0 ? testFiles.length / sourceFiles.length : 0;
+  if (!hasTestFramework) {
+    issues.push({
+      type: "low-testability",
+      dimension: "framework",
+      severity: "critical",
+      message: "No testing framework detected in package.json \u2014 AI changes cannot be verified at all.",
+      location: { file: options.rootDir, line: 0 },
+      suggestion: "Add Jest, Vitest, or another testing framework as a devDependency."
+    });
+  }
+  if (actualRatio < minCoverage) {
+    const needed = Math.ceil(sourceFiles.length * minCoverage) - testFiles.length;
+    issues.push({
+      type: "low-testability",
+      dimension: "test-coverage",
+      severity: actualRatio === 0 ? "critical" : "major",
+      message: `Test ratio is ${Math.round(actualRatio * 100)}% (${testFiles.length} test files for ${sourceFiles.length} source files). Need at least ${Math.round(minCoverage * 100)}%.`,
+      location: { file: options.rootDir, line: 0 },
+      suggestion: `Add ~${needed} test file(s) to reach the ${Math.round(minCoverage * 100)}% minimum for safe AI assistance.`
+    });
+  }
+  if (indexResult.dimensions.purityScore < 50) {
+    issues.push({
+      type: "low-testability",
+      dimension: "purity",
+      severity: "major",
+      message: `Only ${indexResult.dimensions.purityScore}% of functions are pure \u2014 side-effectful functions require complex test setup.`,
+      location: { file: options.rootDir, line: 0 },
+      suggestion: "Extract pure transformation logic from I/O and mutation code."
+    });
+  }
+  if (indexResult.dimensions.observabilityScore < 50) {
+    issues.push({
+      type: "low-testability",
+      dimension: "observability",
+      severity: "major",
+      message: `Many functions mutate external state directly \u2014 outputs are invisible to unit tests.`,
+      location: { file: options.rootDir, line: 0 },
+      suggestion: "Prefer returning values over mutating shared state."
+    });
+  }
+  return {
+    summary: {
+      sourceFiles: sourceFiles.length,
+      testFiles: testFiles.length,
+      coverageRatio: Math.round(actualRatio * 100) / 100,
+      score: indexResult.score,
+      rating: indexResult.rating,
+      aiChangeSafetyRating: indexResult.aiChangeSafetyRating,
+      dimensions: indexResult.dimensions
+    },
+    issues,
+    rawData: {
+      sourceFiles: sourceFiles.length,
+      testFiles: testFiles.length,
+      ...aggregated,
+      hasTestFramework
+    },
+    recommendations: indexResult.recommendations
+  };
+}
+
+// src/scoring.ts
+function calculateTestabilityScore(report) {
+  const { summary, rawData, recommendations } = report;
+  const factors = [
+    {
+      name: "Test Coverage",
+      impact: Math.round(summary.dimensions.testCoverageRatio - 50),
+      description: `${rawData.testFiles} test files / ${rawData.sourceFiles} source files (${Math.round(summary.coverageRatio * 100)}%)`
+    },
+    {
+      name: "Function Purity",
+      impact: Math.round(summary.dimensions.purityScore - 50),
+      description: `${rawData.pureFunctions}/${rawData.totalFunctions} functions are pure`
+    },
+    {
+      name: "Dependency Injection",
+      impact: Math.round(summary.dimensions.dependencyInjectionScore - 50),
+      description: `${rawData.injectionPatterns}/${rawData.totalClasses} classes use DI`
+    },
+    {
+      name: "Interface Focus",
+      impact: Math.round(summary.dimensions.interfaceFocusScore - 50),
+      description: `${rawData.bloatedInterfaces} interfaces have >10 methods`
+    },
+    {
+      name: "Observability",
+      impact: Math.round(summary.dimensions.observabilityScore - 50),
+      description: `${rawData.externalStateMutations} functions mutate external state`
+    }
+  ];
+  const recs = recommendations.map((action) => ({
+    action,
+    estimatedImpact: summary.aiChangeSafetyRating === "blind-risk" ? 15 : 8,
+    priority: summary.aiChangeSafetyRating === "blind-risk" || summary.aiChangeSafetyRating === "high-risk" ? "high" : "medium"
+  }));
+  return {
+    toolName: "testability",
+    score: summary.score,
+    rawMetrics: {
+      ...rawData,
+      rating: summary.rating,
+      aiChangeSafetyRating: summary.aiChangeSafetyRating,
+      coverageRatio: summary.coverageRatio
+    },
+    factors,
+    recommendations: recs
+  };
+}
+
+// src/cli.ts
+var import_chalk = __toESM(require("chalk"));
+var import_fs2 = require("fs");
+var import_path2 = require("path");
+var import_core2 = require("@aiready/core");
+var program = new import_commander.Command();
+program.name("aiready-testability").description("Measure how safely AI-generated changes can be verified in your codebase").version("0.1.0").addHelpText("after", `
+DIMENSIONS MEASURED:
+  Test Coverage       Ratio of test files to source files
+  Function Purity     Pure functions are trivially AI-testable
+  Dependency Inject.  DI makes classes mockable and verifiable
+  Interface Focus     Small interfaces are easier to mock
+  Observability       Functions returning values > mutating state
+
+AI CHANGE SAFETY RATINGS:
+  safe           \u2705 AI changes can be safely verified (\u226550% coverage + score \u226570)
+  moderate-risk  \u26A0\uFE0F  Some risk \u2014 partial test coverage
+  high-risk      \u{1F534} Tests exist but insufficient \u2014 AI changes may slip through
+  blind-risk     \u{1F480} NO TESTS \u2014 AI changes cannot be verified at all
+
+EXAMPLES:
+  aiready-testability .                        # Full analysis
+  aiready-testability src/ --output json       # JSON report
+  aiready-testability . --min-coverage 0.5     # Stricter 50% threshold
+`).argument("<directory>", "Directory to analyze").option("--min-coverage <ratio>", "Minimum acceptable test/source ratio (default: 0.3)", "0.3").option("--test-patterns <patterns>", "Additional test file patterns (comma-separated)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console|json", "console").option("--output-file <path>", "Output file path (for json)").action(async (directory, options) => {
+  console.log(import_chalk.default.blue("\u{1F9EA} Analyzing testability...\n"));
+  const startTime = Date.now();
+  const config = await (0, import_core2.loadConfig)(directory);
+  const mergedConfig = (0, import_core2.mergeConfigWithDefaults)(config, {
+    minCoverageRatio: 0.3
+  });
+  const finalOptions = {
+    rootDir: directory,
+    minCoverageRatio: parseFloat(options.minCoverage ?? "0.3") || mergedConfig.minCoverageRatio,
+    testPatterns: options.testPatterns?.split(","),
+    include: options.include?.split(","),
+    exclude: options.exclude?.split(",")
+  };
+  const report = await analyzeTestability(finalOptions);
+  const scoring = calculateTestabilityScore(report);
+  const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
+  if (options.output === "json") {
+    const payload = { report, score: scoring };
+    const outputPath = (0, import_core2.resolveOutputPath)(
+      options.outputFile,
+      `testability-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+      directory
+    );
+    const dir = (0, import_path2.dirname)(outputPath);
+    if (!(0, import_fs2.existsSync)(dir)) (0, import_fs2.mkdirSync)(dir, { recursive: true });
+    (0, import_fs2.writeFileSync)(outputPath, JSON.stringify(payload, null, 2));
+    console.log(import_chalk.default.green(`\u2713 Report saved to ${outputPath}`));
+  } else {
+    displayConsoleReport(report, scoring, elapsed);
+  }
+});
+program.parse();
+function safetyColor(rating) {
+  switch (rating) {
+    case "safe":
+      return import_chalk.default.green;
+    case "moderate-risk":
+      return import_chalk.default.yellow;
+    case "high-risk":
+      return import_chalk.default.red;
+    case "blind-risk":
+      return import_chalk.default.bgRed.white;
+    default:
+      return import_chalk.default.white;
+  }
+}
+function safetyIcon(rating) {
+  switch (rating) {
+    case "safe":
+      return "\u2705";
+    case "moderate-risk":
+      return "\u26A0\uFE0F ";
+    case "high-risk":
+      return "\u{1F534}";
+    case "blind-risk":
+      return "\u{1F480}";
+    default:
+      return "\u2753";
+  }
+}
+function scoreBar(val) {
+  return "\u2588".repeat(Math.round(val / 10)).padEnd(10, "\u2591");
+}
+function displayConsoleReport(report, scoring, elapsed) {
+  const { summary, rawData, issues, recommendations } = report;
+  const safetyRating = summary.aiChangeSafetyRating;
+  console.log(import_chalk.default.bold("\n\u{1F9EA} Testability Analysis\n"));
+  if (safetyRating === "blind-risk") {
+    console.log(import_chalk.default.bgRed.white.bold(
+      "  \u{1F480} BLIND RISK \u2014 NO TESTS DETECTED. AI-GENERATED CHANGES CANNOT BE VERIFIED.  "
+    ));
+    console.log();
+  } else if (safetyRating === "high-risk") {
+    console.log(import_chalk.default.red.bold(`  \u{1F534} HIGH RISK \u2014 Insufficient test coverage. AI changes may introduce silent bugs.`));
+    console.log();
+  }
+  console.log(`AI Change Safety: ${safetyColor(safetyRating)(`${safetyIcon(safetyRating)} ${safetyRating.toUpperCase()}`)}`);
+  console.log(`Score:            ${import_chalk.default.bold(summary.score + "/100")} (${summary.rating})`);
+  console.log(`Source Files:     ${import_chalk.default.cyan(rawData.sourceFiles)}   Test Files: ${import_chalk.default.cyan(rawData.testFiles)}`);
+  console.log(`Coverage Ratio:   ${import_chalk.default.bold(Math.round(summary.coverageRatio * 100) + "%")}`);
+  console.log(`Analysis Time:    ${import_chalk.default.gray(elapsed + "s")}
+`);
+  console.log(import_chalk.default.bold("\u{1F4D0} Dimension Scores\n"));
+  const dims = [
+    ["Test Coverage", summary.dimensions.testCoverageRatio],
+    ["Function Purity", summary.dimensions.purityScore],
+    ["Dependency Injection", summary.dimensions.dependencyInjectionScore],
+    ["Interface Focus", summary.dimensions.interfaceFocusScore],
+    ["Observability", summary.dimensions.observabilityScore]
+  ];
+  for (const [name, val] of dims) {
+    const color = val >= 70 ? import_chalk.default.green : val >= 50 ? import_chalk.default.yellow : import_chalk.default.red;
+    console.log(`  ${name.padEnd(22)} ${color(scoreBar(val))} ${val}/100`);
+  }
+  if (issues.length > 0) {
+    console.log(import_chalk.default.bold("\n\u26A0\uFE0F  Issues\n"));
+    for (const issue of issues) {
+      const sev = issue.severity === "critical" ? import_chalk.default.red : issue.severity === "major" ? import_chalk.default.yellow : import_chalk.default.blue;
+      console.log(`${sev(issue.severity.toUpperCase())}  ${issue.message}`);
+      if (issue.suggestion) console.log(`       ${import_chalk.default.dim("\u2192")} ${import_chalk.default.italic(issue.suggestion)}`);
+      console.log();
+    }
+  }
+  if (recommendations.length > 0) {
+    console.log(import_chalk.default.bold("\u{1F4A1} Recommendations\n"));
+    recommendations.forEach((rec, i) => {
+      console.log(`${i + 1}. ${rec}`);
+    });
+  }
+  console.log();
+}

package/dist/cli.mjs

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+import {
+  analyzeTestability,
+  calculateTestabilityScore
+} from "./chunk-CYZ7DTWN.mjs";
+
+// src/cli.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+import { loadConfig, mergeConfigWithDefaults, resolveOutputPath } from "@aiready/core";
+var program = new Command();
+program.name("aiready-testability").description("Measure how safely AI-generated changes can be verified in your codebase").version("0.1.0").addHelpText("after", `
+DIMENSIONS MEASURED:
+  Test Coverage       Ratio of test files to source files
+  Function Purity     Pure functions are trivially AI-testable
+  Dependency Inject.  DI makes classes mockable and verifiable
+  Interface Focus     Small interfaces are easier to mock
+  Observability       Functions returning values > mutating state
+
+AI CHANGE SAFETY RATINGS:
+  safe           \u2705 AI changes can be safely verified (\u226550% coverage + score \u226570)
+  moderate-risk  \u26A0\uFE0F  Some risk \u2014 partial test coverage
+  high-risk      \u{1F534} Tests exist but insufficient \u2014 AI changes may slip through
+  blind-risk     \u{1F480} NO TESTS \u2014 AI changes cannot be verified at all
+
+EXAMPLES:
+  aiready-testability .                        # Full analysis
+  aiready-testability src/ --output json       # JSON report
+  aiready-testability . --min-coverage 0.5     # Stricter 50% threshold
+`).argument("<directory>", "Directory to analyze").option("--min-coverage <ratio>", "Minimum acceptable test/source ratio (default: 0.3)", "0.3").option("--test-patterns <patterns>", "Additional test file patterns (comma-separated)").option("--include <patterns>", "File patterns to include (comma-separated)").option("--exclude <patterns>", "File patterns to exclude (comma-separated)").option("-o, --output <format>", "Output format: console|json", "console").option("--output-file <path>", "Output file path (for json)").action(async (directory, options) => {
+  console.log(chalk.blue("\u{1F9EA} Analyzing testability...\n"));
+  const startTime = Date.now();
+  const config = await loadConfig(directory);
+  const mergedConfig = mergeConfigWithDefaults(config, {
+    minCoverageRatio: 0.3
+  });
+  const finalOptions = {
+    rootDir: directory,
+    minCoverageRatio: parseFloat(options.minCoverage ?? "0.3") || mergedConfig.minCoverageRatio,
+    testPatterns: options.testPatterns?.split(","),
+    include: options.include?.split(","),
+    exclude: options.exclude?.split(",")
+  };
+  const report = await analyzeTestability(finalOptions);
+  const scoring = calculateTestabilityScore(report);
+  const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
+  if (options.output === "json") {
+    const payload = { report, score: scoring };
+    const outputPath = resolveOutputPath(
+      options.outputFile,
+      `testability-report-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.json`,
+      directory
+    );
+    const dir = dirname(outputPath);
+    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+    writeFileSync(outputPath, JSON.stringify(payload, null, 2));
+    console.log(chalk.green(`\u2713 Report saved to ${outputPath}`));
+  } else {
+    displayConsoleReport(report, scoring, elapsed);
+  }
+});
+program.parse();
+function safetyColor(rating) {
+  switch (rating) {
+    case "safe":
+      return chalk.green;
+    case "moderate-risk":
+      return chalk.yellow;
+    case "high-risk":
+      return chalk.red;
+    case "blind-risk":
+      return chalk.bgRed.white;
+    default:
+      return chalk.white;
+  }
+}
+function safetyIcon(rating) {
+  switch (rating) {
+    case "safe":
+      return "\u2705";
+    case "moderate-risk":
+      return "\u26A0\uFE0F ";
+    case "high-risk":
+      return "\u{1F534}";
+    case "blind-risk":
+      return "\u{1F480}";
+    default:
+      return "\u2753";
+  }
+}
+function scoreBar(val) {
+  return "\u2588".repeat(Math.round(val / 10)).padEnd(10, "\u2591");
+}
+function displayConsoleReport(report, scoring, elapsed) {
+  const { summary, rawData, issues, recommendations } = report;
+  const safetyRating = summary.aiChangeSafetyRating;
+  console.log(chalk.bold("\n\u{1F9EA} Testability Analysis\n"));
+  if (safetyRating === "blind-risk") {
+    console.log(chalk.bgRed.white.bold(
+      "  \u{1F480} BLIND RISK \u2014 NO TESTS DETECTED. AI-GENERATED CHANGES CANNOT BE VERIFIED.  "
+    ));
+    console.log();
+  } else if (safetyRating === "high-risk") {
+    console.log(chalk.red.bold(`  \u{1F534} HIGH RISK \u2014 Insufficient test coverage. AI changes may introduce silent bugs.`));
+    console.log();
+  }
+  console.log(`AI Change Safety: ${safetyColor(safetyRating)(`${safetyIcon(safetyRating)} ${safetyRating.toUpperCase()}`)}`);
+  console.log(`Score:            ${chalk.bold(summary.score + "/100")} (${summary.rating})`);
+  console.log(`Source Files:     ${chalk.cyan(rawData.sourceFiles)}   Test Files: ${chalk.cyan(rawData.testFiles)}`);
+  console.log(`Coverage Ratio:   ${chalk.bold(Math.round(summary.coverageRatio * 100) + "%")}`);
+  console.log(`Analysis Time:    ${chalk.gray(elapsed + "s")}
+`);
+  console.log(chalk.bold("\u{1F4D0} Dimension Scores\n"));
+  const dims = [
+    ["Test Coverage", summary.dimensions.testCoverageRatio],
+    ["Function Purity", summary.dimensions.purityScore],
+    ["Dependency Injection", summary.dimensions.dependencyInjectionScore],
+    ["Interface Focus", summary.dimensions.interfaceFocusScore],
+    ["Observability", summary.dimensions.observabilityScore]
+  ];
+  for (const [name, val] of dims) {
+    const color = val >= 70 ? chalk.green : val >= 50 ? chalk.yellow : chalk.red;
+    console.log(`  ${name.padEnd(22)} ${color(scoreBar(val))} ${val}/100`);
+  }
+  if (issues.length > 0) {
+    console.log(chalk.bold("\n\u26A0\uFE0F  Issues\n"));
+    for (const issue of issues) {
+      const sev = issue.severity === "critical" ? chalk.red : issue.severity === "major" ? chalk.yellow : chalk.blue;
+      console.log(`${sev(issue.severity.toUpperCase())}  ${issue.message}`);
+      if (issue.suggestion) console.log(`       ${chalk.dim("\u2192")} ${chalk.italic(issue.suggestion)}`);
+      console.log();
+    }
+  }
+  if (recommendations.length > 0) {
+    console.log(chalk.bold("\u{1F4A1} Recommendations\n"));
+    recommendations.forEach((rec, i) => {
+      console.log(`${i + 1}. ${rec}`);
+    });
+  }
+  console.log();
+}