@aiready/cli 0.12.11 → 0.12.14

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.12.10 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.12.13 build /Users/pengcao/projects/aiready/packages/cli
 > tsup src/index.ts src/cli.ts --format cjs,esm
 
 CLI Building entry: src/cli.ts, src/index.ts
@@ -10,7 +10,7 @@
 CJS Build start
 ESM Build start
 
-[3:48:58 PM]  WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]
+ WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]                8:49:23 pm
 
     src/cli.ts:25:31:
       25 │   return dirname(fileURLToPath(import.meta.url));
@@ -20,10 +20,10 @@
 
 
 
-ESM dist/chunk-OOQTTRPG.mjs 8.68 KB
+CJS dist/cli.js   69.48 KB
+CJS dist/index.js 10.58 KB
+CJS ⚡️ Build success in 26ms
+ESM dist/cli.mjs            56.89 KB
+ESM dist/chunk-2QOU5KKW.mjs 9.48 KB
 ESM dist/index.mjs          170.00 B
-ESM dist/cli.mjs            56.77 KB
-ESM ⚡️ Build success in 29ms
-CJS dist/index.js 9.79 KB
-CJS dist/cli.js   68.56 KB
-CJS ⚡️ Build success in 29ms
+ESM ⚡️ Build success in 26ms

package/.turbo/turbo-test.log

