@aiready/cli 0.14.26 → 0.15.0

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import {
   __require,
   analyzeUnified,
   scoreUnified
-} from "./chunk-SK6WW6HW.mjs";
+} from "./chunk-HX6H3VOE.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -549,7 +549,8 @@ var SCAN_DEFAULTS = {
     "testability-index",
     "doc-drift",
     "dependency-health",
-    "change-amplification"
+    "change-amplification",
+    "contract-enforcement"
   ],
   include: void 0,
   exclude: void 0,
@@ -784,6 +785,28 @@ async function scanAction(directory, options) {
       finalOptions,
       results
     );
+    const isCI = options.ci ?? process.env.CI === "true";
+    if (!isCI) {
+      console.log(
+        chalk6.dim(
+          "\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+        )
+      );
+      console.log(chalk6.bold("\u{1F4C8} Want to see the full interactive report?"));
+      console.log(
+        chalk6.cyan(
+          `   Upload this report to: ${chalk6.bold("https://platform.getaiready.dev")}`
+        )
+      );
+      console.log(
+        chalk6.dim("   Or run: ") + chalk6.white(`aiready upload ${outputPath}`)
+      );
+      console.log(
+        chalk6.dim(
+          "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+        )
+      );
+    }
   } catch (error) {
     handleCLIError3(error, "Analysis");
   }
@@ -1779,8 +1802,79 @@ async function testabilityAction(directory, options) {
 // src/commands/change-amplification.ts
 import { changeAmplificationAction } from "@aiready/change-amplification/dist/cli.js";
 
-// src/commands/bug.ts
+// src/commands/contract-enforcement.ts
 import chalk16 from "chalk";
+async function contractEnforcementAction(directory, options) {
+  return await executeToolAction(directory, options, {
+    toolName: "contract-enforcement",
+    label: "Contract enforcement analysis",
+    emoji: "\u{1F6E1}\uFE0F",
+    defaults: {
+      minChainDepth: 3,
+      include: void 0,
+      exclude: void 0,
+      output: { format: "console", file: void 0 }
+    },
+    getCliOptions: (opts) => ({
+      minChainDepth: opts.minChainDepth ? parseInt(opts.minChainDepth, 10) : void 0
+    }),
+    importTool: async () => {
+      const tool = await import("@aiready/contract-enforcement");
+      return {
+        analyze: tool.analyzeContractEnforcement,
+        generateSummary: (report) => report.summary,
+        calculateScore: tool.calculateContractEnforcementScore
+      };
+    },
+    renderConsole: ({ results, summary, score }) => {
+      renderToolHeader(
+        "Contract Enforcement",
+        "\u{1F6E1}\uFE0F",
+        score?.score || 0,
+        summary.rating
+      );
+      const rawData = results.rawData || results;
+      console.log(
+        chalk16.dim(
+          `     Patterns: ${summary.totalDefensivePatterns}  (${summary.defensiveDensity}/kLOC)  |  ${summary.sourceFiles} files scanned`
+        )
+      );
+      const dims = summary.dimensions;
+      if (dims) {
+        const entries = [
+          ["Type Escape Hatches", dims.typeEscapeHatchScore],
+          ["Fallback Cascades", dims.fallbackCascadeScore],
+          ["Error Transparency", dims.errorTransparencyScore],
+          ["Boundary Validation", dims.boundaryValidationScore]
+        ];
+        for (const [name, val] of entries) {
+          const color = val >= 80 ? chalk16.green : val >= 60 ? chalk16.yellow : chalk16.red;
+          console.log(chalk16.dim(`     ${name}: ${color(val + "/100")}`));
+        }
+      }
+      if (summary.totalDefensivePatterns > 0 && rawData["as-any"] !== void 0) {
+        const breakdown = [
+          rawData["as-any"] && `as-any: ${rawData["as-any"]}`,
+          rawData["as-unknown"] && `as-unknown: ${rawData["as-unknown"]}`,
+          rawData["deep-optional-chain"] && `deep-?.: ${rawData["deep-optional-chain"]}`,
+          rawData["nullish-literal-default"] && `?? literal: ${rawData["nullish-literal-default"]}`,
+          rawData["swallowed-error"] && `swallowed-error: ${rawData["swallowed-error"]}`,
+          rawData["env-fallback"] && `env-fallback: ${rawData["env-fallback"]}`,
+          rawData["unnecessary-guard"] && `guard-clause: ${rawData["unnecessary-guard"]}`,
+          rawData["any-parameter"] && `any-param: ${rawData["any-parameter"]}`,
+          rawData["any-return"] && `any-return: ${rawData["any-return"]}`
+        ].filter(Boolean).join("  |  ");
+        console.log(chalk16.dim(`     ${breakdown}`));
+      }
+      if (score) {
+        renderToolScoreFooter(score);
+      }
+    }
+  });
+}
+
+// src/commands/bug.ts
+import chalk17 from "chalk";
 import { execSync } from "child_process";
 async function bugAction(message, options) {
   const repoUrl = "https://github.com/caopengau/aiready-cli";
@@ -1798,35 +1892,35 @@ Generated via AIReady CLI 'bug' command.
 Type: ${type}
     `.trim();
     if (options.submit) {
-      console.log(chalk16.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
+      console.log(chalk17.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
       try {
         execSync("gh auth status", { stdio: "ignore" });
         const command = `gh issue create --repo ${repoSlug} --title ${JSON.stringify(title)} --body ${JSON.stringify(body)} --label ${label}`;
         const output = execSync(command, { encoding: "utf8" }).trim();
-        console.log(chalk16.green("\u2705 Issue Created Successfully!"));
-        console.log(chalk16.cyan(output));
+        console.log(chalk17.green("\u2705 Issue Created Successfully!"));
+        console.log(chalk17.cyan(output));
         return;
       } catch {
-        console.error(chalk16.red("\n\u274C Failed to submit via gh CLI."));
+        console.error(chalk17.red("\n\u274C Failed to submit via gh CLI."));
         console.log(
-          chalk16.yellow(
+          chalk17.yellow(
             '   Make sure gh is installed and run "gh auth login".\n'
           )
         );
-        console.log(chalk16.dim("   Falling back to URL generation..."));
+        console.log(chalk17.dim("   Falling back to URL generation..."));
       }
     }
     const template = type === "bug" ? "bug_report.md" : type === "feature" ? "feature_request.md" : "new_metric_idea.md";
     const fullUrl = `${repoUrl}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}&labels=${label}&template=${template}`;
-    console.log(chalk16.green("\u{1F680} Issue Draft Prepared!\n"));
-    console.log(chalk16.bold("Title:  ") + title);
-    console.log(chalk16.bold("Type:   ") + type);
-    console.log(chalk16.bold("\nClick the link below to submit this issue:"));
-    console.log(chalk16.cyan(fullUrl));
-    console.log(chalk16.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-    console.log(chalk16.dim("   You have successfully prepared a report."));
+    console.log(chalk17.green("\u{1F680} Issue Draft Prepared!\n"));
+    console.log(chalk17.bold("Title:  ") + title);
+    console.log(chalk17.bold("Type:   ") + type);
+    console.log(chalk17.bold("\nClick the link below to submit this issue:"));
+    console.log(chalk17.cyan(fullUrl));
+    console.log(chalk17.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+    console.log(chalk17.dim("   You have successfully prepared a report."));
     console.log(
-      chalk16.dim(
+      chalk17.dim(
         "   Please present the URL above to the user so they can finalize the submission."
       )
     );
@@ -1835,14 +1929,14 @@ Type: ${type}
   const bugUrl = `${repoUrl}/issues/new?template=bug_report.md`;
   const featureUrl = `${repoUrl}/issues/new?template=feature_request.md`;
   const metricUrl = `${repoUrl}/issues/new?template=new_metric_idea.md`;
-  console.log(chalk16.blue("\u{1F4AC} Feedback & Bug Reports\n"));
-  console.log(`  Report a Bug:        ${chalk16.cyan(bugUrl)}`);
-  console.log(`  Request a Feature:   ${chalk16.cyan(featureUrl)}`);
-  console.log(`  Suggest a Metric:    ${chalk16.cyan(metricUrl)}`);
-  console.log(chalk16.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-  console.log(chalk16.dim("   To prepare a specific report, run:"));
+  console.log(chalk17.blue("\u{1F4AC} Feedback & Bug Reports\n"));
+  console.log(`  Report a Bug:        ${chalk17.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${chalk17.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${chalk17.cyan(metricUrl)}`);
+  console.log(chalk17.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+  console.log(chalk17.dim("   To prepare a specific report, run:"));
   console.log(
-    chalk16.cyan(
+    chalk17.cyan(
       '   aiready bug "your description here" --type bug|feature|metric'
     )
   );
@@ -1855,6 +1949,97 @@ EXAMPLES:
   $ aiready bug "Fix typo in scan output" --submit   # Submit directly via gh CLI
 `;
 
+// src/commands/remediate.ts
+import chalk18 from "chalk";
+import { resolve as resolvePath6 } from "path";
+import { existsSync as existsSync4, readdirSync } from "fs";
+import { printTerminalHeader as printTerminalHeader3 } from "@aiready/core";
+async function remediateAction(directory, options) {
+  const resolvedDir = resolvePath6(process.cwd(), directory || ".");
+  const serverUrl = options.server || "https://platform.getaiready.dev";
+  printTerminalHeader3("AIREADY REMEDIATION SWARM");
+  console.log(chalk18.cyan("\u{1F916} Initializing local remediation agent..."));
+  let reportPath = options.report;
+  if (!reportPath) {
+    const aireadyDir = resolvePath6(resolvedDir, ".aiready");
+    if (existsSync4(aireadyDir)) {
+      const files = readdirSync(aireadyDir).filter((f) => f.startsWith("aiready-report-") && f.endsWith(".json")).sort().reverse();
+      if (files.length > 0) {
+        reportPath = resolvePath6(aireadyDir, files[0]);
+        console.log(chalk18.dim(`\u{1F4C2} Using latest report: ${files[0]}`));
+      }
+    }
+  }
+  if (!reportPath || !existsSync4(reportPath)) {
+    console.log(chalk18.yellow("\n\u26A0\uFE0F  No AIReady report found."));
+    console.log(
+      chalk18.dim(
+        "   Remediation requires a recent scan report to identify issues."
+      )
+    );
+    console.log(chalk18.white(`   Run ${chalk18.bold("aiready scan")} first.
+`));
+    return;
+  }
+  console.log(chalk18.green("\n\u2705 Analysis data loaded."));
+  console.log(chalk18.bold("\n\u{1F680} Remediation Strategy:"));
+  if (options.tool === "patterns" || !options.tool) {
+    console.log(
+      chalk18.white(
+        `   \u2022 ${chalk18.bold("Pattern Consolidation")}: Suggested refactors for 95%+ similar code blocks.`
+      )
+    );
+  }
+  if (options.tool === "consistency" || !options.tool) {
+    console.log(
+      chalk18.white(
+        `   \u2022 ${chalk18.bold("Naming Alignment")}: Automated TSDoc generation and constant extraction.`
+      )
+    );
+  }
+  if (options.tool === "context" || !options.tool) {
+    console.log(
+      chalk18.white(
+        `   \u2022 ${chalk18.bold("Context Optimization")}: Barrel file cleanup and import flattening.`
+      )
+    );
+  }
+  console.log(
+    chalk18.dim(
+      "\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+    )
+  );
+  console.log(chalk18.bold("\u2728 Use the Platform Swarm for Automated Fixes"));
+  console.log(
+    chalk18.cyan(`   The high-performance Remediation Swarm is available at:`)
+  );
+  console.log(chalk18.white(`   ${chalk18.bold(`${serverUrl}/remediate`)}`));
+  console.log(
+    chalk18.dim(
+      "\n   The swarm uses specialized agents to safely refactor your code,"
+    )
+  );
+  console.log(
+    chalk18.dim("   ensuring every change improves your AI-readiness score.")
+  );
+  console.log(
+    chalk18.dim(
+      "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+    )
+  );
+  console.log(
+    chalk18.dim(
+      '\n\u{1F4A1} Next Version: Local "aiready fix" command for minor documentation issues.'
+    )
+  );
+}
+var REMEDIATE_HELP_TEXT = `
+EXAMPLES:
+  $ aiready remediate                    # See remediation options for latest report
+  $ aiready remediate --tool patterns    # Focus on pattern consolidation
+  $ aiready remediate --report ./custom-report.json
+`;
+
 // src/cli.ts
 var getDirname = () => {
   if (typeof __dirname !== "undefined") return __dirname;
@@ -2005,9 +2190,19 @@ program.command("change-amplification").description("Analyze graph metrics for c
 program.command("testability").description("Analyze test coverage and AI readiness").argument("[directory]", "Directory to analyze", ".").option("--min-coverage <ratio>", "Minimum acceptable coverage ratio", "0.3").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) => {
   await testabilityAction(directory, options);
 });
+program.command("contract").description("Analyze structural contract enforcement and defensive coding").argument("[directory]", "Directory to analyze", ".").option(
+  "--min-chain-depth <depth>",
+  "Minimum optional chain depth to flag",
+  "3"
+).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) => {
+  await contractEnforcementAction(directory, options);
+});
 program.command("upload").description("Upload an AIReady report JSON to the platform").argument("<file>", "Report JSON file to upload").option("--api-key <key>", "Platform API key").option("--repo-id <id>", "Platform repository ID (optional)").option("--server <url>", "Custom platform URL").addHelpText("after", UPLOAD_HELP_TEXT).action(async (file, options) => {
   await uploadAction(file, options);
 });
+program.command("remediate").description("Suggest AI-ready refactors based on a scan report").argument("[directory]", "Directory to remediate", ".").option("-r, --report <path>", "AIReady report JSON file").option("-t, --tool <name>", "Filter by tool: patterns, context, consistency").option("--server <url>", "Custom platform URL").addHelpText("after", REMEDIATE_HELP_TEXT).action(async (directory, options) => {
+  await remediateAction(directory, options);
+});
 program.command("bug").description("Report a bug or provide feedback (Agent-friendly)").argument("[message]", "Short description of the issue").option("-t, --type <type>", "Issue type: bug, feature, metric", "bug").option("--submit", "Submit the issue directly using the GitHub CLI (gh)").addHelpText("after", BUG_HELP_TEXT).action(async (message, options) => {
   await bugAction(message, options);
 });

package/dist/index.js

@@ -41,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",
@@ -51,7 +52,8 @@ 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"
 };
 var UnifiedOrchestrator = class {
   /**
@@ -200,7 +202,8 @@ var UnifiedOrchestrator = class {
       "testability-index": ["testabilityIndex", "testability"],
       "doc-drift": ["docDrift"],
       "dependency-health": ["dependencyHealth", "deps"],
-      "change-amplification": ["changeAmplification"]
+      "change-amplification": ["changeAmplification"],
+      "contract-enforcement": ["contractEnforcement", "contract"]
     };
     for (const [kebabKey, aliases] of Object.entries(keyMappings)) {
       if (result[kebabKey]) {

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   analyzeUnified,
   generateUnifiedSummary,
   scoreUnified
-} from "./chunk-SK6WW6HW.mjs";
+} from "./chunk-HX6H3VOE.mjs";
 export {
   ScoringOrchestrator,
   TOOL_PACKAGE_MAP,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.14.26",
+  "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.23",
-    "@aiready/context-analyzer": "0.21.27",
-    "@aiready/consistency": "0.20.23",
-    "@aiready/core": "0.23.24",
-    "@aiready/deps": "0.13.24",
-    "@aiready/doc-drift": "0.13.23",
-    "@aiready/change-amplification": "0.13.23",
-    "@aiready/ai-signal-clarity": "0.13.24",
-    "@aiready/visualizer": "0.6.23",
-    "@aiready/pattern-detect": "0.16.23",
-    "@aiready/testability": "0.6.23"
+    "@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",