@aiready/cli 0.9.40 → 0.9.43

package/.github/FUNDING.yml

@@ -1,5 +1,5 @@
-github: ["caopengau"]
+github: ['caopengau']
 custom:
   - https://github.com/sponsors/caopengau
   - https://receiptclaimer.com
-  - mailto:caopengau@gmail.com
+  - mailto:caopengau@gmail.com

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.9.40 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.43 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
 
-[2:35:42 PM]  WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]
+[12:55:45 AM]  WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]
 
     src/cli.ts:23:31:
       23 │   return dirname(fileURLToPath(import.meta.url));
@@ -20,10 +20,10 @@
 
 
 
-ESM dist/cli.mjs            65.28 KB
+CJS dist/index.js 9.42 KB
+CJS dist/cli.js   80.79 KB
+CJS ⚡️ Build success in 100ms
+ESM dist/cli.mjs            70.25 KB
+ESM dist/chunk-LLJMKNBI.mjs 8.07 KB
 ESM dist/index.mjs          138.00 B
-ESM dist/chunk-PDOONNSK.mjs 7.80 KB
-ESM ⚡️ Build success in 491ms
-CJS dist/index.js 9.15 KB
-CJS dist/cli.js   75.53 KB
-CJS ⚡️ Build success in 492ms
+ESM ⚡️ Build success in 104ms

package/.turbo/turbo-lint.log

@@ -0,0 +1,5 @@
+
+
+> @aiready/cli@0.9.41 lint /Users/pengcao/projects/aiready/packages/cli
+> eslint src
+

package/.turbo/turbo-test.log

