@aiready/cli 0.14.26 → 0.15.0

package/dist/cli.js

@@ -25,8 +25,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli.ts
 var import_commander = require("commander");
-var import_fs8 = require("fs");
-var import_path7 = require("path");
+var import_fs9 = require("fs");
+var import_path8 = require("path");
 var import_url = require("url");
 
 // src/commands/scan.ts
@@ -544,7 +544,8 @@ var SCAN_DEFAULTS = {
     "testability-index",
     "doc-drift",
     "dependency-health",
-    "change-amplification"
+    "change-amplification",
+    "contract-enforcement"
   ],
   include: void 0,
   exclude: void 0,
@@ -602,6 +603,7 @@ var TOOL_PACKAGE_MAP = {
   [import_core7.ToolName.DocDrift]: "@aiready/doc-drift",
   [import_core7.ToolName.DependencyHealth]: "@aiready/deps",
   [import_core7.ToolName.ChangeAmplification]: "@aiready/change-amplification",
+  [import_core7.ToolName.ContractEnforcement]: "@aiready/contract-enforcement",
   // Aliases handled by registry
   patterns: "@aiready/pattern-detect",
   duplicates: "@aiready/pattern-detect",
@@ -612,7 +614,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 {
   /**
@@ -761,7 +764,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]) {
@@ -1075,6 +1079,28 @@ async function scanAction(directory, options) {
       finalOptions,
       results
     );
+    const isCI = options.ci ?? process.env.CI === "true";
+    if (!isCI) {
+      console.log(
+        import_chalk6.default.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(import_chalk6.default.bold("\u{1F4C8} Want to see the full interactive report?"));
+      console.log(
+        import_chalk6.default.cyan(
+          `   Upload this report to: ${import_chalk6.default.bold("https://platform.getaiready.dev")}`
+        )
+      );
+      console.log(
+        import_chalk6.default.dim("   Or run: ") + import_chalk6.default.white(`aiready upload ${outputPath}`)
+      );
+      console.log(
+        import_chalk6.default.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) {
     (0, import_core10.handleCLIError)(error, "Analysis");
   }
@@ -2063,8 +2089,79 @@ async function testabilityAction(directory, options) {
 // src/commands/change-amplification.ts
 var import_cli = require("@aiready/change-amplification/dist/cli.js");
 
-// src/commands/bug.ts
+// src/commands/contract-enforcement.ts
 var import_chalk16 = __toESM(require("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(
+        import_chalk16.default.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 ? import_chalk16.default.green : val >= 60 ? import_chalk16.default.yellow : import_chalk16.default.red;
+          console.log(import_chalk16.default.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(import_chalk16.default.dim(`     ${breakdown}`));
+      }
+      if (score) {
+        renderToolScoreFooter(score);
+      }
+    }
+  });
+}
+
+// src/commands/bug.ts
+var import_chalk17 = __toESM(require("chalk"));
 var import_child_process2 = require("child_process");
 async function bugAction(message, options) {
   const repoUrl = "https://github.com/caopengau/aiready-cli";
@@ -2082,35 +2179,35 @@ Generated via AIReady CLI 'bug' command.
 Type: ${type}
     `.trim();
     if (options.submit) {
-      console.log(import_chalk16.default.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
+      console.log(import_chalk17.default.blue("\u{1F680} Submitting issue via GitHub CLI...\n"));
       try {
         (0, import_child_process2.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 = (0, import_child_process2.execSync)(command, { encoding: "utf8" }).trim();
-        console.log(import_chalk16.default.green("\u2705 Issue Created Successfully!"));
-        console.log(import_chalk16.default.cyan(output));
+        console.log(import_chalk17.default.green("\u2705 Issue Created Successfully!"));
+        console.log(import_chalk17.default.cyan(output));
         return;
       } catch {
-        console.error(import_chalk16.default.red("\n\u274C Failed to submit via gh CLI."));
+        console.error(import_chalk17.default.red("\n\u274C Failed to submit via gh CLI."));
         console.log(
-          import_chalk16.default.yellow(
+          import_chalk17.default.yellow(
             '   Make sure gh is installed and run "gh auth login".\n'
           )
         );
-        console.log(import_chalk16.default.dim("   Falling back to URL generation..."));
+        console.log(import_chalk17.default.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(import_chalk16.default.green("\u{1F680} Issue Draft Prepared!\n"));
-    console.log(import_chalk16.default.bold("Title:  ") + title);
-    console.log(import_chalk16.default.bold("Type:   ") + type);
-    console.log(import_chalk16.default.bold("\nClick the link below to submit this issue:"));
-    console.log(import_chalk16.default.cyan(fullUrl));
-    console.log(import_chalk16.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-    console.log(import_chalk16.default.dim("   You have successfully prepared a report."));
+    console.log(import_chalk17.default.green("\u{1F680} Issue Draft Prepared!\n"));
+    console.log(import_chalk17.default.bold("Title:  ") + title);
+    console.log(import_chalk17.default.bold("Type:   ") + type);
+    console.log(import_chalk17.default.bold("\nClick the link below to submit this issue:"));
+    console.log(import_chalk17.default.cyan(fullUrl));
+    console.log(import_chalk17.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+    console.log(import_chalk17.default.dim("   You have successfully prepared a report."));
     console.log(
-      import_chalk16.default.dim(
+      import_chalk17.default.dim(
         "   Please present the URL above to the user so they can finalize the submission."
       )
     );
@@ -2119,14 +2216,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(import_chalk16.default.blue("\u{1F4AC} Feedback & Bug Reports\n"));
-  console.log(`  Report a Bug:        ${import_chalk16.default.cyan(bugUrl)}`);
-  console.log(`  Request a Feature:   ${import_chalk16.default.cyan(featureUrl)}`);
-  console.log(`  Suggest a Metric:    ${import_chalk16.default.cyan(metricUrl)}`);
-  console.log(import_chalk16.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
-  console.log(import_chalk16.default.dim("   To prepare a specific report, run:"));
+  console.log(import_chalk17.default.blue("\u{1F4AC} Feedback & Bug Reports\n"));
+  console.log(`  Report a Bug:        ${import_chalk17.default.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${import_chalk17.default.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${import_chalk17.default.cyan(metricUrl)}`);
+  console.log(import_chalk17.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+  console.log(import_chalk17.default.dim("   To prepare a specific report, run:"));
   console.log(
-    import_chalk16.default.cyan(
+    import_chalk17.default.cyan(
       '   aiready bug "your description here" --type bug|feature|metric'
     )
   );
@@ -2139,14 +2236,105 @@ EXAMPLES:
   $ aiready bug "Fix typo in scan output" --submit   # Submit directly via gh CLI
 `;
 
+// src/commands/remediate.ts
+var import_chalk18 = __toESM(require("chalk"));
+var import_path7 = require("path");
+var import_fs8 = require("fs");
+var import_core18 = require("@aiready/core");
+async function remediateAction(directory, options) {
+  const resolvedDir = (0, import_path7.resolve)(process.cwd(), directory || ".");
+  const serverUrl = options.server || "https://platform.getaiready.dev";
+  (0, import_core18.printTerminalHeader)("AIREADY REMEDIATION SWARM");
+  console.log(import_chalk18.default.cyan("\u{1F916} Initializing local remediation agent..."));
+  let reportPath = options.report;
+  if (!reportPath) {
+    const aireadyDir = (0, import_path7.resolve)(resolvedDir, ".aiready");
+    if ((0, import_fs8.existsSync)(aireadyDir)) {
+      const files = (0, import_fs8.readdirSync)(aireadyDir).filter((f) => f.startsWith("aiready-report-") && f.endsWith(".json")).sort().reverse();
+      if (files.length > 0) {
+        reportPath = (0, import_path7.resolve)(aireadyDir, files[0]);
+        console.log(import_chalk18.default.dim(`\u{1F4C2} Using latest report: ${files[0]}`));
+      }
+    }
+  }
+  if (!reportPath || !(0, import_fs8.existsSync)(reportPath)) {
+    console.log(import_chalk18.default.yellow("\n\u26A0\uFE0F  No AIReady report found."));
+    console.log(
+      import_chalk18.default.dim(
+        "   Remediation requires a recent scan report to identify issues."
+      )
+    );
+    console.log(import_chalk18.default.white(`   Run ${import_chalk18.default.bold("aiready scan")} first.
+`));
+    return;
+  }
+  console.log(import_chalk18.default.green("\n\u2705 Analysis data loaded."));
+  console.log(import_chalk18.default.bold("\n\u{1F680} Remediation Strategy:"));
+  if (options.tool === "patterns" || !options.tool) {
+    console.log(
+      import_chalk18.default.white(
+        `   \u2022 ${import_chalk18.default.bold("Pattern Consolidation")}: Suggested refactors for 95%+ similar code blocks.`
+      )
+    );
+  }
+  if (options.tool === "consistency" || !options.tool) {
+    console.log(
+      import_chalk18.default.white(
+        `   \u2022 ${import_chalk18.default.bold("Naming Alignment")}: Automated TSDoc generation and constant extraction.`
+      )
+    );
+  }
+  if (options.tool === "context" || !options.tool) {
+    console.log(
+      import_chalk18.default.white(
+        `   \u2022 ${import_chalk18.default.bold("Context Optimization")}: Barrel file cleanup and import flattening.`
+      )
+    );
+  }
+  console.log(
+    import_chalk18.default.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(import_chalk18.default.bold("\u2728 Use the Platform Swarm for Automated Fixes"));
+  console.log(
+    import_chalk18.default.cyan(`   The high-performance Remediation Swarm is available at:`)
+  );
+  console.log(import_chalk18.default.white(`   ${import_chalk18.default.bold(`${serverUrl}/remediate`)}`));
+  console.log(
+    import_chalk18.default.dim(
+      "\n   The swarm uses specialized agents to safely refactor your code,"
+    )
+  );
+  console.log(
+    import_chalk18.default.dim("   ensuring every change improves your AI-readiness score.")
+  );
+  console.log(
+    import_chalk18.default.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(
+    import_chalk18.default.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 import_meta = {};
 var getDirname = () => {
   if (typeof __dirname !== "undefined") return __dirname;
-  return (0, import_path7.dirname)((0, import_url.fileURLToPath)(import_meta.url));
+  return (0, import_path8.dirname)((0, import_url.fileURLToPath)(import_meta.url));
 };
 var packageJson = JSON.parse(
-  (0, import_fs8.readFileSync)((0, import_path7.join)(getDirname(), "../package.json"), "utf8")
+  (0, import_fs9.readFileSync)((0, import_path8.join)(getDirname(), "../package.json"), "utf8")
 );
 var program = new import_commander.Command();
 program.name("aiready").description("AIReady - Assess and improve AI-readiness of codebases").version(packageJson.version).addHelpText(
@@ -2290,9 +2478,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);
 });