@aiready/cli 0.13.2 → 0.13.4

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/cli@0.13.2 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,10 +10,10 @@
 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:51:15 pm
+ WARN  ▲ [WARNING] "import.meta" is not available with the "cjs" output format and will be empty [empty-import-meta]            8:48:54 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.
@@ -22,8 +22,8 @@
 
 ESM dist/index.mjs          170.00 B
 ESM dist/chunk-VOKP7FGM.mjs 9.52 KB
-ESM dist/cli.mjs            68.68 KB
-ESM ⚡️ Build success in 30ms
+ESM dist/cli.mjs            72.43 KB
+ESM ⚡️ Build success in 110ms
+CJS dist/cli.js   86.27 KB
 CJS dist/index.js 10.62 KB
-CJS dist/cli.js   82.21 KB
-CJS ⚡️ Build success in 30ms
+CJS ⚡️ Build success in 110ms

package/dist/cli.js

@@ -783,6 +783,15 @@ async function scanAction(directory, options) {
         }
       }
     }
+    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?"));
+    console.log(import_chalk3.default.dim("\u{1F449} Copy/paste this to your AI agent:"));
+    console.log(
+      import_chalk3.default.cyan(
+        `   "Help me report an issue to AIReady. Use 'aiready bug' to prepare a draft."`
+      )
+    );
+    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();
@@ -1713,17 +1722,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."
       )
     );
@@ -1735,15 +1798,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) {
@@ -1760,22 +1823,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) {
@@ -1791,12 +1854,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) {
@@ -1814,11 +1877,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) {
@@ -1838,11 +1901,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 = `
@@ -2030,4 +2093,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

@@ -523,6 +523,15 @@ async function scanAction(directory, options) {
         }
       }
     }
+    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?"));
+    console.log(chalk3.dim("\u{1F449} Copy/paste this to your AI agent:"));
+    console.log(
+      chalk3.cyan(
+        `   "Help me report an issue to AIReady. Use 'aiready bug' to prepare a draft."`
+      )
+    );
+    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();
@@ -1474,8 +1483,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 {
@@ -1484,9 +1547,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."
       )
     );
@@ -1498,15 +1561,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) {
@@ -1523,22 +1586,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) {
@@ -1554,12 +1617,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) {
@@ -1577,11 +1640,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) {
@@ -1601,11 +1664,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 = `
@@ -1792,4 +1855,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.2",
+  "version": "0.13.4",
   "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/consistency": "0.19.0",
     "@aiready/clawmart": "0.1.2",
     "@aiready/context-analyzer": "0.20.0",
-    "@aiready/agent-grounding": "0.12.0",
+    "@aiready/consistency": "0.19.0",
     "@aiready/core": "0.22.1",
-    "@aiready/doc-drift": "0.12.0",
-    "@aiready/change-amplification": "0.12.0",
     "@aiready/deps": "0.12.0",
+    "@aiready/change-amplification": "0.12.0",
+    "@aiready/doc-drift": "0.12.0",
     "@aiready/ai-signal-clarity": "0.12.0",
-    "@aiready/visualizer": "0.5.0",
+    "@aiready/agent-grounding": "0.12.0",
     "@aiready/testability": "0.5.0",
+    "@aiready/visualizer": "0.5.0",
     "@aiready/pattern-detect": "0.15.0"
   },
   "devDependencies": {

package/src/cli.ts

@@ -25,6 +25,8 @@ import {
   clawmartUploadAction,
   clawmartDownloadAction,
   clawmartHelpText,
+  bugAction,
+  bugHelpText,
 } from './commands';
 
 const getDirname = () => {
@@ -379,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

@@ -377,6 +377,24 @@ export async function scanAction(directory: string, options: ScanOptions) {
       }
     }
 
+    console.log(
+      chalk.dim(
+        '\n──────────────────────────────────────────────────────────────────'
+      )
+    );
+    console.log(chalk.dim('💬 Found a bug or have a metric idea?'));
+    console.log(chalk.dim('👉 Copy/paste this to your AI agent:'));
+    console.log(
+      chalk.cyan(
+        `   "Help me report an issue to AIReady. Use 'aiready bug' to prepare a draft."`
+      )
+    );
+    console.log(
+      chalk.dim(
+        '──────────────────────────────────────────────────────────────────'
+      )
+    );
+
     // Normalized report mapping
     const mapToUnifiedReport = (
       res: any,