@@ -1,17 +1,17 @@
 
 
-> @aiready/cli@0.9.40 test /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.9.43 test /Users/pengcao/projects/aiready/packages/cli
 > vitest run
 
 [?25l
  RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/cli
 
- ✓ src/__tests__/cli.test.ts (3 tests) 5ms
- ✓ dist/__tests__/cli.test.js (3 tests) 2ms
+ ✓ src/__tests__/cli.test.ts (3 tests) 3ms
+ ✓ dist/__tests__/cli.test.js (3 tests) 9ms
 
  Test Files  2 passed (2)
       Tests  6 passed (6)
-   Start at  14:39:26
-   Duration  11.33s (transform 3.58s, setup 0ms, import 16.97s, tests 6ms, environment 0ms)
+   Start at  00:56:33
+   Duration  7.83s (transform 2.63s, setup 0ms, import 12.42s, tests 12ms, environment 0ms)
 
 [?25h

package/CONTRIBUTING.md

@@ -5,6 +5,7 @@ Thank you for your interest in contributing to AIReady CLI! We welcome bug repor
 ## 🎯 What is the CLI?
 
 The CLI is the **unified interface** for all AIReady analysis tools. It provides:
+
 - **Unified scanning**: Run multiple tools (patterns, context, consistency) with one command
 - **Individual tool access**: Use each tool directly for focused analysis
 - **Consistent output**: Unified reporting across all tools
@@ -41,6 +42,7 @@ The CLI follows a **hub-and-spoke** pattern:
 ## 🐛 Reporting Issues
 
 Found a bug or have a feature request? [Open an issue](https://github.com/caopengau/aiready-cli/issues) with:
+
 - Clear description of the problem or feature
 - Steps to reproduce (for bugs)
 - Expected vs actual behavior
@@ -69,6 +71,7 @@ pnpm link
 ## 📝 Making Changes
 
 1. **Fork the repository** and create a new branch:
+
    ```bash
    git checkout -b fix/cli-output-format
    # or
@@ -82,15 +85,17 @@ pnpm link
    - Keep commands modular and focused
 
 3. **Test your changes**:
+
    ```bash
    pnpm build
    pnpm test
-   
+
    # Test CLI locally
    ./dist/cli.js scan /path/to/project
    ```
 
 4. **Commit using conventional commits**:
+
    ```bash
    git commit -m "fix: correct output format for JSON"
    git commit -m "feat: add new tool integration"
@@ -121,6 +126,7 @@ We use [Conventional Commits](https://www.conventionalcommits.org/):
 - Test edge cases (missing arguments, invalid paths)
 
 Example test:
+
 ```typescript
 test('scan command runs all tools by default', async () => {
   const result = await runCli(['scan', './test-project']);
@@ -157,10 +163,11 @@ src/
 ### Adding a New Command
 
 1. Create `src/commands/your-command.ts`:
+
    ```typescript
    import { Command } from 'commander';
    import { globalOptions } from '../options/global';
-   
+
    export const yourCommand = new Command('your-command')
      .description('Description of your command')
      .argument('<directory>', 'Directory to analyze')
@@ -187,6 +194,7 @@ src/
 ## 🎯 Areas for Contribution
 
 Great places to start:
+
 - **New commands**: Add new CLI commands
 - **Tool integration**: Integrate new analysis tools
 - **Output formats**: Add new output options (XML, CSV, HTML)
@@ -211,6 +219,7 @@ Great places to start:
 ## 💡 Feature Ideas
 
 Looking for inspiration? Consider:
+
 - Interactive mode with guided analysis
 - Watch mode for file changes
 - IDE plugins integration

package/dist/chunk-HLBKROD3.mjs

@@ -0,0 +1,237 @@
+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 { analyzePatterns } from "@aiready/pattern-detect";
+import { analyzeContext } from "@aiready/context-analyzer";
+import { analyzeConsistency } from "@aiready/consistency";
+var severityOrder = {
+  critical: 4,
+  major: 3,
+  minor: 2,
+  info: 1
+};
+function sortBySeverity(results) {
+  return results.map((file) => {
+    const sortedIssues = [...file.issues].sort((a, b) => {
+      const severityDiff = (severityOrder[b.severity] || 0) - (severityOrder[a.severity] || 0);
+      if (severityDiff !== 0) return severityDiff;
+      return (a.location?.line || 0) - (b.location?.line || 0);
+    });
+    return { ...file, issues: sortedIssues };
+  }).sort((a, b) => {
+    const aMaxSeverity = Math.max(
+      ...a.issues.map((i) => severityOrder[i.severity] || 0),
+      0
+    );
+    const bMaxSeverity = Math.max(
+      ...b.issues.map((i) => severityOrder[i.severity] || 0),
+      0
+    );
+    if (aMaxSeverity !== bMaxSeverity) {
+      return bMaxSeverity - aMaxSeverity;
+    }
+    if (a.issues.length !== b.issues.length) {
+      return b.issues.length - a.issues.length;
+    }
+    return a.fileName.localeCompare(b.fileName);
+  });
+}
+async function analyzeUnified(options) {
+  const startTime = Date.now();
+  const tools = options.tools || ["patterns", "context", "consistency"];
+  const result = {
+    summary: {
+      totalIssues: 0,
+      toolsRun: tools,
+      executionTime: 0
+    }
+  };
+  if (tools.includes("patterns")) {
+    const patternResult = await analyzePatterns(options);
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "patterns", data: patternResult });
+    }
+    result.patterns = sortBySeverity(patternResult.results);
+    result.duplicates = patternResult.duplicates;
+    result.summary.totalIssues += patternResult.results.reduce(
+      (sum, file) => sum + file.issues.length,
+      0
+    );
+  }
+  if (tools.includes("context")) {
+    const contextResults = await analyzeContext(options);
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "context", data: contextResults });
+    }
+    result.context = contextResults.sort((a, b) => {
+      const severityDiff = (severityOrder[b.severity] || 0) - (severityOrder[a.severity] || 0);
+      if (severityDiff !== 0) return severityDiff;
+      if (a.tokenCost !== b.tokenCost) return b.tokenCost - a.tokenCost;
+      return b.fragmentationScore - a.fragmentationScore;
+    });
+    result.summary.totalIssues += result.context?.length || 0;
+  }
+  if (tools.includes("consistency")) {
+    const consistencyOptions = {
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      ...options.consistency || {}
+    };
+    const report = await analyzeConsistency(consistencyOptions);
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "consistency", data: report });
+    }
+    if (report.results) {
+      report.results = sortBySeverity(report.results);
+    }
+    result.consistency = report;
+    result.summary.totalIssues += report.summary.totalIssues;
+  }
+  if (tools.includes("doc-drift")) {
+    const { analyzeDocDrift } = await import("@aiready/doc-drift");
+    const report = await analyzeDocDrift({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "doc-drift", data: report });
+    }
+    result.docDrift = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("deps-health")) {
+    const { analyzeDeps } = await import("@aiready/deps");
+    const report = await analyzeDeps({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "deps-health", data: report });
+    }
+    result.deps = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("aiSignalClarity")) {
+    const { analyzeAiSignalClarity } = await import("@aiready/ai-signal-clarity");
+    const report = await analyzeAiSignalClarity({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "aiSignalClarity", data: report });
+    }
+    result.aiSignalClarity = report;
+    result.summary.totalIssues += report.results?.reduce(
+      (sum, r) => sum + (r.issues?.length || 0),
+      0
+    ) || 0;
+  }
+  if (tools.includes("grounding")) {
+    const { analyzeAgentGrounding } = await import("@aiready/agent-grounding");
+    const report = await analyzeAgentGrounding({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "grounding", data: report });
+    }
+    result.grounding = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("testability")) {
+    const { analyzeTestability } = await import("@aiready/testability");
+    const report = await analyzeTestability({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "testability", data: report });
+    }
+    result.testability = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("changeAmplification")) {
+    const { analyzeChangeAmplification } = await import("@aiready/change-amplification");
+    const report = await analyzeChangeAmplification({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "changeAmplification", data: report });
+    }
+    result.changeAmplification = report;
+    result.summary.totalIssues += report.summary?.totalIssues || 0;
+  }
+  result.summary.executionTime = Date.now() - startTime;
+  return result;
+}
+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
+
+`;
+  if (result.patterns) {
+    output += `\u{1F50D} Pattern Analysis: ${result.patterns.length} issues
+`;
+  }
+  if (result.context) {
+    output += `\u{1F9E0} Context Analysis: ${result.context.length} issues
+`;
+  }
+  if (result.consistency) {
+    output += `\u{1F3F7}\uFE0F Consistency Analysis: ${result.consistency.summary.totalIssues} issues
+`;
+  }
+  if (result.docDrift) {
+    output += `\u{1F4DD} Doc Drift Analysis: ${result.docDrift.issues?.length || 0} issues
+`;
+  }
+  if (result.deps) {
+    output += `\u{1F4E6} Dependency Health: ${result.deps.issues?.length || 0} issues
+`;
+  }
+  if (result.aiSignalClarity) {
+    output += `\u{1F9E0} AI Signal Clarity: ${result.aiSignalClarity.summary?.totalSignals || 0} signals
+`;
+  }
+  if (result.grounding) {
+    output += `\u{1F9ED} Agent Grounding: ${result.grounding.issues?.length || 0} issues
+`;
+  }
+  if (result.testability) {
+    output += `\u{1F9EA} Testability Index: ${result.testability.issues?.length || 0} issues
+`;
+  }
+  if (result.changeAmplification) {
+    output += `\u{1F4A5} Change Amplification: ${result.changeAmplification.summary?.totalIssues || 0} cascading risks
+`;
+  }
+  return output;
+}
+
+export {
+  __require,
+  analyzeUnified,
+  generateUnifiedSummary
+};

package/dist/chunk-LLJMKNBI.mjs

@@ -0,0 +1,243 @@
+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 { analyzePatterns } from "@aiready/pattern-detect";
+import { analyzeContext } from "@aiready/context-analyzer";
+import { analyzeConsistency } from "@aiready/consistency";
+var severityOrder = {
+  critical: 4,
+  major: 3,
+  minor: 2,
+  info: 1
+};
+function sortBySeverity(results) {
+  return results.map((file) => {
+    const sortedIssues = [...file.issues].sort((a, b) => {
+      const severityDiff = (severityOrder[b.severity] || 0) - (severityOrder[a.severity] || 0);
+      if (severityDiff !== 0) return severityDiff;
+      return (a.location?.line || 0) - (b.location?.line || 0);
+    });
+    return { ...file, issues: sortedIssues };
+  }).sort((a, b) => {
+    const aMaxSeverity = Math.max(
+      ...a.issues.map((i) => severityOrder[i.severity] || 0),
+      0
+    );
+    const bMaxSeverity = Math.max(
+      ...b.issues.map((i) => severityOrder[i.severity] || 0),
+      0
+    );
+    if (aMaxSeverity !== bMaxSeverity) {
+      return bMaxSeverity - aMaxSeverity;
+    }
+    if (a.issues.length !== b.issues.length) {
+      return b.issues.length - a.issues.length;
+    }
+    return a.fileName.localeCompare(b.fileName);
+  });
+}
+async function analyzeUnified(options) {
+  const startTime = Date.now();
+  const tools = options.tools || ["patterns", "context", "consistency"];
+  const result = {
+    summary: {
+      totalIssues: 0,
+      toolsRun: tools,
+      executionTime: 0
+    }
+  };
+  if (tools.includes("patterns")) {
+    const patternResult = await analyzePatterns(options);
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "patterns", data: patternResult });
+    }
+    result.patterns = sortBySeverity(patternResult.results);
+    result.duplicates = patternResult.duplicates;
+    result.summary.totalIssues += patternResult.results.reduce(
+      (sum, file) => sum + file.issues.length,
+      0
+    );
+  }
+  if (tools.includes("context")) {
+    const contextResults = await analyzeContext(options);
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "context", data: contextResults });
+    }
+    result.context = contextResults.sort((a, b) => {
+      const severityDiff = (severityOrder[b.severity] || 0) - (severityOrder[a.severity] || 0);
+      if (severityDiff !== 0) return severityDiff;
+      if (a.tokenCost !== b.tokenCost) return b.tokenCost - a.tokenCost;
+      return b.fragmentationScore - a.fragmentationScore;
+    });
+    result.summary.totalIssues += result.context?.length || 0;
+  }
+  if (tools.includes("consistency")) {
+    const consistencyOptions = {
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      ...options.consistency || {}
+    };
+    const report = await analyzeConsistency(consistencyOptions);
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "consistency", data: report });
+    }
+    if (report.results) {
+      report.results = sortBySeverity(report.results);
+    }
+    result.consistency = report;
+    result.summary.totalIssues += report.summary.totalIssues;
+  }
+  if (tools.includes("doc-drift")) {
+    const { analyzeDocDrift } = await import("@aiready/doc-drift");
+    const report = await analyzeDocDrift({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      onProgress: options.onProgress
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "doc-drift", data: report });
+    }
+    result.docDrift = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("deps-health")) {
+    const { analyzeDeps } = await import("@aiready/deps");
+    const report = await analyzeDeps({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      onProgress: options.onProgress
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "deps-health", data: report });
+    }
+    result.deps = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("aiSignalClarity")) {
+    const { analyzeAiSignalClarity } = await import("@aiready/ai-signal-clarity");
+    const report = await analyzeAiSignalClarity({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      onProgress: options.onProgress
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "aiSignalClarity", data: report });
+    }
+    result.aiSignalClarity = report;
+    result.summary.totalIssues += report.results?.reduce(
+      (sum, r) => sum + (r.issues?.length || 0),
+      0
+    ) || 0;
+  }
+  if (tools.includes("grounding")) {
+    const { analyzeAgentGrounding } = await import("@aiready/agent-grounding");
+    const report = await analyzeAgentGrounding({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      onProgress: options.onProgress
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "grounding", data: report });
+    }
+    result.grounding = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("testability")) {
+    const { analyzeTestability } = await import("@aiready/testability");
+    const report = await analyzeTestability({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      onProgress: options.onProgress
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "testability", data: report });
+    }
+    result.testability = report;
+    result.summary.totalIssues += report.issues?.length || 0;
+  }
+  if (tools.includes("changeAmplification")) {
+    const { analyzeChangeAmplification } = await import("@aiready/change-amplification");
+    const report = await analyzeChangeAmplification({
+      rootDir: options.rootDir,
+      include: options.include,
+      exclude: options.exclude,
+      onProgress: options.onProgress
+    });
+    if (options.progressCallback) {
+      options.progressCallback({ tool: "changeAmplification", data: report });
+    }
+    result.changeAmplification = report;
+    result.summary.totalIssues += report.summary?.totalIssues || 0;
+  }
+  result.summary.executionTime = Date.now() - startTime;
+  return result;
+}
+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
+
+`;
+  if (result.patterns) {
+    output += `\u{1F50D} Pattern Analysis: ${result.patterns.length} issues
+`;
+  }
+  if (result.context) {
+    output += `\u{1F9E0} Context Analysis: ${result.context.length} issues
+`;
+  }
+  if (result.consistency) {
+    output += `\u{1F3F7}\uFE0F Consistency Analysis: ${result.consistency.summary.totalIssues} issues
+`;
+  }
+  if (result.docDrift) {
+    output += `\u{1F4DD} Doc Drift Analysis: ${result.docDrift.issues?.length || 0} issues
+`;
+  }
+  if (result.deps) {
+    output += `\u{1F4E6} Dependency Health: ${result.deps.issues?.length || 0} issues
+`;
+  }
+  if (result.aiSignalClarity) {
+    output += `\u{1F9E0} AI Signal Clarity: ${result.aiSignalClarity.summary?.totalSignals || 0} signals
+`;
+  }
+  if (result.grounding) {
+    output += `\u{1F9ED} Agent Grounding: ${result.grounding.issues?.length || 0} issues
+`;
+  }
+  if (result.testability) {
+    output += `\u{1F9EA} Testability Index: ${result.testability.issues?.length || 0} issues
+`;
+  }
+  if (result.changeAmplification) {
+    output += `\u{1F4A5} Change Amplification: ${result.changeAmplification.summary?.totalIssues || 0} cascading risks
+`;
+  }
+  return output;
+}
+
+export {
+  __require,
+  analyzeUnified,
+  generateUnifiedSummary
+};