@@ -1,55 +1,92 @@
 
 
-> @aiready/cli@0.12.10 test /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.12.13 test /Users/pengcao/projects/aiready/packages/cli
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/cli
 
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: pattern-detect (patterns, duplicates, duplication)
+
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: pattern-detect (patterns, duplicates, duplication)
+[ToolRegistry#0.9221699210349066] Registering tool: pattern-detect (patterns, duplicates, duplication)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: context-analyzer (context, fragmentation, budget)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: context-analyzer (context, fragmentation, budget)
+[ToolRegistry#0.9221699210349066] Registering tool: context-analyzer (context, fragmentation, budget)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: naming-consistency (consistency, naming, standards)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: naming-consistency (consistency, naming, standards)
+[ToolRegistry#0.9221699210349066] Registering tool: naming-consistency (consistency, naming, standards)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: ai-signal-clarity (ai-signal, clarity, hallucination)
+[ToolRegistry#0.9221699210349066] Registering tool: ai-signal-clarity (ai-signal, clarity, hallucination)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: ai-signal-clarity (ai-signal, clarity, hallucination)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: agent-grounding (agent-grounding, grounding, navigation)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: agent-grounding (agent-grounding, grounding, navigation)
+[ToolRegistry#0.9221699210349066] Registering tool: agent-grounding (agent-grounding, grounding, navigation)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: testability-index (testability, tests, verification)
+[ToolRegistry#0.9221699210349066] Registering tool: testability-index (testability, tests, verification)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: testability-index (testability, tests, verification)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: doc-drift (doc-drift, docs, jsdoc)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: doc-drift (doc-drift, docs, jsdoc)
+[ToolRegistry#0.9221699210349066] Registering tool: doc-drift (doc-drift, docs, jsdoc)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: dependency-health (deps, deps-health, packages)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: dependency-health (deps, deps-health, packages)
+[ToolRegistry#0.9221699210349066] Registering tool: dependency-health (deps, deps-health, packages)
+
+stdout | src/__tests__/config-shape.test.ts
+[ToolRegistry#0.9033815218908418] Registering tool: change-amplification (change-amp, change-amplification, coupling)
 
 stdout | src/__tests__/cli.test.ts
-[ToolRegistry#0.7181242020735591] Registering tool: change-amplification (change-amp, change-amplification, coupling)
+[ToolRegistry#0.9221699210349066] Registering tool: change-amplification (change-amp, change-amplification, coupling)
 
 stdout | src/__tests__/cli.test.ts > CLI Unified Analysis > should run unified analysis with both tools
-[ToolRegistry#0.7181242020735591] Registering tool: pattern-detect (patterns)
-[ToolRegistry#0.7181242020735591] Registering tool: context-analyzer (context)
+[ToolRegistry#0.9221699210349066] Registering tool: pattern-detect (patterns)
+[ToolRegistry#0.9221699210349066] Registering tool: context-analyzer (context)
+
+stdout | src/__tests__/config-shape.test.ts > CLI Configuration Shape > should generate a strictly portable AIReadyConfig in summary
+[ToolRegistry#0.9033815218908418] Registering tool: pattern-detect (patterns)
 
 stdout | src/__tests__/cli.test.ts > CLI Unified Analysis > should run analysis with only patterns tool
-[ToolRegistry#0.7181242020735591] Registering tool: pattern-detect (patterns)
-[ToolRegistry#0.7181242020735591] Registering tool: context-analyzer (context)
+[ToolRegistry#0.9221699210349066] Registering tool: pattern-detect (patterns)
+[ToolRegistry#0.9221699210349066] Registering tool: context-analyzer (context)
 
 stdout | src/__tests__/cli.test.ts > CLI Unified Analysis > should run analysis with only context tool
-[ToolRegistry#0.7181242020735591] Registering tool: pattern-detect (patterns)
-[ToolRegistry#0.7181242020735591] Registering tool: context-analyzer (context)
+[ToolRegistry#0.9221699210349066] Registering tool: pattern-detect (patterns)
+[ToolRegistry#0.9221699210349066] Registering tool: context-analyzer (context)
+
+stdout | src/__tests__/config-shape.test.ts > CLI Configuration Shape > should strip internal keys like useSmartDefaults and batchSize
+[ToolRegistry#0.9033815218908418] Registering tool: pattern-detect (patterns)
+
+stdout | src/__tests__/config-shape.test.ts > CLI Configuration Shape > should produce a config that is compatible with tool specific collection
+[ToolRegistry#0.9033815218908418] Registering tool: pattern-detect (patterns)
 
  ✓ src/__tests__/cli.test.ts (3 tests) 3ms
+ ✓ src/__tests__/config-shape.test.ts (3 tests) 3ms
 
- Test Files  1 passed (1)
-      Tests  3 passed (3)
-   Start at  15:49:41
-   Duration  386ms (transform 112ms, setup 0ms, import 304ms, tests 3ms, environment 0ms)
+ Test Files  2 passed (2)
+      Tests  6 passed (6)
+   Start at  20:49:43
+   Duration  460ms (transform 241ms, setup 0ms, import 659ms, tests 6ms, environment 0ms)
 
 [?25h

package/dist/chunk-2QOU5KKW.mjs

@@ -0,0 +1,301 @@
+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/index.ts
+import {
+  ToolRegistry,
+  ToolName,
+  calculateOverallScore,
+  calculateTokenBudget,
+  GLOBAL_INFRA_OPTIONS,
+  COMMON_FINE_TUNING_OPTIONS
+} from "@aiready/core";
+import "@aiready/pattern-detect";
+import "@aiready/context-analyzer";
+import "@aiready/consistency";
+import "@aiready/ai-signal-clarity";
+import "@aiready/agent-grounding";
+import "@aiready/testability";
+import "@aiready/doc-drift";
+import "@aiready/deps";
+import "@aiready/change-amplification";
+var TOOL_PACKAGE_MAP = {
+  [ToolName.PatternDetect]: "@aiready/pattern-detect",
+  [ToolName.ContextAnalyzer]: "@aiready/context-analyzer",
+  [ToolName.NamingConsistency]: "@aiready/consistency",
+  [ToolName.AiSignalClarity]: "@aiready/ai-signal-clarity",
+  [ToolName.AgentGrounding]: "@aiready/agent-grounding",
+  [ToolName.TestabilityIndex]: "@aiready/testability",
+  [ToolName.DocDrift]: "@aiready/doc-drift",
+  [ToolName.DependencyHealth]: "@aiready/deps",
+  [ToolName.ChangeAmplification]: "@aiready/change-amplification",
+  // Aliases handled by registry
+  patterns: "@aiready/pattern-detect",
+  duplicates: "@aiready/pattern-detect",
+  context: "@aiready/context-analyzer",
+  fragmentation: "@aiready/context-analyzer",
+  consistency: "@aiready/consistency",
+  "ai-signal": "@aiready/ai-signal-clarity",
+  grounding: "@aiready/agent-grounding",
+  testability: "@aiready/testability",
+  "deps-health": "@aiready/deps",
+  "change-amp": "@aiready/change-amplification"
+};
+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;
+    }
+  }
+  return sanitized;
+}
+function sanitizeToolConfig(config) {
+  return sanitizeConfigRecursive(config);
+}
+async function analyzeUnified(options) {
+  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: {}
+    }
+  };
+  for (const toolName of requestedTools) {
+    let provider = ToolRegistry.find(toolName);
+    if (!provider) {
+      const packageName = TOOL_PACKAGE_MAP[toolName] || (toolName.startsWith("@aiready/") ? toolName : `@aiready/${toolName}`);
+      try {
+        await import(packageName);
+        provider = ToolRegistry.find(toolName);
+        if (provider) {
+          console.log(
+            `\u2705 Successfully loaded tool provider: ${toolName} from ${packageName}`
+          );
+        } else {
+          console.log(
+            `\u26A0\uFE0F Loaded ${packageName} but provider ${toolName} still not found in registry.`
+          );
+        }
+      } 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;
+    }
+    try {
+      const sanitizedOptions = { ...options };
+      delete sanitizedOptions.onProgress;
+      delete sanitizedOptions.progressCallback;
+      const toolOptions = {
+        rootDir: options.rootDir
+        // Always include rootDir
+      };
+      [...GLOBAL_INFRA_OPTIONS, ...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]);
+      } 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
+          });
+        }
+      };
+      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
+        );
+      } 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;
+      }
+      const issueCount = output.results.reduce(
+        (sum, file) => sum + (file.issues?.length || 0),
+        0
+      );
+      result.summary.totalIssues += issueCount;
+      if (provider.alias && Array.isArray(provider.alias)) {
+        for (const alias of provider.alias) {
+          if (!result[alias]) {
+            result[alias] = output;
+          }
+        }
+      }
+      const camelCaseId = provider.id.replace(
+        /-([a-z])/g,
+        (g) => g[1].toUpperCase()
+      );
+      if (camelCaseId !== provider.id && !result[camelCaseId]) {
+        result[camelCaseId] = output;
+      }
+    } catch (err) {
+      console.error(`\u274C Error running tool '${provider.id}':`, err);
+    }
+  }
+  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;
+  return result;
+}
+async function scoreUnified(results, options) {
+  const toolScores = /* @__PURE__ */ new Map();
+  for (const toolId of results.summary.toolsRun) {
+    const provider = 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 === ToolName.PatternDetect && output.duplicates) {
+          const wastedTokens = output.duplicates.reduce(
+            (sum, d) => sum + (d.tokenCost || 0),
+            0
+          );
+          toolScore.tokenBudget = calculateTokenBudget({
+            totalContextTokens: wastedTokens * 2,
+            wastedTokens: {
+              duplication: wastedTokens,
+              fragmentation: 0,
+              chattiness: 0
+            }
+          });
+        } else if (toolId === ToolName.ContextAnalyzer && output.summary) {
+          toolScore.tokenBudget = 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 {
+      overall: 0,
+      rating: "Critical",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      toolsUsed: [],
+      breakdown: [],
+      calculation: {
+        formula: "0 / 0 = 0",
+        weights: {},
+        normalized: "0 / 0 = 0"
+      }
+    };
+  }
+  return calculateOverallScore(toolScores, options, void 0);
+}
+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 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;
+}
+
+export {
+  __require,
+  analyzeUnified,
+  scoreUnified,
+  generateUnifiedSummary
+};