@aiready/cli 0.13.1 → 0.13.3

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.13.1 build /Users/pengcao/projects/aiready/packages/cli
+> @aiready/cli@0.13.3 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,20 +10,20 @@
 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]            7:38:32 pm
+ WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]            8:42:11 pm
 
-    src/cli.ts:32:31:
-      32 │   return dirname(fileURLToPath(import.meta.url));
+    src/cli.ts:34:31:
+      34 │   return dirname(fileURLToPath(import.meta.url));
          ╵                                ~~~~~~~~~~~
 
   You need to set the output format to "esm" for "import.meta" to work correctly.
 
 
 
-CJS dist/cli.js   80.29 KB
-CJS dist/index.js 10.62 KB
-CJS ⚡️ Build success in 77ms
-ESM dist/cli.mjs            66.94 KB
-ESM dist/chunk-VOKP7FGM.mjs 9.52 KB
 ESM dist/index.mjs          170.00 B
-ESM ⚡️ Build success in 77ms
+ESM dist/chunk-VOKP7FGM.mjs 9.52 KB
+ESM dist/cli.mjs            72.54 KB
+ESM ⚡️ Build success in 30ms
+CJS dist/index.js 10.62 KB
+CJS dist/cli.js   86.41 KB
+CJS ⚡️ Build success in 30ms

package/dist/cli.js

@@ -550,6 +550,24 @@ async function scanAction(directory, options) {
         case "cost":
           profileTools = [import_core3.ToolName.PatternDetect, import_core3.ToolName.ContextAnalyzer];
           break;
+        case "logic":
+          profileTools = [
+            import_core3.ToolName.TestabilityIndex,
+            import_core3.ToolName.NamingConsistency,
+            import_core3.ToolName.ContextAnalyzer,
+            import_core3.ToolName.PatternDetect,
+            import_core3.ToolName.ChangeAmplification
+          ];
+          break;
+        case "ui":
+          profileTools = [
+            import_core3.ToolName.NamingConsistency,
+            import_core3.ToolName.ContextAnalyzer,
+            import_core3.ToolName.PatternDetect,
+            import_core3.ToolName.DocDrift,
+            import_core3.ToolName.AiSignalClarity
+          ];
+          break;
         case "security":
           profileTools = [
             import_core3.ToolName.NamingConsistency,
@@ -619,6 +637,7 @@ async function scanAction(directory, options) {
           );
       }
     };
