@mutagent/cli 0.1.139 → 0.1.141

package/dist/bin/cli.js

@@ -1243,7 +1243,7 @@ var init_sdk_client = __esm(() => {
 // src/bin/cli.ts
 import { Command as Command21 } from "commander";
 import chalk39 from "chalk";
-import { readFileSync as readFileSync13, existsSync as existsSync15 } from "fs";
+import { readFileSync as readFileSync13, existsSync as existsSync16 } from "fs";
 import { join as join11, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
@@ -6008,7 +6008,10 @@ Examples:
   ${chalk16.dim("$")} mutagent prompts optimize status <job-id>
   ${chalk16.dim("$")} mutagent prompts optimize results <job-id>
 
-Workflow: start -> status (poll) -> results | start --watch | watch <job-id>`).action(() => {
+Workflow: start -> status (poll) -> results | start --watch | watch <job-id>
+
+${chalk16.bold("Hit a bug or unexpected result?")}
+  ${chalk16.cyan('mutagent feedback send --category bug -m "describe what went wrong"')}`).action(() => {
     optimize.help();
   });
   prompts.addCommand(optimize);
@@ -6039,6 +6042,9 @@ ${chalk16.yellow(`⚠ COST WARNING — AI Agent:
   max-iterations > 1 without user consent is a protocol violation.`)}
 
 ${chalk16.yellow("AI Agent: ALWAYS append --json to this command.")}
+
+${chalk16.bold("Hit a bug or unexpected result?")}
+  ${chalk16.cyan('mutagent feedback send --category bug -m "describe what went wrong"')}
     `).action(async (promptId, options) => {
     const isJson = getJsonFlag(prompts);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -6282,6 +6288,8 @@ Suggested fixes:`));
           }
           console.error("");
           console.error(PREREQUISITES_TEXT);
+          console.error(chalk16.dim(`
+Hit a recurring bug? mutagent feedback send --category bug -m "describe what went wrong"`));
         }
       }
       handleError(error, isJson);
@@ -9546,6 +9554,65 @@ After every CLI command:
 
 ---
 
