@aiready/cli 0.14.8 → 0.14.9

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.14.8 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.14.9 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
 
- WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]           12:22:46 am
+ WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]           10:14:43 am
 
     src/cli.ts:29:31:
       29 │   return dirname(fileURLToPath(import.meta.url));
@@ -20,10 +20,10 @@
 
 
 
-CJS dist/cli.js   84.50 KB
-CJS dist/index.js 10.62 KB
-CJS ⚡️ Build success in 152ms
 ESM dist/index.mjs          170.00 B
-ESM dist/cli.mjs            70.71 KB
+ESM dist/cli.mjs            70.91 KB
 ESM dist/chunk-VOKP7FGM.mjs 9.52 KB
-ESM ⚡️ Build success in 152ms
+ESM ⚡️ Build success in 36ms
+CJS dist/cli.js   84.70 KB
+CJS dist/index.js 10.62 KB
+CJS ⚡️ Build success in 36ms

package/.turbo/turbo-test.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.14.4 test /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.14.8 test /Users/pengcao/projects/aiready/packages/cli
 > vitest run
 
 [?25l
@@ -9,23 +9,7 @@
 stdout | src/commands/__tests__/visualize.test.ts > Visualize CLI Action > should generate HTML from specified report
 Building graph from report...
 
-stdout | src/commands/__tests__/upload.test.ts > Upload CLI Action > should fail if API key is missing
-   Set AIREADY_API_KEY environment variable or use --api-key flag.
-   Get an API key from https://platform.getaiready.dev/dashboard
-🚀 Uploading report to https://dev.platform.getaiready.dev...
-   Reading report from /Users/pengcao/projects/aiready/packages/cli/report.json...
-   Successfully parsed report JSON.
-
-stdout | src/commands/__tests__/upload.test.ts > Upload CLI Action > should fail if API key is missing
-
-✅ Upload successful! (0.00s)
-   View results: https://dev.platform.getaiready.dev/dashboard
-   Analysis ID: 123
-   Score: 80/100
-
- ✓ src/commands/__tests__/upload.test.ts (2 tests) 4ms
- ✓ src/commands/__tests__/testability.test.ts (2 tests) 10ms
- ✓ src/commands/__tests__/agent-grounding.test.ts (1 test) 18ms
+ ✓ src/commands/__tests__/testability.test.ts (2 tests) 17ms
 stdout | src/commands/__tests__/visualize.test.ts > Visualize CLI Action > should generate HTML from specified report
 Generating HTML...
 ✅ Visualization written to: /Users/pengcao/projects/aiready/packages/cli/visualization.html
@@ -53,24 +37,40 @@ Or specify a custom report:
 Generating HTML...
 ✅ Visualization written to: /Users/pengcao/projects/aiready/packages/cli/visualization.html
 
- ✓ src/commands/__tests__/visualize.test.ts (4 tests) 26ms
- ✓ src/commands/__tests__/ai-signal-clarity.test.ts (1 test) 10ms
- ✓ src/commands/__tests__/doc-drift.test.ts (1 test) 11ms
- ✓ src/commands/__tests__/deps-health.test.ts (1 test) 11ms
- ✓ src/utils/__tests__/helpers.test.ts (3 tests) 2ms
- ✓ src/commands/__tests__/init.test.ts (3 tests) 5ms
+ ✓ src/commands/__tests__/visualize.test.ts (4 tests) 59ms
+ ✓ src/commands/__tests__/deps-health.test.ts (1 test) 63ms
+ ✓ src/commands/__tests__/doc-drift.test.ts (1 test) 60ms
+ ✓ src/commands/__tests__/ai-signal-clarity.test.ts (1 test) 58ms
+ ✓ src/commands/__tests__/agent-grounding.test.ts (1 test) 57ms
+stdout | src/commands/__tests__/upload.test.ts > Upload CLI Action > should fail if API key is missing
+   Set AIREADY_API_KEY environment variable or use --api-key flag.
+   Get an API key from https://platform.getaiready.dev/dashboard
+🚀 Uploading report to https://dev.platform.getaiready.dev...
+   Reading report from /Users/pengcao/projects/aiready/packages/cli/report.json...
+   Successfully parsed report JSON.
+
+stdout | src/commands/__tests__/upload.test.ts > Upload CLI Action > should fail if API key is missing
+
+✅ Upload successful! (0.00s)
+   View results: https://dev.platform.getaiready.dev/dashboard
+   Analysis ID: 123
+   Score: 80/100
+
+ ✓ src/commands/__tests__/upload.test.ts (2 tests) 11ms
+ ✓ src/commands/__tests__/init.test.ts (3 tests) 9ms
  ✓ src/commands/__tests__/consistency.test.ts (4 tests) 4ms
- ✓ src/commands/__tests__/scan.test.ts (6 tests) 89ms
- ✓ src/commands/__tests__/extra-commands.test.ts (8 tests) 99ms
+ ✓ src/utils/__tests__/helpers.test.ts (3 tests) 2ms
+ ✓ src/commands/__tests__/scan.test.ts (6 tests) 98ms
+ ✓ src/commands/__tests__/extra-commands.test.ts (8 tests) 113ms
  ✓ src/__tests__/unified.test.ts (4 tests) 3ms
- ✓ src/__tests__/cli.test.ts (3 tests) 2959ms
-     ✓ should run unified analysis with both tools  2957ms
- ✓ src/__tests__/config-shape.test.ts (3 tests) 2959ms
-     ✓ should generate a strictly portable AIReadyConfig in summary  2958ms
+ ✓ src/__tests__/cli.test.ts (3 tests) 3798ms
+     ✓ should run unified analysis with both tools  3797ms
+ ✓ src/__tests__/config-shape.test.ts (3 tests) 3799ms
+     ✓ should generate a strictly portable AIReadyConfig in summary  3798ms
 
  Test Files  15 passed (15)
       Tests  46 passed (46)
-   Start at  10:36:31
-   Duration  3.86s (transform 2.14s, setup 0ms, import 4.73s, tests 6.21s, environment 1ms)
+   Start at  10:12:44
+   Duration  5.54s (transform 3.64s, setup 0ms, import 10.00s, tests 8.15s, environment 2ms)
 
 [?25h

package/dist/cli.js

@@ -1958,15 +1958,17 @@ AI READINESS SCORING:
 EXAMPLES:
   $ aiready scan                          # Comprehensive analysis with AI Readiness Score
   $ aiready scan --no-score               # Run scan without score calculation
-  $ aiready scan --tools patterns         # Run only pattern detection
+  $ aiready init                          # Create a default aiready.json configuration
+  $ aiready init --full                   # Create configuration with ALL available options
   $ npx @aiready/cli scan                 # Industry standard way to run standard scan
   $ aiready scan --output json            # Output raw JSON for piping
 
 GETTING STARTED:
-  1. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
-  2. Use '--profile agentic' for agent-focused analysis
-  3. Create aiready.json for persistent configuration
-  4. Set up CI/CD with '--threshold' for quality gates
+  1. Run 'aiready init' to create a persistent 'aiready.json' config file
+  2. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
+  3. Use 'aiready init --full' to see every fine-tuning parameter available
+  4. Use '--profile agentic' for agent-focused analysis
+  5. Set up CI/CD with '--threshold' for quality gates
 
 CONFIGURATION:
   Config files (searched upward): aiready.json, .aiready.json, aiready.config.*

package/dist/cli.mjs

@@ -1719,15 +1719,17 @@ AI READINESS SCORING:
 EXAMPLES:
   $ aiready scan                          # Comprehensive analysis with AI Readiness Score
   $ aiready scan --no-score               # Run scan without score calculation
-  $ aiready scan --tools patterns         # Run only pattern detection
+  $ aiready init                          # Create a default aiready.json configuration
+  $ aiready init --full                   # Create configuration with ALL available options
   $ npx @aiready/cli scan                 # Industry standard way to run standard scan
   $ aiready scan --output json            # Output raw JSON for piping
 
 GETTING STARTED:
-  1. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
-  2. Use '--profile agentic' for agent-focused analysis
-  3. Create aiready.json for persistent configuration
-  4. Set up CI/CD with '--threshold' for quality gates
+  1. Run 'aiready init' to create a persistent 'aiready.json' config file
+  2. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
+  3. Use 'aiready init --full' to see every fine-tuning parameter available
+  4. Use '--profile agentic' for agent-focused analysis
+  5. Set up CI/CD with '--threshold' for quality gates
 
 CONFIGURATION:
   Config files (searched upward): aiready.json, .aiready.json, aiready.config.*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.14.8",
+  "version": "0.14.9",
   "description": "Unified CLI for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -11,17 +11,17 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
-    "@aiready/agent-grounding": "0.13.5",
-    "@aiready/consistency": "0.20.5",
-    "@aiready/context-analyzer": "0.21.9",
-    "@aiready/core": "0.23.6",
-    "@aiready/deps": "0.13.5",
-    "@aiready/doc-drift": "0.13.5",
-    "@aiready/change-amplification": "0.13.5",
-    "@aiready/ai-signal-clarity": "0.13.6",
-    "@aiready/visualizer": "0.6.5",
-    "@aiready/pattern-detect": "0.16.5",
-    "@aiready/testability": "0.6.5"
+    "@aiready/agent-grounding": "0.13.6",
+    "@aiready/consistency": "0.20.6",
+    "@aiready/context-analyzer": "0.21.10",
+    "@aiready/core": "0.23.7",
+    "@aiready/deps": "0.13.6",
+    "@aiready/change-amplification": "0.13.6",
+    "@aiready/visualizer": "0.6.6",
+    "@aiready/ai-signal-clarity": "0.13.7",
+    "@aiready/pattern-detect": "0.16.6",
+    "@aiready/testability": "0.6.6",
+    "@aiready/doc-drift": "0.13.6"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/cli.ts

@@ -49,15 +49,17 @@ AI READINESS SCORING:
 EXAMPLES:
   $ aiready scan                          # Comprehensive analysis with AI Readiness Score
   $ aiready scan --no-score               # Run scan without score calculation
-  $ aiready scan --tools patterns         # Run only pattern detection
+  $ aiready init                          # Create a default aiready.json configuration
+  $ aiready init --full                   # Create configuration with ALL available options
   $ npx @aiready/cli scan                 # Industry standard way to run standard scan
   $ aiready scan --output json            # Output raw JSON for piping
 
 GETTING STARTED:
-  1. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
-  2. Use '--profile agentic' for agent-focused analysis
-  3. Create aiready.json for persistent configuration
-  4. Set up CI/CD with '--threshold' for quality gates
+  1. Run 'aiready init' to create a persistent 'aiready.json' config file
+  2. Run 'aiready scan' to analyze your codebase and get an AI Readiness Score
+  3. Use 'aiready init --full' to see every fine-tuning parameter available
+  4. Use '--profile agentic' for agent-focused analysis
+  5. Set up CI/CD with '--threshold' for quality gates
 
 CONFIGURATION:
   Config files (searched upward): aiready.json, .aiready.json, aiready.config.*

package/src/commands/report-formatter.ts

@@ -8,7 +8,10 @@ import {
 } from '@aiready/core';
 
 /**
- * Handle console output for the scan results
+ * Handle console output for the scan results.
+ *
+ * @param results - The combined results from all tools.
+ * @param startTime - The timestamp when the scan started.
  */
 export function printScanSummary(results: any, startTime: number) {
   console.log(chalk.cyan('\n=== AIReady Run Summary ==='));
@@ -21,7 +24,10 @@ export function printScanSummary(results: any, startTime: number) {
 }
 
 /**
- * Print business impact analysis
+ * Print business impact analysis based on ROI and budget metrics.
+ *
+ * @param roi - Calculated Return on Investment metrics.
+ * @param unifiedBudget - Consolidated context budget metrics.
  */
 export function printBusinessImpact(roi: any, unifiedBudget: any) {
   console.log(chalk.bold('\n💰 Business Impact Analysis (Monthly)'));
@@ -40,7 +46,10 @@ export function printBusinessImpact(roi: any, unifiedBudget: any) {
 }
 
 /**
- * Print detailed scoring breakdown
+ * Print detailed scoring breakdown by tool.
+ *
+ * @param scoringResult - The overall scoring result.
+ * @param scoringProfile - The name of the scoring profile used.
  */
 export function printScoring(
   scoringResult: ScoringResult,
@@ -87,7 +96,11 @@ export function printScoring(
 }
 
 /**
- * Normalize report mapping (CLI logic)
+ * Normalize and map tool-specific results to a unified report structure.
+ *
+ * @param res - Raw unified results object.
+ * @param scoring - Optional scoring result to include.
+ * @returns Enhanced report with totals and scoring.
  */
 export function mapToUnifiedReport(
   res: any,

package/src/index.ts

@@ -147,8 +147,12 @@ function sanitizeToolConfig(config: any): any {
 }
 
 /**
- * AIReady Unified Analysis
+ * AIReady Unified Analysis.
  * Orchestrates all registered tools via the ToolRegistry.
+ *
+ * @param options - Unified analysis configuration including tools and rootDir.
+ * @returns Promise resolving to the consolidated analysis result.
+ * @lastUpdated 2026-03-18
  */
 export async function analyzeUnified(
   options: UnifiedAnalysisOptions
@@ -347,8 +351,12 @@ export async function analyzeUnified(
 }
 
 /**
- * AIReady Unified Scoring
+ * AIReady Unified Scoring.
  * Calculates scores for all analyzed tools.
+ *
+ * @param results - The consolidated results from a unified analysis.
+ * @param options - Analysis options for weighting and budget calculation.
+ * @returns Promise resolving to the final scoring result.
  */
 export async function scoreUnified(
   results: UnifiedAnalysisResult,
@@ -419,7 +427,10 @@ export async function scoreUnified(
 }
 
 /**
- * Generate human-readable summary of unified results
+ * Generate human-readable summary of unified results.
+ *
+ * @param result - The consolidated analysis result object.
+ * @returns Formatted summary string.
  */
 export function generateUnifiedSummary(result: UnifiedAnalysisResult): string {
   const { summary } = result;

package/src/utils/helpers.ts

@@ -22,7 +22,10 @@ export function getReportTimestamp(): string {
 }
 
 /**
- * Warn if graph caps may be exceeded
+ * Warn if graph caps may be exceeded for visualization.
+ *
+ * @param report - The combined analysis report.
+ * @param dirPath - Root directory to look for configuration.
  */
 export async function warnIfGraphCapExceeded(report: any, dirPath: string) {
   try {
@@ -90,7 +93,11 @@ export async function warnIfGraphCapExceeded(report: any, dirPath: string) {
 }
 
 /**
- * Generate markdown report for consistency command
+ * Generate markdown report for consistency command.
+ *
+ * @param report - The consistency report object.
+ * @param elapsedTime - Time taken for analysis in seconds.
+ * @returns Formatted markdown string.
  */
 export function generateMarkdownReport(
   report: any,
@@ -117,7 +124,11 @@ export function generateMarkdownReport(
 }
 
 /**
- * Truncate array for display (show first N items with "... +N more")
+ * Truncate array for display (show first N items with "... +N more").
+ *
+ * @param arr - The array to truncate.
+ * @param cap - Maximum number of items to show before truncating.
+ * @returns Formatted string for display.
  */
 export function truncateArray(arr: any[] | undefined, cap = 8): string {
   if (!Array.isArray(arr)) return '';
@@ -128,6 +139,10 @@ export function truncateArray(arr: any[] | undefined, cap = 8): string {
 
 /**
  * Build a common ToolScoringOutput payload from a tool report.
+ *
+ * @param toolName - Identifier for the tool.
+ * @param report - Minimal report structure containing score and recommendations.
+ * @returns Standardized scoring output.
  */
 export function buildToolScoringOutput(
   toolName: string,
@@ -152,6 +167,10 @@ export function buildToolScoringOutput(
 
 /**
  * Load config and apply tool-level defaults.
+ *
+ * @param directory - Directory to search for config.
+ * @param defaults - Tool-specific default values.
+ * @returns Merged configuration with tool defaults.
  */
 export async function loadMergedToolConfig<T extends Record<string, unknown>>(
   directory: string,
@@ -164,6 +183,11 @@ export async function loadMergedToolConfig<T extends Record<string, unknown>>(
 
 /**
  * Shared base scan options used by CLI tool commands.
+ *
+ * @param directory - Root directory for scanning.
+ * @param options - CLI commander options object.
+ * @param extras - Additional tool-specific options.
+ * @returns Combined scan options for the analyzer.
  */
 export function buildCommonScanOptions(
   directory: string,
@@ -180,6 +204,9 @@ export function buildCommonScanOptions(
 
 /**
  * Execute a config-driven tool command with shared CLI plumbing.
+ *
+ * @param params - Execution parameters including analyze and score callbacks.
+ * @returns Promise resolving to the tool report and its scoring output.
  */
 export async function runConfiguredToolCommand<TReport, TScoring>(params: {
   directory: string;