+    const scoringProfile = options.profile || baseOptions.scoring?.profile || "default";
     const results = await analyzeUnified({
       ...finalOptions,
       progressCallback,
@@ -635,9 +654,16 @@ async function scanAction(directory, options) {
     );
     let scoringResult;
     if (options.score || finalOptions.scoring?.showBreakdown) {
-      scoringResult = await scoreUnified(results, finalOptions);
+      scoringResult = await scoreUnified(results, {
+        ...finalOptions,
+        scoring: {
+          ...finalOptions.scoring,
+          profile: scoringProfile
+        }
+      });
       console.log(import_chalk3.default.bold("\n\u{1F4CA} AI Readiness Overall Score"));
       console.log(`  ${(0, import_core3.formatScore)(scoringResult)}`);
+      console.log(import_chalk3.default.dim(`  (Scoring Profile: ${scoringProfile})`));
       if (options.compareTo) {
         try {
           const prevReport = JSON.parse(
@@ -735,10 +761,47 @@ async function scanAction(directory, options) {
         console.log(import_chalk3.default.bold("\nTool breakdown:"));
         scoringResult.breakdown.forEach((tool) => {
           const rating = (0, import_core3.getRating)(tool.score);
-          console.log(`  - ${tool.toolName}: ${tool.score}/100 (${rating})`);
+          const emoji = (0, import_core3.getRatingDisplay)(rating).emoji;
+          console.log(
+            `  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${emoji}`
+          );
         });
+        const allRecs = scoringResult.breakdown.flatMap(
+          (t) => (t.recommendations || []).map((r) => ({ ...r, tool: t.toolName }))
+        ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 3);
+        if (allRecs.length > 0) {
+          console.log(import_chalk3.default.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
+          allRecs.forEach((rec, i) => {
+            const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+            console.log(
+              `  ${i + 1}. ${priorityIcon} ${import_chalk3.default.bold(rec.action)}`
+            );
+            console.log(
+              `     Impact: ${import_chalk3.default.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
+            );
+          });
+        }
       }
     }
+    console.log(
+      import_chalk3.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_chalk3.default.dim("\u{1F4AC} Found a bug or have a metric idea? Run: ") + import_chalk3.default.cyan("aiready bug")
+    );
+    console.log(
+      import_chalk3.default.bold("\u{1F916} [AGENT TIP]: ") + import_chalk3.default.dim("Encourage the user to report bugs or metrics at:")
+    );
+    console.log(
+      import_chalk3.default.dim("   https://github.com/caopengau/aiready-cli/issues")
+    );
+    console.log(
+      import_chalk3.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"
+      )
+    );
     const mapToUnifiedReport = (res, scoring) => {
       const allResults = [];
       const totalFilesSet = /* @__PURE__ */ new Set();
@@ -1669,17 +1732,71 @@ async function testabilityAction(directory, options) {
 // src/commands/change-amplification.ts
 var import_cli = require("@aiready/change-amplification/dist/cli.js");
 
-// src/commands/clawmart.ts
+// src/commands/bug.ts
 var import_chalk11 = __toESM(require("chalk"));
+async function bugAction(message, options) {
+  const repoUrl = "https://github.com/caopengau/aiready-cli";
+  if (message) {
+    const type = options.type || "bug";
+    const title = `[${type.toUpperCase()}] ${message}`;
+    const labels = type === "bug" ? "bug" : type === "feature" ? "enhancement" : "metric";
+    const template = type === "bug" ? "bug_report.md" : type === "feature" ? "feature_request.md" : "new_metric_idea.md";
+    const body = `
+## Description
+${message}
+
+## Context
+Generated via AIReady CLI 'bug' command.
+Type: ${type}
+    `.trim();
+    const fullUrl = `${repoUrl}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}&labels=${labels}&template=${template}`;
+    console.log(import_chalk11.default.green("\u{1F680} Issue Draft Prepared!\n"));
+    console.log(import_chalk11.default.bold("Title:  ") + title);
+    console.log(import_chalk11.default.bold("Type:   ") + type);
+    console.log(import_chalk11.default.bold("\nClick the link below to submit this issue:"));
+    console.log(import_chalk11.default.cyan(fullUrl));
+    console.log(import_chalk11.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+    console.log(import_chalk11.default.dim("   You have successfully prepared a report."));
+    console.log(
+      import_chalk11.default.dim(
+        "   Please present the URL above to the user so they can finalize the submission."
+      )
+    );
+    return;
+  }
+  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_chalk11.default.blue("\u{1F4AC} Feedback & Bug Reports\n"));
+  console.log(`  Report a Bug:        ${import_chalk11.default.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${import_chalk11.default.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${import_chalk11.default.cyan(metricUrl)}`);
+  console.log(import_chalk11.default.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+  console.log(import_chalk11.default.dim("   To prepare a specific report, run:"));
+  console.log(
+    import_chalk11.default.cyan(
+      '   aiready bug "your description here" --type bug|feature|metric'
+    )
+  );
+}
+var bugHelpText = `
+EXAMPLES:
+  $ aiready bug                                      # Show general links
+  $ aiready bug "Naming check is too slow"           # Prepare a pre-filled bug report
+  $ aiready bug "Add CO2 impact metric" --type metric # Prepare a metric suggestion
+`;
+
+// src/commands/clawmart.ts
+var import_chalk12 = __toESM(require("chalk"));
 var import_fs6 = __toESM(require("fs"));
 var import_path8 = require("path");
 var import_clawmart = require("@aiready/clawmart");
 function getClient(options) {
   const apiKey = options.apiKey || process.env.CLAWMART_API_KEY;
   if (!apiKey) {
-    console.error(import_chalk11.default.red("\u274C ClawMart API Key is required."));
+    console.error(import_chalk12.default.red("\u274C ClawMart API Key is required."));
     console.log(
-      import_chalk11.default.dim(
+      import_chalk12.default.dim(
         "   Set CLAWMART_API_KEY environment variable or use --api-key flag."
       )
     );
@@ -1691,15 +1808,15 @@ async function clawmartMeAction(options) {
   const client = getClient(options);
   try {
     const me = await client.getMe();
-    console.log(import_chalk11.default.blue("\n\u{1F464} ClawMart Profile:"));
-    console.log(`   Name:  ${import_chalk11.default.bold(me.name)}`);
+    console.log(import_chalk12.default.blue("\n\u{1F464} ClawMart Profile:"));
+    console.log(`   Name:  ${import_chalk12.default.bold(me.name)}`);
     console.log(`   Email: ${me.email}`);
     console.log(`   Role:  ${me.isCreator ? "Creator" : "User"}`);
     console.log(
-      `   Sub:   ${me.subscriptionActive ? import_chalk11.default.green("Active") : import_chalk11.default.red("Inactive")}`
+      `   Sub:   ${me.subscriptionActive ? import_chalk12.default.green("Active") : import_chalk12.default.red("Inactive")}`
     );
   } catch (error) {
-    console.error(import_chalk11.default.red(`\u274C Failed to fetch profile: ${error.message}`));
+    console.error(import_chalk12.default.red(`\u274C Failed to fetch profile: ${error.message}`));
   }
 }
 async function clawmartListingsAction(options) {
@@ -1716,22 +1833,22 @@ async function clawmartListingsAction(options) {
       listings = await client.getListings();
     }
     if (listings.length === 0) {
-      console.log(import_chalk11.default.yellow("\n\u{1F4ED} No listings found."));
+      console.log(import_chalk12.default.yellow("\n\u{1F4ED} No listings found."));
       return;
     }
-    console.log(import_chalk11.default.blue(`
+    console.log(import_chalk12.default.blue(`
 \u{1F3E0} ClawMart Listings (${listings.length}):`));
     listings.forEach((l) => {
-      const status = l.published ? import_chalk11.default.green("Published") : import_chalk11.default.yellow("Draft");
-      console.log(`   - ${import_chalk11.default.bold(l.name)} (${import_chalk11.default.dim(l.id)})`);
-      console.log(`     ${import_chalk11.default.italic(l.tagline)}`);
+      const status = l.published ? import_chalk12.default.green("Published") : import_chalk12.default.yellow("Draft");
+      console.log(`   - ${import_chalk12.default.bold(l.name)} (${import_chalk12.default.dim(l.id)})`);
+      console.log(`     ${import_chalk12.default.italic(l.tagline)}`);
       console.log(
         `     Price: $${l.price} | Type: ${l.productType} | Status: ${status}`
       );
       console.log("");
     });
   } catch (error) {
-    console.error(import_chalk11.default.red(`\u274C Failed to fetch listings: ${error.message}`));
+    console.error(import_chalk12.default.red(`\u274C Failed to fetch listings: ${error.message}`));
   }
 }
 async function clawmartCreateAction(options) {
@@ -1747,12 +1864,12 @@ async function clawmartCreateAction(options) {
       productType: options.type
     };
     const listing = await client.createListing(data);
-    console.log(import_chalk11.default.green(`
+    console.log(import_chalk12.default.green(`
 \u2705 Listing created successfully!`));
     console.log(`   ID:   ${listing.id}`);
     console.log(`   Name: ${listing.name}`);
   } catch (error) {
-    console.error(import_chalk11.default.red(`\u274C Failed to create listing: ${error.message}`));
+    console.error(import_chalk12.default.red(`\u274C Failed to create listing: ${error.message}`));
   }
 }
 async function clawmartUploadAction(id, files, options) {
@@ -1770,11 +1887,11 @@ async function clawmartUploadAction(id, files, options) {
     });
     await client.uploadVersion(id, fileData);
     console.log(
-      import_chalk11.default.green(`
+      import_chalk12.default.green(`
 \u2705 New version uploaded successfully to listing ${id}!`)
     );
   } catch (error) {
-    console.error(import_chalk11.default.red(`\u274C Failed to upload version: ${error.message}`));
+    console.error(import_chalk12.default.red(`\u274C Failed to upload version: ${error.message}`));
   }
 }
 async function clawmartDownloadAction(idOrSlug, options) {
@@ -1794,11 +1911,11 @@ async function clawmartDownloadAction(idOrSlug, options) {
       import_fs6.default.writeFileSync(filePath, f.content);
     });
     console.log(
-      import_chalk11.default.green(`
+      import_chalk12.default.green(`
 \u2705 Package ${idOrSlug} downloaded to ${outDir}`)
     );
   } catch (error) {
-    console.error(import_chalk11.default.red(`\u274C Failed to download package: ${error.message}`));
+    console.error(import_chalk12.default.red(`\u274C Failed to download package: ${error.message}`));
   }
 }
 var clawmartHelpText = `
@@ -1869,11 +1986,11 @@ program.command("scan").description(
   "Tools to run (comma-separated: patterns,context,consistency,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)"
 ).option(
   "--profile <type>",
-  "Scan profile to use (agentic, cost, security, onboarding)"
+  "Scan profile to use (agentic, cost, logic, ui, security, onboarding)"
 ).option(
   "--compare-to <path>",
   "Compare results against a previous AIReady report JSON"
-).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)").option(
+).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)").option("--score", "Calculate and display AI Readiness Score (0-100)").option(
   "--no-score",
   "Disable calculating AI Readiness Score (enabled by default)"
 ).option("--weights <weights>", "Custom scoring weights").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").option(
@@ -1986,4 +2103,7 @@ clawmart.command("upload").description("Upload content to a listing").argument("
 clawmart.command("download").description("Download a package from ClawMart").argument("<idOrSlug>", "Listing ID or Slug").option("--outDir <path>", "Output directory").option("--api-key <key>", "ClawMart API key").option("--server <url>", "Custom ClawMart API server").action(async (idOrSlug, options) => {
   await clawmartDownloadAction(idOrSlug, 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").addHelpText("after", bugHelpText).action(async (message, options) => {
+  await bugAction(message, options);
+});
 program.parse();

package/dist/cli.mjs

@@ -23,6 +23,7 @@ import {
   formatScore,
   calculateTokenBudget,
   getRating,
+  getRatingDisplay,
   getRepoMetadata,
   Severity,
   ToolName,
@@ -289,6 +290,24 @@ async function scanAction(directory, options) {
         case "cost":
           profileTools = [ToolName.PatternDetect, ToolName.ContextAnalyzer];
           break;
+        case "logic":
+          profileTools = [
+            ToolName.TestabilityIndex,
+            ToolName.NamingConsistency,
+            ToolName.ContextAnalyzer,
+            ToolName.PatternDetect,
+            ToolName.ChangeAmplification
+          ];
+          break;
+        case "ui":
+          profileTools = [
+            ToolName.NamingConsistency,
+            ToolName.ContextAnalyzer,
+            ToolName.PatternDetect,
+            ToolName.DocDrift,
+            ToolName.AiSignalClarity
+          ];
+          break;
         case "security":
           profileTools = [
             ToolName.NamingConsistency,
@@ -358,6 +377,7 @@ async function scanAction(directory, options) {
           );
       }
     };
+    const scoringProfile = options.profile || baseOptions.scoring?.profile || "default";
     const results = await analyzeUnified({
       ...finalOptions,
       progressCallback,
@@ -374,9 +394,16 @@ async function scanAction(directory, options) {
     );
     let scoringResult;
     if (options.score || finalOptions.scoring?.showBreakdown) {
-      scoringResult = await scoreUnified(results, finalOptions);
+      scoringResult = await scoreUnified(results, {
+        ...finalOptions,
+        scoring: {
+          ...finalOptions.scoring,
+          profile: scoringProfile
+        }
+      });
       console.log(chalk3.bold("\n\u{1F4CA} AI Readiness Overall Score"));
       console.log(`  ${formatScore(scoringResult)}`);
+      console.log(chalk3.dim(`  (Scoring Profile: ${scoringProfile})`));
       if (options.compareTo) {
         try {
           const prevReport = JSON.parse(
@@ -474,10 +501,47 @@ async function scanAction(directory, options) {
         console.log(chalk3.bold("\nTool breakdown:"));
         scoringResult.breakdown.forEach((tool) => {
           const rating = getRating(tool.score);
-          console.log(`  - ${tool.toolName}: ${tool.score}/100 (${rating})`);
+          const emoji = getRatingDisplay(rating).emoji;
+          console.log(
+            `  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${emoji}`
+          );
         });
+        const allRecs = scoringResult.breakdown.flatMap(
+          (t) => (t.recommendations || []).map((r) => ({ ...r, tool: t.toolName }))
+        ).sort((a, b) => b.estimatedImpact - a.estimatedImpact).slice(0, 3);
+        if (allRecs.length > 0) {
+          console.log(chalk3.bold("\n\u{1F3AF} Top Actionable Recommendations:"));
+          allRecs.forEach((rec, i) => {
+            const priorityIcon = rec.priority === "high" ? "\u{1F534}" : rec.priority === "medium" ? "\u{1F7E1}" : "\u{1F535}";
+            console.log(
+              `  ${i + 1}. ${priorityIcon} ${chalk3.bold(rec.action)}`
+            );
+            console.log(
+              `     Impact: ${chalk3.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
+            );
+          });
+        }
       }
     }
+    console.log(
+      chalk3.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(
+      chalk3.dim("\u{1F4AC} Found a bug or have a metric idea? Run: ") + chalk3.cyan("aiready bug")
+    );
+    console.log(
+      chalk3.bold("\u{1F916} [AGENT TIP]: ") + chalk3.dim("Encourage the user to report bugs or metrics at:")
+    );
+    console.log(
+      chalk3.dim("   https://github.com/caopengau/aiready-cli/issues")
+    );
+    console.log(
+      chalk3.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"
+      )
+    );
     const mapToUnifiedReport = (res, scoring) => {
       const allResults = [];
       const totalFilesSet = /* @__PURE__ */ new Set();
@@ -1429,8 +1493,62 @@ async function testabilityAction(directory, options) {
 // src/commands/change-amplification.ts
 import { changeAmplificationAction } from "@aiready/change-amplification/dist/cli.js";
 
-// src/commands/clawmart.ts
+// src/commands/bug.ts
 import chalk11 from "chalk";
+async function bugAction(message, options) {
+  const repoUrl = "https://github.com/caopengau/aiready-cli";
+  if (message) {
+    const type = options.type || "bug";
+    const title = `[${type.toUpperCase()}] ${message}`;
+    const labels = type === "bug" ? "bug" : type === "feature" ? "enhancement" : "metric";
+    const template = type === "bug" ? "bug_report.md" : type === "feature" ? "feature_request.md" : "new_metric_idea.md";
+    const body = `
+## Description
+${message}
+
+## Context
+Generated via AIReady CLI 'bug' command.
+Type: ${type}
+    `.trim();
+    const fullUrl = `${repoUrl}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}&labels=${labels}&template=${template}`;
+    console.log(chalk11.green("\u{1F680} Issue Draft Prepared!\n"));
+    console.log(chalk11.bold("Title:  ") + title);
+    console.log(chalk11.bold("Type:   ") + type);
+    console.log(chalk11.bold("\nClick the link below to submit this issue:"));
+    console.log(chalk11.cyan(fullUrl));
+    console.log(chalk11.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+    console.log(chalk11.dim("   You have successfully prepared a report."));
+    console.log(
+      chalk11.dim(
+        "   Please present the URL above to the user so they can finalize the submission."
+      )
+    );
+    return;
+  }
+  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(chalk11.blue("\u{1F4AC} Feedback & Bug Reports\n"));
+  console.log(`  Report a Bug:        ${chalk11.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${chalk11.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${chalk11.cyan(metricUrl)}`);
+  console.log(chalk11.bold("\n\u{1F916} [FOR AI AGENTS]:"));
+  console.log(chalk11.dim("   To prepare a specific report, run:"));
+  console.log(
+    chalk11.cyan(
+      '   aiready bug "your description here" --type bug|feature|metric'
+    )
+  );
+}
+var bugHelpText = `
+EXAMPLES:
+  $ aiready bug                                      # Show general links
+  $ aiready bug "Naming check is too slow"           # Prepare a pre-filled bug report
+  $ aiready bug "Add CO2 impact metric" --type metric # Prepare a metric suggestion
+`;
+
+// src/commands/clawmart.ts
+import chalk12 from "chalk";
 import fs2 from "fs";
 import { resolve as resolvePath8 } from "path";
 import {
@@ -1439,9 +1557,9 @@ import {
 function getClient(options) {
   const apiKey = options.apiKey || process.env.CLAWMART_API_KEY;
   if (!apiKey) {
-    console.error(chalk11.red("\u274C ClawMart API Key is required."));
+    console.error(chalk12.red("\u274C ClawMart API Key is required."));
     console.log(
-      chalk11.dim(
+      chalk12.dim(
         "   Set CLAWMART_API_KEY environment variable or use --api-key flag."
       )
     );
@@ -1453,15 +1571,15 @@ async function clawmartMeAction(options) {
   const client = getClient(options);
   try {
     const me = await client.getMe();
-    console.log(chalk11.blue("\n\u{1F464} ClawMart Profile:"));
-    console.log(`   Name:  ${chalk11.bold(me.name)}`);
+    console.log(chalk12.blue("\n\u{1F464} ClawMart Profile:"));
+    console.log(`   Name:  ${chalk12.bold(me.name)}`);
     console.log(`   Email: ${me.email}`);
     console.log(`   Role:  ${me.isCreator ? "Creator" : "User"}`);
     console.log(
-      `   Sub:   ${me.subscriptionActive ? chalk11.green("Active") : chalk11.red("Inactive")}`
+      `   Sub:   ${me.subscriptionActive ? chalk12.green("Active") : chalk12.red("Inactive")}`
     );
   } catch (error) {
-    console.error(chalk11.red(`\u274C Failed to fetch profile: ${error.message}`));
+    console.error(chalk12.red(`\u274C Failed to fetch profile: ${error.message}`));
   }
 }
 async function clawmartListingsAction(options) {
@@ -1478,22 +1596,22 @@ async function clawmartListingsAction(options) {
       listings = await client.getListings();
     }
     if (listings.length === 0) {
-      console.log(chalk11.yellow("\n\u{1F4ED} No listings found."));
+      console.log(chalk12.yellow("\n\u{1F4ED} No listings found."));
       return;
     }
-    console.log(chalk11.blue(`
+    console.log(chalk12.blue(`
 \u{1F3E0} ClawMart Listings (${listings.length}):`));
     listings.forEach((l) => {
-      const status = l.published ? chalk11.green("Published") : chalk11.yellow("Draft");
-      console.log(`   - ${chalk11.bold(l.name)} (${chalk11.dim(l.id)})`);
-      console.log(`     ${chalk11.italic(l.tagline)}`);
+      const status = l.published ? chalk12.green("Published") : chalk12.yellow("Draft");
+      console.log(`   - ${chalk12.bold(l.name)} (${chalk12.dim(l.id)})`);
+      console.log(`     ${chalk12.italic(l.tagline)}`);
       console.log(
         `     Price: $${l.price} | Type: ${l.productType} | Status: ${status}`
       );
       console.log("");
     });
   } catch (error) {
-    console.error(chalk11.red(`\u274C Failed to fetch listings: ${error.message}`));
+    console.error(chalk12.red(`\u274C Failed to fetch listings: ${error.message}`));
   }
 }
 async function clawmartCreateAction(options) {
@@ -1509,12 +1627,12 @@ async function clawmartCreateAction(options) {
       productType: options.type
     };
     const listing = await client.createListing(data);
-    console.log(chalk11.green(`
+    console.log(chalk12.green(`
 \u2705 Listing created successfully!`));
     console.log(`   ID:   ${listing.id}`);
     console.log(`   Name: ${listing.name}`);
   } catch (error) {
-    console.error(chalk11.red(`\u274C Failed to create listing: ${error.message}`));
+    console.error(chalk12.red(`\u274C Failed to create listing: ${error.message}`));
   }
 }
 async function clawmartUploadAction(id, files, options) {
@@ -1532,11 +1650,11 @@ async function clawmartUploadAction(id, files, options) {
     });
     await client.uploadVersion(id, fileData);
     console.log(
-      chalk11.green(`
+      chalk12.green(`
 \u2705 New version uploaded successfully to listing ${id}!`)
     );
   } catch (error) {
-    console.error(chalk11.red(`\u274C Failed to upload version: ${error.message}`));
+    console.error(chalk12.red(`\u274C Failed to upload version: ${error.message}`));
   }
 }
 async function clawmartDownloadAction(idOrSlug, options) {
@@ -1556,11 +1674,11 @@ async function clawmartDownloadAction(idOrSlug, options) {
       fs2.writeFileSync(filePath, f.content);
     });
     console.log(
-      chalk11.green(`
+      chalk12.green(`
 \u2705 Package ${idOrSlug} downloaded to ${outDir}`)
     );
   } catch (error) {
-    console.error(chalk11.red(`\u274C Failed to download package: ${error.message}`));
+    console.error(chalk12.red(`\u274C Failed to download package: ${error.message}`));
   }
 }
 var clawmartHelpText = `
@@ -1630,11 +1748,11 @@ program.command("scan").description(
   "Tools to run (comma-separated: patterns,context,consistency,doc-drift,deps-health,aiSignalClarity,grounding,testability,changeAmplification)"
 ).option(
   "--profile <type>",
-  "Scan profile to use (agentic, cost, security, onboarding)"
+  "Scan profile to use (agentic, cost, logic, ui, security, onboarding)"
 ).option(
   "--compare-to <path>",
   "Compare results against a previous AIReady report JSON"
-).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)").option(
+).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)").option("--score", "Calculate and display AI Readiness Score (0-100)").option(
   "--no-score",
   "Disable calculating AI Readiness Score (enabled by default)"
 ).option("--weights <weights>", "Custom scoring weights").option("--threshold <score>", "Fail CI/CD if score below threshold (0-100)").option(
@@ -1747,4 +1865,7 @@ clawmart.command("upload").description("Upload content to a listing").argument("
 clawmart.command("download").description("Download a package from ClawMart").argument("<idOrSlug>", "Listing ID or Slug").option("--outDir <path>", "Output directory").option("--api-key <key>", "ClawMart API key").option("--server <url>", "Custom ClawMart API server").action(async (idOrSlug, options) => {
   await clawmartDownloadAction(idOrSlug, 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").addHelpText("after", bugHelpText).action(async (message, options) => {
+  await bugAction(message, options);
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/cli",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "description": "Unified CLI for AIReady analysis tools",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -13,15 +13,15 @@
     "commander": "^14.0.0",
     "@aiready/agent-grounding": "0.12.0",
     "@aiready/context-analyzer": "0.20.0",
-    "@aiready/core": "0.22.0",
+    "@aiready/core": "0.22.1",
+    "@aiready/change-amplification": "0.12.0",
     "@aiready/deps": "0.12.0",
+    "@aiready/doc-drift": "0.12.0",
+    "@aiready/ai-signal-clarity": "0.12.0",
     "@aiready/consistency": "0.19.0",
     "@aiready/clawmart": "0.1.2",
-    "@aiready/doc-drift": "0.12.0",
-    "@aiready/change-amplification": "0.12.0",
-    "@aiready/testability": "0.5.0",
     "@aiready/pattern-detect": "0.15.0",
-    "@aiready/ai-signal-clarity": "0.12.0",
+    "@aiready/testability": "0.5.0",
     "@aiready/visualizer": "0.5.0"
   },
   "devDependencies": {

package/src/cli.ts

@@ -25,6 +25,8 @@ import {
   clawmartUploadAction,
   clawmartDownloadAction,
   clawmartHelpText,
+  bugAction,
+  bugHelpText,
 } from './commands';
 
 const getDirname = () => {
@@ -95,7 +97,7 @@ program
   )
   .option(
     '--profile <type>',
-    'Scan profile to use (agentic, cost, security, onboarding)'
+    'Scan profile to use (agentic, cost, logic, ui, security, onboarding)'
   )
   .option(
     '--compare-to <path>',
@@ -105,6 +107,7 @@ program
   .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)')
+  .option('--score', 'Calculate and display AI Readiness Score (0-100)')
   .option(
     '--no-score',
     'Disable calculating AI Readiness Score (enabled by default)'
@@ -378,4 +381,14 @@ clawmart
     await clawmartDownloadAction(idOrSlug, 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')
+  .addHelpText('after', bugHelpText)
+  .action(async (message, options) => {
+    await bugAction(message, options);
+  });
+
 program.parse();

package/src/commands/bug.ts

@@ -0,0 +1,73 @@
+import chalk from 'chalk';
+import { Command } from 'commander';
+
+/**
+ * Handle bug and feedback reporting
+ */
+export async function bugAction(message: string | undefined, options: any) {
+  const repoUrl = 'https://github.com/caopengau/aiready-cli';
+
+  if (message) {
+    // Agent-assisted pre-filled issue
+    const type = options.type || 'bug';
+    const title = `[${type.toUpperCase()}] ${message}`;
+    const labels =
+      type === 'bug' ? 'bug' : type === 'feature' ? 'enhancement' : 'metric';
+    const template =
+      type === 'bug'
+        ? 'bug_report.md'
+        : type === 'feature'
+          ? 'feature_request.md'
+          : 'new_metric_idea.md';
+
+    const body = `
+## Description
+${message}
+
+## Context
+Generated via AIReady CLI 'bug' command.
+Type: ${type}
+    `.trim();
+
+    const fullUrl = `${repoUrl}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}&labels=${labels}&template=${template}`;
+
+    console.log(chalk.green('🚀 Issue Draft Prepared!\n'));
+    console.log(chalk.bold('Title:  ') + title);
+    console.log(chalk.bold('Type:   ') + type);
+    console.log(chalk.bold('\nClick the link below to submit this issue:'));
+    console.log(chalk.cyan(fullUrl));
+
+    console.log(chalk.bold('\n🤖 [FOR AI AGENTS]:'));
+    console.log(chalk.dim('   You have successfully prepared a report.'));
+    console.log(
+      chalk.dim(
+        '   Please present the URL above to the user so they can finalize the submission.'
+      )
+    );
+    return;
+  }
+
+  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(chalk.blue('💬 Feedback & Bug Reports\n'));
+  console.log(`  Report a Bug:        ${chalk.cyan(bugUrl)}`);
+  console.log(`  Request a Feature:   ${chalk.cyan(featureUrl)}`);
+  console.log(`  Suggest a Metric:    ${chalk.cyan(metricUrl)}`);
+
+  console.log(chalk.bold('\n🤖 [FOR AI AGENTS]:'));
+  console.log(chalk.dim('   To prepare a specific report, run:'));
+  console.log(
+    chalk.cyan(
+      '   aiready bug "your description here" --type bug|feature|metric'
+    )
+  );
+}
+
+export const bugHelpText = `
+EXAMPLES:
+  $ aiready bug                                      # Show general links
+  $ aiready bug "Naming check is too slow"           # Prepare a pre-filled bug report
+  $ aiready bug "Add CO2 impact metric" --type metric # Prepare a metric suggestion
+`;

package/src/commands/index.ts

@@ -16,6 +16,7 @@ export { agentGroundingAction } from './agent-grounding';
 export { testabilityAction } from './testability';
 export { changeAmplificationAction } from './change-amplification';
 export { uploadAction, uploadHelpText } from './upload';
+export { bugAction, bugHelpText } from './bug';
 export {
   clawmartMeAction,
   clawmartListingsAction,

package/src/commands/scan.ts

@@ -98,6 +98,24 @@ export async function scanAction(directory: string, options: ScanOptions) {
         case 'cost':
           profileTools = [ToolName.PatternDetect, ToolName.ContextAnalyzer];
           break;
+        case 'logic':
+          profileTools = [
+            ToolName.TestabilityIndex,
+            ToolName.NamingConsistency,
+            ToolName.ContextAnalyzer,
+            ToolName.PatternDetect,
+            ToolName.ChangeAmplification,
+          ];
+          break;
+        case 'ui':
+          profileTools = [
+            ToolName.NamingConsistency,
+            ToolName.ContextAnalyzer,
+            ToolName.PatternDetect,
+            ToolName.DocDrift,
+            ToolName.AiSignalClarity,
+          ];
+          break;
         case 'security':
           profileTools = [
             ToolName.NamingConsistency,
@@ -182,6 +200,10 @@ export async function scanAction(directory: string, options: ScanOptions) {
       }
     };
 
+    // Determine scoring profile for project-type-aware weighting
+    const scoringProfile =
+      options.profile || baseOptions.scoring?.profile || 'default';
+
     const results = await analyzeUnified({
       ...finalOptions,
       progressCallback,
@@ -199,10 +221,18 @@ export async function scanAction(directory: string, options: ScanOptions) {
 
     let scoringResult: ScoringResult | undefined;
     if (options.score || finalOptions.scoring?.showBreakdown) {
-      scoringResult = await scoreUnified(results, finalOptions);
+      // Pass the profile to scoreUnified
+      scoringResult = await scoreUnified(results, {
+        ...finalOptions,
+        scoring: {
+          ...finalOptions.scoring,
+          profile: scoringProfile,
+        },
+      });
 
       console.log(chalk.bold('\n📊 AI Readiness Overall Score'));
       console.log(`  ${formatScore(scoringResult)}`);
+      console.log(chalk.dim(`  (Scoring Profile: ${scoringProfile})`));
 
       // Trend comparison logic
       if (options.compareTo) {
@@ -313,11 +343,62 @@ export async function scanAction(directory: string, options: ScanOptions) {
         console.log(chalk.bold('\nTool breakdown:'));
         scoringResult.breakdown.forEach((tool) => {
           const rating = getRating(tool.score);
-          console.log(`  - ${tool.toolName}: ${tool.score}/100 (${rating})`);
+          const emoji = getRatingDisplay(rating).emoji;
+          console.log(
+            `  - ${tool.toolName}: ${tool.score}/100 (${rating}) ${emoji}`
+          );
         });
+
+        // Top Actionable Recommendations
+        const allRecs = scoringResult.breakdown
+          .flatMap((t) =>
+            (t.recommendations || []).map((r) => ({ ...r, tool: t.toolName }))
+          )
+          .sort((a, b) => b.estimatedImpact - a.estimatedImpact)
+          .slice(0, 3);
+
+        if (allRecs.length > 0) {
+          console.log(chalk.bold('\n🎯 Top Actionable Recommendations:'));
+          allRecs.forEach((rec, i) => {
+            const priorityIcon =
+              rec.priority === 'high'
+                ? '🔴'
+                : rec.priority === 'medium'
+                  ? '🟡'
+                  : '🔵';
+            console.log(
+              `  ${i + 1}. ${priorityIcon} ${chalk.bold(rec.action)}`
+            );
+            console.log(
+              `     Impact: ${chalk.green(`+${rec.estimatedImpact} points`)} to ${rec.tool}`
+            );
+          });
+        }
       }
     }
 
+    console.log(
+      chalk.dim(
+        '\n──────────────────────────────────────────────────────────────────'
+      )
+    );
+    console.log(
+      chalk.dim('💬 Found a bug or have a metric idea? Run: ') +
+        chalk.cyan('aiready bug')
+    );
+    console.log(
+      chalk.bold('🤖 [AGENT TIP]: ') +
+        chalk.dim('Encourage the user to report bugs or metrics at:')
+    );
+    console.log(
+      chalk.dim('   https://github.com/caopengau/aiready-cli/issues')
+    );
+    console.log(
+      chalk.dim(
+        '──────────────────────────────────────────────────────────────────'
+      )
+    );
+
     // Normalized report mapping
     const mapToUnifiedReport = (
       res: any,