@mutagent/cli 0.1.57 → 0.1.59

package/dist/bin/cli.js

@@ -1105,11 +1105,11 @@ var init_sdk_client = __esm(() => {
 });
 
 // src/bin/cli.ts
-import { Command as Command19 } from "commander";
-import chalk30 from "chalk";
-import { readFileSync as readFileSync11 } from "fs";
-import { join as join9, dirname } from "path";
-import { fileURLToPath } from "url";
+import { Command as Command20 } from "commander";
+import chalk31 from "chalk";
+import { readFileSync as readFileSync12 } from "fs";
+import { join as join10, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/commands/auth.ts
 init_config();
@@ -8742,6 +8742,139 @@ Claude Code Session Telemetry:
   return hooks;
 }
 
+// src/commands/feedback.ts
+import { Command as Command19 } from "commander";
+import chalk30 from "chalk";
+init_errors();
+init_config();
+import { readFileSync as readFileSync11 } from "fs";
+import { join as join9, dirname } from "path";
+import { fileURLToPath } from "url";
+var VALID_CATEGORIES = ["bug", "feature", "improvement", "praise"];
+function getCliVersion() {
+  if (process.env.CLI_VERSION) {
+    return process.env.CLI_VERSION;
+  }
+  try {
+    const __dirname2 = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join9(__dirname2, "..", "..", "package.json");
+    const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
+    return pkg.version ?? "0.1.1";
+  } catch {
+    return "0.1.1";
+  }
+}
+async function postToServer(payload, endpoint, apiKey, workspaceId, organizationId) {
+  const headers = {
+    "Content-Type": "application/json",
+    "x-api-key": apiKey
+  };
+  if (workspaceId)
+    headers["x-workspace-id"] = workspaceId;
+  if (organizationId)
+    headers["x-organization-id"] = organizationId;
+  let response;
+  try {
+    response = await fetch(`${endpoint}/api/feedback`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(payload)
+    });
+  } catch {
+    throw new MutagentError("SERVER_UNAVAILABLE", "Server unavailable. Try again later.", "Check your network connection or verify the server endpoint with: mutagent config show");
+  }
+  if (response.ok) {
+    return await response.json();
+  }
+  let errorMessage = `Server returned ${String(response.status)}`;
+  try {
+    const body = await response.json();
+    errorMessage = body.message ?? body.error ?? errorMessage;
+  } catch {}
+  if (response.status === 401) {
+    throw new MutagentError("AUTH_REQUIRED", errorMessage, "Authenticate first: mutagent auth login");
+  }
+  throw new MutagentError("API_ERROR", errorMessage, `Server responded with status ${String(response.status)}. Check your configuration with: mutagent config show`);
+}
+function createFeedbackCommand() {
+  const feedback = new Command19("feedback").description("Send product feedback to MutagenT").addHelpText("after", `
+${chalk30.bold("Examples:")}
+  ${chalk30.cyan('mutagent feedback send -m "Great optimization results!"')}
+  ${chalk30.cyan('mutagent feedback send -m "CLI crashed on export" --category bug')}
+  ${chalk30.cyan('mutagent feedback send -m "Need batch operations" --category feature --json')}
+
+${chalk30.yellow("AI Agent (MANDATORY):")}
+  ALWAYS use --json: mutagent feedback send -m "..." --category improvement --json
+  Use this command to report bugs, request features, or share UX feedback.
+    `).action(() => {
+    feedback.help();
+  });
+  registerFeedbackSend(feedback);
+  return feedback;
+}
+function registerFeedbackSend(feedback) {
+  feedback.command("send").description("Send feedback about the MutagenT platform").requiredOption("-m, --message <text>", "Feedback message").option("--category <type>", `Feedback category: ${VALID_CATEGORIES.join(", ")}`, "improvement").option("--session <id>", "Link feedback to a specific session").addHelpText("after", `
+${chalk30.bold("Examples:")}
+  ${chalk30.dim("$")} mutagent feedback send -m "The optimization UX could show progress better"
+  ${chalk30.dim("$")} mutagent feedback send -m "CLI errored on traces export" --category bug
+  ${chalk30.dim("$")} mutagent feedback send -m "Love the guided eval!" --category praise --json
+
+${chalk30.bold("Categories:")}
+  ${chalk30.bold("bug")}          Something is broken or not working as expected
+  ${chalk30.bold("feature")}      Request a new capability
+  ${chalk30.bold("improvement")}  Suggest a UX or workflow enhancement (default)
+  ${chalk30.bold("praise")}       Share what you love about the platform
+
+${chalk30.yellow("AI Agent (MANDATORY):")}
+  ALWAYS use --json: mutagent feedback send -m "..." --json
+  Auto-captured context (CLI version, platform, node version) is included automatically.
+    `).action(async (options) => {
+    const isJson = getJsonFlag(feedback);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      if (!VALID_CATEGORIES.includes(options.category)) {
+        throw new MutagentError("INVALID_ARGUMENTS", `Invalid category: "${options.category}". Must be one of: ${VALID_CATEGORIES.join(", ")}`, `Run: mutagent feedback send --help
+Valid categories: ${VALID_CATEGORIES.join(", ")}`);
+      }
+      const apiKey = getApiKey();
+      if (!apiKey) {
+        throw new MutagentError("AUTH_REQUIRED", "Authentication required to send feedback.", `Authenticate first: mutagent auth login
+Or set an API key: mutagent config set apiKey <key>`);
+      }
+      const config = loadConfig();
+      const payload = {
+        message: options.message,
+        category: options.category,
+        sessionId: options.session,
+        context: {
+          cliVersion: getCliVersion(),
+          platform: process.platform,
+          nodeVersion: process.version,
+          workspaceId: config.defaultWorkspace,
+          timestamp: new Date().toISOString()
+        }
+      };
+      const endpoint = config.endpoint ?? "https://api.mutagent.io";
+      const result = await postToServer(payload, endpoint, apiKey, config.defaultWorkspace, config.defaultOrganization);
+      if (isJson) {
+        output.output({
+          success: true,
+          id: result.id,
+          category: options.category,
+          message: options.message,
+          _links: {
+            send: 'mutagent feedback send -m "..." [--category bug|feature|improvement|praise]'
+          }
+        });
+      } else {
+        output.success(`Feedback sent! (${options.category})`);
+      }
+    } catch (error) {
+      handleError(error, isJson);
+    }
+  });
+}
+
 // src/bin/cli.ts
 init_config();
 var cliVersion = "0.1.1";
