@aiready/cli 0.14.25 → 0.15.0

package/dist/index.js

@@ -20,11 +20,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ScoringOrchestrator: () => ScoringOrchestrator,
+  TOOL_PACKAGE_MAP: () => TOOL_PACKAGE_MAP,
+  UnifiedOrchestrator: () => UnifiedOrchestrator,
   analyzeUnified: () => analyzeUnified,
   generateUnifiedSummary: () => generateUnifiedSummary,
   scoreUnified: () => scoreUnified
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/orchestrator.ts
 var import_core = require("@aiready/core");
 var TOOL_PACKAGE_MAP = {
   [import_core.ToolName.PatternDetect]: "@aiready/pattern-detect",
@@ -36,6 +41,7 @@ var TOOL_PACKAGE_MAP = {
   [import_core.ToolName.DocDrift]: "@aiready/doc-drift",
   [import_core.ToolName.DependencyHealth]: "@aiready/deps",
   [import_core.ToolName.ChangeAmplification]: "@aiready/change-amplification",
+  [import_core.ToolName.ContractEnforcement]: "@aiready/contract-enforcement",
   // Aliases handled by registry
   patterns: "@aiready/pattern-detect",
   duplicates: "@aiready/pattern-detect",
@@ -46,218 +52,261 @@ var TOOL_PACKAGE_MAP = {
   grounding: "@aiready/agent-grounding",
   testability: "@aiready/testability",
   "deps-health": "@aiready/deps",
-  "change-amp": "@aiready/change-amplification"
+  "change-amp": "@aiready/change-amplification",
+  contract: "@aiready/contract-enforcement"
 };
-function sanitizeConfigRecursive(obj) {
-  if (!obj || typeof obj !== "object" || Array.isArray(obj)) return obj;
-  const sanitized = {};
-  const infraToStrip = [
-    "rootDir",
-    "onProgress",
-    "progressCallback",
-    "streamResults",
-    "batchSize",
-    "useSmartDefaults"
-  ];
-  for (const [key, value] of Object.entries(obj)) {
-    if (infraToStrip.includes(key)) continue;
-    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-      sanitized[key] = sanitizeConfigRecursive(value);
-    } else {
-      sanitized[key] = value;
-    }
+var UnifiedOrchestrator = class {
+  /**
+   * Initialize orchestrator with a tool registry.
+   * Injection pattern helps with testability and AI readiness score.
+   */
+  constructor(registry = import_core.ToolRegistry) {
+    this.registry = registry;
   }
-  return sanitized;
-}
-function sanitizeToolConfig(config) {
-  return sanitizeConfigRecursive(config);
-}
-async function analyzeUnified(options) {
-  await (0, import_core.initializeParsers)();
-  const startTime = Date.now();
-  const requestedTools = options.tools ?? [
-    "patterns",
-    "context",
-    "consistency"
-  ];
-  const result = {
-    summary: {
-      totalIssues: 0,
-      criticalIssues: 0,
-      // Added as per instruction
-      majorIssues: 0,
-      // Added as per instruction
-      totalFiles: 0,
-      toolsRun: [],
-      executionTime: 0,
-      config: options,
-      toolConfigs: {}
+  /**
+   * Deeply sanitizes a configuration object.
+   */
+  sanitizeConfig(obj) {
+    if (!obj || typeof obj !== "object" || Array.isArray(obj)) return obj;
+    const sanitized = {};
+    const infraToStrip = [
+      "rootDir",
+      "onProgress",
+      "progressCallback",
+      "streamResults",
+      "batchSize",
+      "useSmartDefaults"
+    ];
+    for (const [key, value] of Object.entries(obj)) {
+      if (infraToStrip.includes(key)) continue;
+      if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        sanitized[key] = this.sanitizeConfig(value);
+      } else {
+        sanitized[key] = value;
+      }
     }
-  };
-  for (const toolName of requestedTools) {
-    let provider = import_core.ToolRegistry.find(toolName);
-    if (!provider) {
-      const packageName = TOOL_PACKAGE_MAP[toolName] ?? (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
-      try {
-        await import(packageName);
-        provider = import_core.ToolRegistry.find(toolName);
-        if (provider) {
-          console.log(
-            `\u2705 Successfully loaded tool provider: ${toolName} from ${packageName}`
-          );
-        } else {
+    return sanitized;
+  }
+  /**
+   * Performs the unified analysis.
+   */
+  async analyze(options) {
+    await (0, import_core.initializeParsers)();
+    const startTime = Date.now();
+    const requestedTools = options.tools ?? [
+      "patterns",
+      "context",
+      "consistency"
+    ];
+    const result = {
+      summary: {
+        totalIssues: 0,
+        criticalIssues: 0,
+        majorIssues: 0,
+        totalFiles: 0,
+        toolsRun: [],
+        executionTime: 0,
+        config: options,
+        toolConfigs: {}
+      }
+    };
+    for (const toolName of requestedTools) {
+      let provider = this.registry.find(toolName);
+      if (!provider) {
+        const packageName = TOOL_PACKAGE_MAP[toolName] ?? (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
+        try {
+          await import(packageName);
+          provider = this.registry.find(toolName);
+        } catch (err) {
           console.log(
-            `\u26A0\uFE0F Loaded ${packageName} but provider ${toolName} still not found in registry.`
+            `\u274C Failed to dynamically load tool ${toolName} (${packageName}):`,
+            err.message
           );
         }
-      } catch (err) {
-        console.log(
-          `\u274C Failed to dynamically load tool ${toolName} (${packageName}):`,
-          err.message
+      }
+      if (!provider) {
+        console.warn(
+          `\u26A0\uFE0F  Warning: Tool provider for '${toolName}' not found. Skipping.`
         );
+        continue;
       }
-    }
-    if (!provider) {
-      console.warn(
-        `\u26A0\uFE0F  Warning: Tool provider for '${toolName}' not found. Skipping.`
-      );
-      continue;
-    }
-    try {
-      const sanitizedOptions = { ...options };
-      delete sanitizedOptions.onProgress;
-      delete sanitizedOptions.progressCallback;
-      const toolOptions = {
-        rootDir: options.rootDir
-        // Always include rootDir
-      };
-      [...import_core.GLOBAL_INFRA_OPTIONS, ...import_core.COMMON_FINE_TUNING_OPTIONS].forEach(
-        (key) => {
-          if (key in options && key !== "toolConfigs" && key !== "tools") {
-            toolOptions[key] = options[key];
+      try {
+        const toolOptions = {
+          rootDir: options.rootDir
+        };
+        [...import_core.GLOBAL_INFRA_OPTIONS, ...import_core.COMMON_FINE_TUNING_OPTIONS].forEach(
+          (key) => {
+            if (key in options && key !== "toolConfigs" && key !== "tools") {
+              toolOptions[key] = options[key];
+            }
           }
+        );
+        if (options.toolConfigs?.[provider.id]) {
+          Object.assign(toolOptions, options.toolConfigs[provider.id]);
+        } else if (options.tools && !Array.isArray(options.tools) && typeof options.tools === "object" && options.tools[provider.id]) {
+          Object.assign(toolOptions, options.tools[provider.id]);
+        }
+        toolOptions.onProgress = (processed, total, msg) => {
+          if (options.progressCallback) {
+            options.progressCallback({
+              tool: provider.id,
+              processed,
+              total,
+              message: msg
+            });
+          }
+        };
+        const output = await provider.analyze(toolOptions);
+        if (output.metadata) {
+          output.metadata.config = this.sanitizeConfig(toolOptions);
         }
-      );
-      if (options.toolConfigs?.[provider.id]) {
-        Object.assign(toolOptions, options.toolConfigs[provider.id]);
-      } else if (options.tools && !Array.isArray(options.tools) && typeof options.tools === "object" && options.tools[provider.id]) {
-        Object.assign(toolOptions, options.tools[provider.id]);
-      } else if (options[provider.id]) {
-        Object.assign(toolOptions, options[provider.id]);
-      }
-      toolOptions.onProgress = (processed, total, message) => {
         if (options.progressCallback) {
-          options.progressCallback({
-            tool: provider.id,
-            processed,
-            total,
-            message
-          });
+          options.progressCallback({ tool: provider.id, data: output });
         }
-      };
-      const output = await provider.analyze(toolOptions);
-      if (output.metadata) {
-        output.metadata.config = sanitizeToolConfig(toolOptions);
-      }
-      if (options.progressCallback) {
-        options.progressCallback({ tool: provider.id, data: output });
-      }
-      result[provider.id] = output;
-      result.summary.toolsRun.push(provider.id);
-      if (output.summary?.config) {
-        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
-          output.summary.config
-        );
-      } else if (output.metadata?.config) {
-        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(
-          output.metadata.config
+        result[provider.id] = output;
+        result.summary.toolsRun.push(provider.id);
+        const toolConfig = output.summary?.config ?? output.metadata?.config ?? toolOptions;
+        result.summary.toolConfigs[provider.id] = this.sanitizeConfig(toolConfig);
+        const toolFiles = output.summary?.totalFiles ?? output.summary?.filesAnalyzed ?? 0;
+        if (toolFiles > result.summary.totalFiles) {
+          result.summary.totalFiles = toolFiles;
+        }
+        const issueCount = output.results.reduce(
+          (sum, file) => sum + (file.issues?.length ?? 0),
+          0
         );
-      } else {
-        result.summary.toolConfigs[provider.id] = sanitizeToolConfig(toolOptions);
-      }
-      const toolFiles = output.summary?.totalFiles ?? output.summary?.filesAnalyzed ?? 0;
-      if (toolFiles > result.summary.totalFiles) {
-        result.summary.totalFiles = toolFiles;
+        result.summary.totalIssues += issueCount;
+      } catch (err) {
+        console.error(`\u274C Error running tool '${provider.id}':`, err);
       }
-      const issueCount = output.results.reduce(
-        (sum, file) => sum + (file.issues?.length ?? 0),
-        0
-      );
-      result.summary.totalIssues += issueCount;
-    } catch (err) {
-      console.error(`\u274C Error running tool '${provider.id}':`, err);
     }
+    result.summary.config = this.sanitizeConfig({
+      scan: {
+        tools: requestedTools,
+        include: options.include,
+        exclude: options.exclude
+      },
+      tools: result.summary.toolConfigs
+    });
+    result.summary.executionTime = Date.now() - startTime;
+    this.applyLegacyKeys(result);
+    return result;
   }
-  result.summary.config = sanitizeConfigRecursive({
-    scan: {
-      tools: requestedTools,
-      include: options.include,
-      exclude: options.exclude
-    },
-    // Use 'tools' for tool-specific configurations to match AIReadyConfig
-    tools: result.summary.toolConfigs
-  });
-  result.summary.executionTime = Date.now() - startTime;
-  const keyMappings = {
-    "pattern-detect": ["patternDetect", "patterns"],
-    "context-analyzer": ["contextAnalyzer", "context"],
-    "naming-consistency": ["namingConsistency", "consistency"],
-    "ai-signal-clarity": ["aiSignalClarity"],
-    "agent-grounding": ["agentGrounding"],
-    "testability-index": ["testabilityIndex", "testability"],
-    "doc-drift": ["docDrift"],
-    "dependency-health": ["dependencyHealth", "deps"],
-    "change-amplification": ["changeAmplification"]
-  };
-  for (const [kebabKey, aliases] of Object.entries(keyMappings)) {
-    if (result[kebabKey]) {
-      for (const alias of aliases) {
-        result[alias] = result[kebabKey];
+  applyLegacyKeys(result) {
+    const keyMappings = {
+      "pattern-detect": ["patternDetect", "patterns"],
+      "context-analyzer": ["contextAnalyzer", "context"],
+      "naming-consistency": ["namingConsistency", "consistency"],
+      "ai-signal-clarity": ["aiSignalClarity"],
+      "agent-grounding": ["agentGrounding"],
+      "testability-index": ["testabilityIndex", "testability"],
+      "doc-drift": ["docDrift"],
+      "dependency-health": ["dependencyHealth", "deps"],
+      "change-amplification": ["changeAmplification"],
+      "contract-enforcement": ["contractEnforcement", "contract"]
+    };
+    for (const [kebabKey, aliases] of Object.entries(keyMappings)) {
+      if (result[kebabKey]) {
+        for (const alias of aliases) {
+          result[alias] = result[kebabKey];
+        }
       }
     }
   }
-  return result;
+};
+async function analyzeUnified(options) {
+  const orchestrator = new UnifiedOrchestrator(import_core.ToolRegistry);
+  return orchestrator.analyze(options);
 }
-async function scoreUnified(results, options) {
-  const toolScores = /* @__PURE__ */ new Map();
-  for (const toolId of results.summary.toolsRun) {
-    const provider = import_core.ToolRegistry.get(toolId);
-    if (!provider) continue;
-    const output = results[toolId];
-    if (!output) continue;
-    try {
-      const toolScore = provider.score(output, options);
-      if (!toolScore.tokenBudget) {
-        if (toolId === import_core.ToolName.PatternDetect && output.duplicates) {
-          const wastedTokens = output.duplicates.reduce(
-            (sum, d) => sum + (d.tokenCost ?? 0),
-            0
-          );
-          toolScore.tokenBudget = (0, import_core.calculateTokenBudget)({
-            totalContextTokens: wastedTokens * 2,
-            wastedTokens: {
-              duplication: wastedTokens,
-              fragmentation: 0,
-              chattiness: 0
-            }
-          });
-        } else if (toolId === import_core.ToolName.ContextAnalyzer && output.summary) {
-          toolScore.tokenBudget = (0, import_core.calculateTokenBudget)({
-            totalContextTokens: output.summary.totalTokens,
-            wastedTokens: {
-              duplication: 0,
-              fragmentation: output.summary.totalPotentialSavings ?? 0,
-              chattiness: 0
-            }
-          });
+
+// src/scoring-orchestrator.ts
+var import_core2 = require("@aiready/core");
+var ScoringOrchestrator = class {
+  /**
+   * Initialize scoring orchestrator with a tool registry.
+   * Injection pattern helps with testability and AI readiness score.
+   */
+  constructor(registry = import_core2.ToolRegistry) {
+    this.registry = registry;
+  }
+  /**
+   * Calculates scores for all analyzed tools.
+   */
+  async score(results, options) {
+    const toolScores = /* @__PURE__ */ new Map();
+    for (const toolId of results.summary.toolsRun) {
+      const provider = this.registry.get(toolId);
+      if (!provider) continue;
+      const output = results[toolId];
+      if (!output) continue;
+      try {
+        const toolScore = provider.score(output, options);
+        if (!toolScore.tokenBudget) {
+          if (toolId === import_core2.ToolName.PatternDetect && output.duplicates) {
+            const wastedTokens = output.duplicates.reduce(
+              (sum, d) => sum + (d.tokenCost ?? 0),
+              0
+            );
+            toolScore.tokenBudget = (0, import_core2.calculateTokenBudget)({
+              totalContextTokens: wastedTokens * 2,
+              wastedTokens: {
+                duplication: wastedTokens,
+                fragmentation: 0,
+                chattiness: 0
+              }
+            });
+          } else if (toolId === import_core2.ToolName.ContextAnalyzer && output.summary) {
+            toolScore.tokenBudget = (0, import_core2.calculateTokenBudget)({
+              totalContextTokens: output.summary.totalTokens,
+              wastedTokens: {
+                duplication: 0,
+                fragmentation: output.summary.totalPotentialSavings ?? 0,
+                chattiness: 0
+              }
+            });
+          }
         }
+        toolScores.set(toolId, toolScore);
+      } catch (err) {
+        console.error(`\u274C Error scoring tool '${toolId}':`, err);
+      }
+    }
+    if (toolScores.size === 0) {
+      return this.emptyScoringResult();
+    }
+    return (0, import_core2.calculateOverallScore)(toolScores, options, void 0);
+  }
+  /**
+   * Generate human-readable summary of unified results.
+   */
+  generateSummary(result) {
+    const { summary } = result;
+    let output = `\u{1F680} AIReady Analysis Complete
+
+`;
+    output += `\u{1F4CA} Summary:
+`;
+    output += `   Tools run: ${summary.toolsRun.join(", ")}
+`;
+    output += `   Total issues found: ${summary.totalIssues}
+`;
+    output += `   Execution time: ${(summary.executionTime / 1e3).toFixed(2)}s
+
+`;
+    for (const provider of this.registry.getAll()) {
+      const toolResult = result[provider.id];
+      if (toolResult) {
+        const issueCount = toolResult.results.reduce(
+          (sum, r) => sum + (r.issues?.length ?? 0),
+          0
+        );
+        output += `\u2022 ${provider.id}: ${issueCount} issues
+`;
       }
-      toolScores.set(toolId, toolScore);
-    } catch (err) {
-      console.error(`\u274C Error scoring tool '${toolId}':`, err);
     }
+    return output;
   }
-  if (toolScores.size === 0) {
+  emptyScoringResult() {
     return {
       overall: 0,
       rating: "Critical",
@@ -271,37 +320,20 @@ async function scoreUnified(results, options) {
       }
     };
   }
-  return (0, import_core.calculateOverallScore)(toolScores, options, void 0);
+};
+async function scoreUnified(results, options) {
+  const orchestrator = new ScoringOrchestrator(import_core2.ToolRegistry);
+  return orchestrator.score(results, options);
 }
 function generateUnifiedSummary(result) {
-  const { summary } = result;
-  let output = `\u{1F680} AIReady Analysis Complete
-
-`;
-  output += `\u{1F4CA} Summary:
-`;
-  output += `   Tools run: ${summary.toolsRun.join(", ")}
-`;
-  output += `   Total issues found: ${summary.totalIssues}
-`;
-  output += `   Execution time: ${(summary.executionTime / 1e3).toFixed(2)}s
-
-`;
-  for (const provider of import_core.ToolRegistry.getAll()) {
-    const toolResult = result[provider.id];
-    if (toolResult) {
-      const issueCount = toolResult.results.reduce(
-        (sum, r) => sum + (r.issues?.length ?? 0),
-        0
-      );
-      output += `\u2022 ${provider.id}: ${issueCount} issues
-`;
-    }
-  }
-  return output;
+  const orchestrator = new ScoringOrchestrator(import_core2.ToolRegistry);
+  return orchestrator.generateSummary(result);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ScoringOrchestrator,
+  TOOL_PACKAGE_MAP,
+  UnifiedOrchestrator,
   analyzeUnified,
   generateUnifiedSummary,
   scoreUnified

package/dist/index.mjs

@@ -1,9 +1,15 @@
 import {
+  ScoringOrchestrator,
+  TOOL_PACKAGE_MAP,
+  UnifiedOrchestrator,
   analyzeUnified,
   generateUnifiedSummary,
   scoreUnified
-} from "./chunk-HUSUJEQJ.mjs";
+} from "./chunk-HX6H3VOE.mjs";
 export {
+  ScoringOrchestrator,
+  TOOL_PACKAGE_MAP,
+  UnifiedOrchestrator,
   analyzeUnified,
   generateUnifiedSummary,
   scoreUnified

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.14.25",
+  "version": "0.15.0",
   "description": "Assess and improve your codebase's AI-readiness. Get an AI Readiness Score (0-100) and detect semantic duplicates, context fragmentation, and naming inconsistencies.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -24,17 +24,18 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
-    "@aiready/agent-grounding": "0.13.22",
-    "@aiready/consistency": "0.20.22",
-    "@aiready/core": "0.23.23",
-    "@aiready/context-analyzer": "0.21.26",
-    "@aiready/deps": "0.13.23",
-    "@aiready/doc-drift": "0.13.22",
-    "@aiready/change-amplification": "0.13.22",
-    "@aiready/pattern-detect": "0.16.22",
-    "@aiready/ai-signal-clarity": "0.13.23",
-    "@aiready/testability": "0.6.22",
-    "@aiready/visualizer": "0.6.22"
+    "@aiready/agent-grounding": "0.14.0",
+    "@aiready/consistency": "0.21.0",
+    "@aiready/deps": "0.14.0",
+    "@aiready/context-analyzer": "0.22.0",
+    "@aiready/core": "0.24.0",
+    "@aiready/doc-drift": "0.14.0",
+    "@aiready/change-amplification": "0.14.0",
+    "@aiready/contract-enforcement": "0.2.0",
+    "@aiready/ai-signal-clarity": "0.14.0",
+    "@aiready/pattern-detect": "0.17.0",
+    "@aiready/testability": "0.7.0",
+    "@aiready/visualizer": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",