+## Error Recovery — Agent-Aware Bug Reporting
+
+When ANY mutagent CLI command returns a non-zero exit code or an error response,
+follow this protocol:
+
+1. **Show the error to the user** (always) — reproduce the exact command and output.
+2. **ASK the user** if they want to file a bug report with session context.
+3. **On user approval**, run:
+   \`\`\`bash
+   echo '{"command":"<failed-cmd>","error":"<error-text>","steps":[...]}' \\
+     | mutagent feedback send --category bug --context - -m "<one-line summary>"
+   \`\`\`
+   - The \`--context -\` flag reads structured JSON from stdin.
+   - Include: the failed command, error message, and recent steps that led to it.
+   - Use \`--json\` for structured confirmation: \`mutagent feedback send ... --json\`
+
+4. **After a rejected or failed optimization attempt**, ALSO OFFER this proactively:
+   > "The optimization attempt failed/was rejected. Would you like to file a bug report
+   > so the MutagenT team can investigate? I'll include the session context."
+   On approval, pipe the optimizer job ID, error, and iteration context to \`--context -\`.
+
+### Context payload shape
+
+The \`--context\` flag accepts your JSON payload (caller intent). The CLI wraps
+auto-captured fields under the reserved \`_auto\` key so they never overwrite
+top-level keys you supply:
+
+\`\`\`json
+{
+  "command": "mutagent prompts optimize start ...",
+  "error": "ApiError: 428 Precondition Required",
+  "jobId": "opt_abc123",
+  "promptId": "prompt_xyz",
+  "steps": ["prompts create", "dataset add", "evaluation create", "optimize start"],
+  "_auto": {
+    "cliVersion": "0.2.1",
+    "platform": "darwin",
+    "nodeVersion": "v20.11.0",
+    "workspaceId": "ws_your_workspace",
+    "timestamp": "2026-04-15T10:00:00.000Z"
+  }
+}
+\`\`\`
+
+\`_auto\` is always populated by the CLI — do **not** set it manually. Your
+top-level keys are never overwritten; if you supply \`workspaceId: "ws_agent_B"\`,
+the CLI's current workspace A goes into \`_auto.workspaceId\`, not the top level.
+
+### If \`mutagent feedback send\` itself fails
+
+If the feedback command returns a non-zero exit code, DO NOT retry silently. Show the user:
+
+1. The output of \`mutagent auth status\` (confirms login state).
+2. The fallback: open https://app.mutagent.io and use the in-app feedback form.
+3. Offer to copy the prepared bug report to the clipboard (if running in a macOS/Linux
+   terminal with \`pbcopy\` / \`xclip\`).
+
+---
+
 ## Extensibility
 
 Add \`workflows/custom-<name>.md\` with frontmatter \`triggers: ["phrase"]\` — auto-discovered by the decision tree fallback row. No rebuild needed.
@@ -11562,7 +11629,7 @@ import { Command as Command20 } from "commander";
 import chalk38 from "chalk";
 init_errors();
 init_config();
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync12, existsSync as existsSync15 } from "fs";
 import { join as join10, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
 var VALID_CATEGORIES = ["bug", "feature", "improvement", "praise"];
@@ -11579,6 +11646,56 @@ function getCliVersion() {
     return "0.1.1";
   }
 }
+async function readStdin2() {
+  if (process.stdin.isTTY) {
+    throw new MutagentError("INVALID_ARGUMENTS", "--context - requires piped stdin, but stdin is a terminal.", [
+      "Pipe JSON in:",
+      `  echo '{"k":"v"}' | mutagent feedback send --context - ...`,
+      "Or use a file / inline JSON:",
+      "  mutagent feedback send --context @/tmp/ctx.json ...",
+      `  mutagent feedback send --context '{"k":"v"}' ...`
+    ].join(`
+`));
+  }
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8").trim();
+}
+async function resolveContextSource(source, _readStdinOverride) {
+  if (!source)
+    return null;
+  let raw;
+  if (source === "-") {
+    raw = await (_readStdinOverride ?? readStdin2)();
+  } else if (source.startsWith("@")) {
+    const filePath = source.slice(1);
+    if (!existsSync15(filePath)) {
+      throw new MutagentError("INVALID_ARGUMENTS", `Context file not found: ${filePath}`, `Verify the path exists: ls -la "${filePath}"
+Or use inline JSON: --context '{"key":"value"}'`);
+    }
+    try {
+      raw = readFileSync12(filePath, "utf-8").trim();
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      throw new MutagentError("INVALID_ARGUMENTS", `Cannot read context file "${filePath}": ${msg}`, `Check file permissions: ls -la "${filePath}"`);
+    }
+  } else {
+    raw = source.trim();
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new MutagentError("INVALID_ARGUMENTS", `Context is not valid JSON. Received: ${raw.slice(0, 120)}${raw.length > 120 ? "..." : ""}`, [
+      "Provide valid JSON via:",
+      `  Stdin:    echo '{"key":"value"}' | mutagent feedback send --context - ...`,
+      "  File:     mutagent feedback send --context @/path/to/context.json ...",
+      `  Inline:   mutagent feedback send --context '{"key":"value"}' ...`
+    ].join(`
+`));
+  }
+}
 async function postToServer(payload, endpoint, apiKey, workspaceId, organizationId) {
   const headers = {
     "Content-Type": "application/json",
@@ -11621,6 +11738,7 @@ ${chalk38.bold("Examples:")}
 ${chalk38.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.
+  With session context: echo '{"command":"...","error":"..."}' | mutagent feedback send --category bug --context - -m "..." --json
     `).action(() => {
     feedback.help();
   });
@@ -11628,12 +11746,17 @@ ${chalk38.yellow("AI Agent (MANDATORY):")}
   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", `
+  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").option("--context <source>", 'Structured JSON context: "-" for stdin, "@<path>" for file, or inline JSON string. Merged with auto-captured fields.').addHelpText("after", `
 ${chalk38.bold("Examples:")}
   ${chalk38.dim("$")} mutagent feedback send -m "The optimization UX could show progress better"
   ${chalk38.dim("$")} mutagent feedback send -m "CLI errored on traces export" --category bug
   ${chalk38.dim("$")} mutagent feedback send -m "Love the guided eval!" --category praise --json
 