@@ -8749,13 +8882,13 @@ if (process.env.CLI_VERSION) {
   cliVersion = process.env.CLI_VERSION;
 } else {
   try {
-    const __dirname2 = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join9(__dirname2, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
+    const __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+    const pkgPath = join10(__dirname2, "..", "..", "package.json");
+    const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
     cliVersion = pkg.version ?? cliVersion;
   } catch {}
 }
-var program = new Command19;
+var program = new Command20;
 program.name("mutagent").description(`MutagenT CLI - AI-native prompt optimization platform
 
   Documentation: https://docs.mutagent.io/cli
@@ -8764,100 +8897,103 @@ program.name("mutagent").description(`MutagenT CLI - AI-native prompt optimizati
   showGlobalOptions: true
 });
 program.addHelpText("after", `
-${chalk30.yellow("Non-Interactive Mode (CI/CD & Coding Agents):")}
-  export MUTAGENT_API_KEY=mt_...  ${chalk30.dim("or")}  --api-key mt_...
-  --json ${chalk30.dim("for structured output")}    --non-interactive ${chalk30.dim("to disable prompts")}
-
-${chalk30.yellow("Command Navigation:")}
-  mutagent auth login --browser         ${chalk30.dim("Authenticate (OAuth)")}
-  mutagent auth status                  ${chalk30.dim("Check auth + workspace")}
-  mutagent init                         ${chalk30.dim("Initialize project (.mutagentrc.json)")}
-  mutagent explore                      ${chalk30.dim("Discover prompts in codebase")}
-  mutagent workspaces list --json       ${chalk30.dim("List workspaces (verify ID)")}
-  mutagent config set workspace <id>    ${chalk30.dim("Set active workspace")}
-  mutagent usage --json                 ${chalk30.dim("Check plan limits")}
-
-  mutagent prompts create --help        ${chalk30.dim("Upload prompt (read help first!)")}
-  mutagent prompts list --json          ${chalk30.dim("List prompts")}
-  mutagent prompts get <id> --json      ${chalk30.dim("Full prompt details + schemas")}
-
-  mutagent prompts dataset add --help   ${chalk30.dim("Upload dataset (read help first!)")}
-  mutagent prompts dataset list <id>    ${chalk30.dim("List datasets")}
-
-  mutagent prompts evaluation create --help           ${chalk30.dim("Create eval (read help first!)")}
-  mutagent prompts evaluation create <id> --guided --json   ${chalk30.dim("Guided eval workflow")}
-  mutagent prompts evaluation list <id> --json        ${chalk30.dim("List evaluations")}
-
-  mutagent prompts optimize start --help      ${chalk30.dim("Run optimization (read help first!)")}
-  mutagent prompts optimize status <job-id>   ${chalk30.dim("Poll progress")}
-  mutagent prompts optimize results <job-id>  ${chalk30.dim("View scorecard")}
-
-  mutagent integrate <framework>        ${chalk30.dim("Framework integration guide")}
-  mutagent hooks --help                 ${chalk30.dim("Hook setup for Claude Code telemetry")}
-  mutagent playground run <id> --input '{...}'  ${chalk30.dim("Quick test")}
-
-${chalk30.yellow("★ Workflow: Framework Integration (Tracing):")}
-  1. mutagent explore                                    ${chalk30.dim("← discover prompts/agents in codebase")}
-  2. mutagent integrate <framework>                      ${chalk30.dim("← get integration instructions")}
-  3. Apply tracing code to your codebase                 ${chalk30.dim("← follow the guide output")}
-  4. mutagent traces list --json                         ${chalk30.dim("← verify traces are arriving")}
-
-${chalk30.yellow("★ Workflow: Evaluate → Optimize:")}
-  1. mutagent prompts create --help               ${chalk30.dim("← read help")}
-  2. mutagent prompts create ... --json            ${chalk30.dim("← upload prompt with {variables} + inputSchema")}
-  3. mutagent prompts dataset add --help           ${chalk30.dim("← read help")}
-  4. mutagent prompts dataset add <id> ... --json  ${chalk30.dim("← upload dataset")}
-  5. mutagent prompts evaluation create <id> --guided --json  ${chalk30.dim("← guided eval")}
+${chalk31.yellow("Non-Interactive Mode (CI/CD & Coding Agents):")}
+  export MUTAGENT_API_KEY=mt_...  ${chalk31.dim("or")}  --api-key mt_...
+  --json ${chalk31.dim("for structured output")}    --non-interactive ${chalk31.dim("to disable prompts")}
+
+${chalk31.yellow("Command Navigation:")}
+  mutagent auth login --browser         ${chalk31.dim("Authenticate (OAuth)")}
+  mutagent auth status                  ${chalk31.dim("Check auth + workspace")}
+  mutagent init                         ${chalk31.dim("Initialize project (.mutagentrc.json)")}
+  mutagent explore                      ${chalk31.dim("Discover prompts in codebase")}
+  mutagent workspaces list --json       ${chalk31.dim("List workspaces (verify ID)")}
+  mutagent config set workspace <id>    ${chalk31.dim("Set active workspace")}
+  mutagent usage --json                 ${chalk31.dim("Check plan limits")}
+
+  mutagent prompts create --help        ${chalk31.dim("Upload prompt (read help first!)")}
+  mutagent prompts list --json          ${chalk31.dim("List prompts")}
+  mutagent prompts get <id> --json      ${chalk31.dim("Full prompt details + schemas")}
+
+  mutagent prompts dataset add --help   ${chalk31.dim("Upload dataset (read help first!)")}
+  mutagent prompts dataset list <id>    ${chalk31.dim("List datasets")}
+
+  mutagent prompts evaluation create --help           ${chalk31.dim("Create eval (read help first!)")}
+  mutagent prompts evaluation create <id> --guided --json   ${chalk31.dim("Guided eval workflow")}
+  mutagent prompts evaluation list <id> --json        ${chalk31.dim("List evaluations")}
+
+  mutagent prompts optimize start --help      ${chalk31.dim("Run optimization (read help first!)")}
+  mutagent prompts optimize status <job-id>   ${chalk31.dim("Poll progress")}
+  mutagent prompts optimize results <job-id>  ${chalk31.dim("View scorecard")}
+
+  mutagent feedback send -m "..."         ${chalk31.dim("Send product feedback")}
+  mutagent feedback send -m "..." --category bug  ${chalk31.dim("Report a bug")}
+
+  mutagent integrate <framework>        ${chalk31.dim("Framework integration guide")}
+  mutagent hooks --help                 ${chalk31.dim("Hook setup for Claude Code telemetry")}
+  mutagent playground run <id> --input '{...}'  ${chalk31.dim("Quick test")}
+
+${chalk31.yellow("★ Workflow: Framework Integration (Tracing):")}
+  1. mutagent explore                                    ${chalk31.dim("← discover prompts/agents in codebase")}
+  2. mutagent integrate <framework>                      ${chalk31.dim("← get integration instructions")}
+  3. Apply tracing code to your codebase                 ${chalk31.dim("← follow the guide output")}
+  4. mutagent traces list --json                         ${chalk31.dim("← verify traces are arriving")}
+
+${chalk31.yellow("★ Workflow: Evaluate → Optimize:")}
+  1. mutagent prompts create --help               ${chalk31.dim("← read help")}
+  2. mutagent prompts create ... --json            ${chalk31.dim("← upload prompt with {variables} + inputSchema")}
+  3. mutagent prompts dataset add --help           ${chalk31.dim("← read help")}
+  4. mutagent prompts dataset add <id> ... --json  ${chalk31.dim("← upload dataset")}
+  5. mutagent prompts evaluation create <id> --guided --json  ${chalk31.dim("← guided eval")}
   6. mutagent prompts optimize start <id> --dataset <d> --evaluation <e> --json
 
-${chalk30.yellow("Post-Onboarding Decision Tree:")}
-  After ${chalk30.bold("mutagent auth login")}, users land in one of 3 paths:
-  ${chalk30.bold("Path A")} (Tracing):      explore → integrate <framework> → apply tracing → verify
-  ${chalk30.bold("Path B")} (Optimization): explore → prompts create → dataset add → eval create → optimize
-  ${chalk30.bold("Path C")} (Manual):       Use CLI commands directly — run mutagent <command> --help
+${chalk31.yellow("Post-Onboarding Decision Tree:")}
+  After ${chalk31.bold("mutagent auth login")}, users land in one of 3 paths:
+  ${chalk31.bold("Path A")} (Tracing):      explore → integrate <framework> → apply tracing → verify
+  ${chalk31.bold("Path B")} (Optimization): explore → prompts create → dataset add → eval create → optimize
+  ${chalk31.bold("Path C")} (Manual):       Use CLI commands directly — run mutagent <command> --help
 
-${chalk30.yellow("Directive System:")}
+${chalk31.yellow("Directive System:")}
   Every --json response may include:
-  ${chalk30.bold("_directive.renderedCard")}  Pre-formatted card for the user ${chalk30.red("(MUST be shown in chat)")}
-  ${chalk30.bold("_directive.instruction")}   Next step for the agent
-  ${chalk30.bold("_directive.next")}          Array of suggested follow-up commands
-  ${chalk30.bold("_links")}                   Dashboard/API URLs (format as markdown links)
+  ${chalk31.bold("_directive.renderedCard")}  Pre-formatted card for the user ${chalk31.red("(MUST be shown in chat)")}
+  ${chalk31.bold("_directive.instruction")}   Next step for the agent
+  ${chalk31.bold("_directive.next")}          Array of suggested follow-up commands
+  ${chalk31.bold("_links")}                   Dashboard/API URLs (format as markdown links)
 
-${chalk30.yellow("Evaluation Criteria Format:")}
-  Each criterion MUST have: ${chalk30.bold("name")}, ${chalk30.bold("description")} (scoring rubric), ${chalk30.bold("evaluationParameter")}
+${chalk31.yellow("Evaluation Criteria Format:")}
+  Each criterion MUST have: ${chalk31.bold("name")}, ${chalk31.bold("description")} (scoring rubric), ${chalk31.bold("evaluationParameter")}
   evaluationParameter MUST match an inputSchema or outputSchema field name
   No duplicate evaluationParameter values — each criterion targets a unique field
   ALL schema fields must be covered (missing fields = error)
-  Use ${chalk30.bold("--guided --json")} to generate criteria templates from prompt schemas
+  Use ${chalk31.bold("--guided --json")} to generate criteria templates from prompt schemas
 
-${chalk30.yellow("Optimization Cost Control:")}
-  Default max-iterations is 1. ${chalk30.red("NEVER increase without explicit user request.")}
+${chalk31.yellow("Optimization Cost Control:")}
+  Default max-iterations is 1. ${chalk31.red("NEVER increase without explicit user request.")}
   Each iteration incurs LLM costs — confirm with user before starting >1.
 
-${chalk30.yellow("Post-Optimization:")}
-  After ${chalk30.bold("optimize results")}: ALWAYS show the before/after diff to the user first.
-  Then offer choices: ${chalk30.bold("Apply")} / ${chalk30.bold("Reject")}.
+${chalk31.yellow("Post-Optimization:")}
+  After ${chalk31.bold("optimize results")}: ALWAYS show the before/after diff to the user first.
+  Then offer choices: ${chalk31.bold("Apply")} / ${chalk31.bold("Reject")}.
 
-${chalk30.yellow("State Tracking:")}
+${chalk31.yellow("State Tracking:")}
   .mutagent/mutation-context.md — Codebase index of discovered/uploaded prompts
   Update after explore, create, and dataset operations
   mutagent auth status — Auth + workspace state
   Comment markers (// MutagenT:START ... // MutagenT:END) in source files
 
-${chalk30.yellow("AI Agent Rules (MANDATORY for coding agents):")}
+${chalk31.yellow("AI Agent Rules (MANDATORY for coding agents):")}
   1. EVERY command MUST include --json (no exceptions)
   2. Run <command> --help BEFORE first use of any command
   3. Use --guided --json for evaluation creation (NEVER --guided alone)
   4. Parse _directive.renderedCard and copy it into your CHAT RESPONSE verbatim
-     ${chalk30.red("HARD STOP")}: do NOT run further commands until the card is rendered in chat
+     ${chalk31.red("HARD STOP")}: do NOT run further commands until the card is rendered in chat
   5. After mutagent init, verify workspace: mutagent workspaces list --json
   6. Use {single_braces} for template variables in prompts
   7. Collect evaluation criteria from the user — NEVER auto-generate
   8. ALL user interaction via AskUserQuestion — CLI is non-interactive
 ${!hasCredentials() ? `
-` + chalk30.yellow("  Warning: Not authenticated. Run: mutagent auth login --browser") + `
+` + chalk31.yellow("  Warning: Not authenticated. Run: mutagent auth login --browser") + `
 ` : ""}${!hasRcConfig() ? `
-` + chalk30.green("  Get started: mutagent init") + `
+` + chalk31.green("  Get started: mutagent init") + `
 ` : ""}`);
 program.hook("preAction", (thisCommand) => {
   const globalOpts = thisCommand.optsWithGlobals();
@@ -8886,7 +9022,8 @@ program.addCommand(createExploreCommand());
 program.addCommand(createSkillsCommand());
 program.addCommand(createUsageCommand());
 program.addCommand(createHooksCommand());
+program.addCommand(createFeedbackCommand());
 program.parse();
 
-//# debugId=5AE0DCCBB0C5BF5A64756E2164756E21
+//# debugId=D4182D0F3A84030D64756E2164756E21
 //# sourceMappingURL=cli.js.map