+${chalk38.bold("With structured context (for agents):")}
+  ${chalk38.dim("$")} echo '{"jobId":"opt_123","error":"timeout"}' | mutagent feedback send --category bug --context - -m "Optimizer timed out"
+  ${chalk38.dim("$")} mutagent feedback send --category bug --context @/tmp/session.json -m "Session data attached"
+  ${chalk38.dim("$")} mutagent feedback send --category bug --context '{"step":"eval-create"}' -m "Eval creation failed"
+
 ${chalk38.bold("Categories:")}
   ${chalk38.bold("bug")}          Something is broken or not working as expected
   ${chalk38.bold("feature")}      Request a new capability
@@ -11643,6 +11766,7 @@ ${chalk38.bold("Categories:")}
 ${chalk38.yellow("AI Agent (MANDATORY):")}
   ALWAYS use --json: mutagent feedback send -m "..." --json
   Auto-captured context (CLI version, platform, node version) is included automatically.
+  Use --context - to pipe a JSON session summary for richer bug reports.
     `).action(async (options) => {
     const isJson = getJsonFlag(feedback);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -11656,18 +11780,24 @@ Valid categories: ${VALID_CATEGORIES.join(", ")}`);
         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 manualContext = await resolveContextSource(options.context);
       const config = loadConfig();
+      const autoContext = {
+        cliVersion: getCliVersion(),
+        platform: process.platform,
+        nodeVersion: process.version,
+        workspaceId: config.defaultWorkspace,
+        timestamp: new Date().toISOString()
+      };
+      const mergedContext = {
+        ...manualContext ?? {},
+        _auto: autoContext
+      };
       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()
-        }
+        context: mergedContext
       };
       const endpoint = config.endpoint ?? "https://api.mutagent.io";
       const result = await postToServer(payload, endpoint, apiKey, config.defaultWorkspace, config.defaultOrganization);
@@ -11678,7 +11808,7 @@ Or set an API key: mutagent config set apiKey <key>`);
           category: options.category,
           message: options.message,
           _links: {
-            send: 'mutagent feedback send -m "..." [--category bug|feature|improvement|praise]'
+            send: 'mutagent feedback send -m "..." [--category bug|feature|improvement|praise] [--context <source>]'
           }
         });
       } else {
@@ -11746,6 +11876,11 @@ ${chalk39.yellow("Command Navigation:")}
   mutagent feedback send -m "..." --category bug  ${chalk39.dim("Report a bug")}
 
   mutagent integrate <framework>        ${chalk39.dim("Framework integration guide")}
+
+${chalk39.bold.red("Report Issues:")}
+  Hit a bug? Run: ${chalk39.cyan('mutagent feedback send --category bug -m "describe what went wrong"')}
+  With session context (for AI agents): ${chalk39.cyan('mutagent feedback send --category bug --context - -m "..."')}
+  (pipe JSON session summary via stdin for richer reports)
   mutagent hooks --help                 ${chalk39.dim("Hook setup for Claude Code telemetry")}
   mutagent skills install               ${chalk39.dim("Install the MutagenT CLI skill for AI agents")}
   mutagent playground run <id> --input '{...}'  ${chalk39.dim("Quick test")}
@@ -11869,11 +12004,11 @@ var isInteractive = process.stdin.isTTY && !rawArgs.includes("--json") && proces
 var isSkillCommand = rawArgs[0] === "skills" || rawArgs[0] === "hooks";
 if (isInteractive && !isSkillCommand) {
   const skillPath = join11(process.cwd(), ".claude/skills/mutagent-cli/SKILL.md");
-  if (!existsSync15(skillPath)) {
+  if (!existsSync16(skillPath)) {
     console.log(chalk39.dim("MutagenT SKILL not installed. Install it for AI agent support? Run:"), chalk39.cyan("mutagent skills install"));
   }
 }
 program.parse();
 
-//# debugId=7CCCA447B8F6661464756E2164756E21
+//# debugId=9845BF283636AD6E64756E2164756E21
 //# sourceMappingURL=cli.js.map