@mutagent/cli 0.1.21 → 0.1.23

package/dist/bin/cli.js

@@ -21,7 +21,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/bin/cli.ts
 import { Command as Command15 } from "commander";
 import chalk18 from "chalk";
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 import { join as join7, dirname } from "path";
 import { fileURLToPath } from "url";
 
@@ -515,10 +515,10 @@ class SDKClientWrapper {
       });
       let itemCount = 0;
       if (items && items.length > 0) {
-        const mappedItems = items.map((item) => ({
+        const mappedItems = items.map((item, index) => ({
           input: item.input ?? item,
           expectedOutput: item.expectedOutput ?? item.expected_output ?? undefined,
-          name: item.name,
+          name: item.name ?? `Item ${String(index + 1)}`,
           userFeedback: item.userFeedback,
           systemFeedback: item.systemFeedback,
           labels: item.labels,
@@ -552,13 +552,19 @@ class SDKClientWrapper {
       this.handleError(error);
     }
   }
+  async getEvaluation(evaluationId) {
+    try {
+      return await this.request(`/api/prompts/evaluations/${evaluationId}`);
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
   async createEvaluation(promptId, data) {
     try {
       return await this.request("/api/prompts/evaluations", {
         method: "POST",
         body: JSON.stringify({
           promptId: parseInt(promptId, 10),
-          datasetId: data.datasetId,
           name: data.name,
           description: data.description,
           evalConfig: data.evalConfig,
@@ -578,12 +584,13 @@ class SDKClientWrapper {
       this.handleError(error);
     }
   }
-  async startOptimization(promptId, datasetId, config) {
+  async startOptimization(promptId, datasetId, evaluationId, config) {
     try {
       return await this.request(`/api/prompt/${promptId}/optimize`, {
         method: "POST",
         body: JSON.stringify({
           datasetId: parseInt(datasetId, 10),
+          evaluationId: parseInt(evaluationId, 10),
           config: {
             maxIterations: config?.maxIterations ?? 1,
             targetScore: config?.targetScore ?? 0.8,
@@ -1812,16 +1819,16 @@ function runOptimizationPath(promptCount, datasetCount) {
     console.log("");
   }
   if (datasetCount === 0) {
-    console.log(`    ${String(step)}. ${chalk2.green("mutagent prompts dataset add <prompt-id> --file dataset.json")}`);
+    console.log(`    ${String(step)}. ${chalk2.green(`mutagent prompts dataset add <prompt-id> -d '[{"input":{...},"expectedOutput":{...}}]' --name "my-dataset"`)}`);
     console.log("       Upload a dataset with input/output pairs");
     console.log("");
     step++;
   } else {
     console.log(chalk2.dim(`    ${chalk2.green("✓")} Datasets detected in codebase (${String(datasetCount)} found)`));
-    console.log(chalk2.dim(`      Upload one: mutagent prompts dataset add <prompt-id> --file <path>`));
+    console.log(chalk2.dim(`      Upload one: mutagent prompts dataset add <prompt-id> -d '[...]' --name "my-dataset"`));
     console.log("");
   }
-  console.log(`    ${String(step)}. ${chalk2.green('mutagent prompts evaluation create <prompt-id> --name "My Eval" --file criteria.json')}`);
+  console.log(`    ${String(step)}. ${chalk2.green(`mutagent prompts evaluation create <prompt-id> --name "My Eval" -d '{"evalConfig":{"criteria":[...]}}'`)}`);
   console.log("       Define evaluation criteria");
   console.log("");
   step++;
@@ -1838,15 +1845,13 @@ function createAuthCommand() {
 Examples:
   ${chalk3.dim("$")} mutagent auth login
   ${chalk3.dim("$")} mutagent auth login --browser
-  ${chalk3.dim("$")} mutagent auth login --api-key <key>
   ${chalk3.dim("$")} mutagent auth status
   ${chalk3.dim("$")} mutagent auth logout
     `);
-  auth.command("login").description("Authenticate and store API key").option("--api-key <key>", "API key (non-interactive)").option("--browser", "Force browser-based authentication").option("--non-interactive", "Disable interactive prompts (auto-selects browser auth)").option("--endpoint <url>", "API endpoint", "https://api.mutagent.io").addHelpText("after", `
+  auth.command("login").description("Authenticate and store API key").option("--browser", "Force browser-based authentication").option("--non-interactive", "Disable interactive prompts (auto-selects browser auth)").option("--endpoint <url>", "API endpoint", "https://api.mutagent.io").addHelpText("after", `
 Examples:
   ${chalk3.dim("$")} mutagent auth login                    ${chalk3.dim("# Interactive (choose method)")}
   ${chalk3.dim("$")} mutagent auth login --browser          ${chalk3.dim("# Browser OAuth flow")}
-  ${chalk3.dim("$")} mutagent auth login --api-key mg_live_xxx  ${chalk3.dim("# Direct API key (CI/CD)")}
   ${chalk3.dim("$")} mutagent auth login --non-interactive  ${chalk3.dim("# Auto browser flow (AI agents)")}
 
 Environment Variables:
@@ -1859,7 +1864,7 @@ Environment Variables:
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
       const wasFirstLogin = !hasCredentials();
-      let apiKey = options.apiKey ?? process.env.MUTAGENT_API_KEY;
+      let apiKey = process.env.MUTAGENT_API_KEY;
       let endpoint = process.env.MUTAGENT_ENDPOINT ?? options.endpoint;
       let workspaceName;
       let organizationName;
@@ -1892,7 +1897,7 @@ Environment Variables:
       }
       const isNonInteractive = options.nonInteractive === true || process.env.MUTAGENT_NON_INTERACTIVE === "true" || process.env.CI === "true" || !process.stdin.isTTY;
       if (isJson && !options.browser && isNonInteractive) {
-        throw new MutagentError("INTERACTIVE_REQUIRED", "No API key provided. Use --api-key flag, set MUTAGENT_API_KEY env var, or add --browser for browser auth.", "Run: mutagent auth login --api-key <key> or mutagent auth login --browser --non-interactive");
+        throw new MutagentError("INTERACTIVE_REQUIRED", "No API key provided. Set MUTAGENT_API_KEY env var or add --browser for browser auth.", "Run: export MUTAGENT_API_KEY=<key> or mutagent auth login --browser --non-interactive");
       }
       if (!isNonInteractive && !hasCredentials()) {
         console.log(`
@@ -1906,7 +1911,7 @@ Environment Variables:
         output.info("Non-interactive environment detected. Using browser authentication.");
         useLocalBrowserAuth = true;
       }
-      if (!useLocalBrowserAuth && !options.apiKey) {
+      if (!useLocalBrowserAuth) {
         const methodAnswer = await inquirer.prompt([
           {
             type: "list",
@@ -2093,7 +2098,7 @@ Examples:
         statusResult.remediation = {
           interactive: "mutagent auth login --browser",
           nonInteractive: "export MUTAGENT_API_KEY=<your-key>",
-          ciCd: "mutagent auth login --api-key <key>"
+          ciCd: "export MUTAGENT_API_KEY=<key>"
         };
       }
       output.output(statusResult);
@@ -2114,7 +2119,7 @@ Examples:
         console.error("Authentication required. Options:");
         console.error("  Interactive:     mutagent auth login --browser");
         console.error("  Non-interactive: export MUTAGENT_API_KEY=<your-key>");
-        console.error("  CI/CD:           mutagent auth login --api-key <key>");
+        console.error("  CI/CD:           export MUTAGENT_API_KEY=<key>");
       }
       if (hasOnboarding) {
         output.success("Onboarding: Complete (.mutagentrc.json found)");
@@ -2156,17 +2161,20 @@ import inquirer2 from "inquirer";
 import chalk4 from "chalk";
 import ora2 from "ora";
 function createLoginCommand() {
-  const login = new Command2("login").description("Login to MutagenT platform").option("--api-key <key>", "API key (non-interactive)").option("--browser", "Force browser-based authentication").option("--non-interactive", "Disable interactive prompts (auto-selects browser auth)").option("--endpoint <url>", "API endpoint", "https://api.mutagent.io").addHelpText("after", `
+  const login = new Command2("login").description("Login to MutagenT platform").option("--browser", "Force browser-based authentication").option("--non-interactive", "Disable interactive prompts (auto-selects browser auth)").option("--endpoint <url>", "API endpoint", "https://api.mutagent.io").addHelpText("after", `
 Examples:
   ${chalk4.dim("$")} mutagent login
   ${chalk4.dim("$")} mutagent login --browser
-  ${chalk4.dim("$")} mutagent login --api-key <key>
   ${chalk4.dim("$")} mutagent login --non-interactive  ${chalk4.dim("# Auto browser flow (AI agents)")}
+
+Environment Variables:
+  MUTAGENT_API_KEY              API key (skips interactive login)
+  MUTAGENT_ENDPOINT             Custom API endpoint
     `).action(async (options) => {
     const isJson = getJsonFlag(login);
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
-      const apiKey = options.apiKey ?? process.env.MUTAGENT_API_KEY;
+      const apiKey = process.env.MUTAGENT_API_KEY;
       const endpoint = process.env.MUTAGENT_ENDPOINT ?? options.endpoint;
       if (apiKey) {
         output.info("Validating API key...");
@@ -2183,7 +2191,7 @@ Examples:
       }
       const isNonInteractive = options.nonInteractive === true || process.env.MUTAGENT_NON_INTERACTIVE === "true" || process.env.CI === "true" || !process.stdin.isTTY;
       if (isJson && !options.browser && isNonInteractive) {
-        throw new MutagentError("INTERACTIVE_REQUIRED", "No API key provided. Use --api-key flag, set MUTAGENT_API_KEY env var, or add --browser for browser auth.", "Run: mutagent login --api-key <key> or mutagent login --browser --non-interactive");
+        throw new MutagentError("INTERACTIVE_REQUIRED", "No API key provided. Set MUTAGENT_API_KEY env var or add --browser for browser auth.", "Run: export MUTAGENT_API_KEY=<key> or mutagent login --browser --non-interactive");
       }
       if (!isNonInteractive && !hasCredentials()) {
         console.log(`
@@ -2197,7 +2205,7 @@ Examples:
         output.info("Non-interactive environment detected. Using browser authentication.");
         useBrowserAuth = true;
       }
-      if (!useBrowserAuth && !options.apiKey) {
+      if (!useBrowserAuth) {
         const methodAnswer = await inquirer2.prompt([
           {
             type: "list",
@@ -2408,7 +2416,7 @@ function promptCreatedDirective(promptId, name) {
     },
     next: [
       `mutagent prompts evaluation create ${String(promptId)} --guided`,
-      `mutagent prompts dataset add ${String(promptId)} --file data.jsonl`
+      `mutagent prompts dataset add ${String(promptId)} -d '[...]' --name "my-dataset"`
     ],
     instruction: CARD_INSTRUCTION
   };
@@ -2487,7 +2495,6 @@ function evaluationCreatedDirective(promptId, evalId, name, criteriaCount) {
       api: `/api/prompts/${String(promptId)}/evaluations/${String(evalId)}`
     },
     next: [
-      `mutagent prompts dataset add ${String(promptId)} --file data.jsonl`,
       `mutagent prompts optimize start ${String(promptId)} --dataset <dataset-id>`
     ],
     instruction: CARD_INSTRUCTION
@@ -2558,7 +2565,7 @@ function formatSchemaWarning(fieldName) {
     "    }",
     "  }",
     "",
-    "  You can also provide a schema file: mutagent prompts create --file schema.json"
+    `  You can also provide a schema via --data: mutagent prompts create -d '{"inputSchema":{...},"outputSchema":{...}}'`
   ].join(`
 `);
 }
@@ -2842,49 +2849,15 @@ function warnSingleBraceVariables(content, output) {
     }
   }
 }
-function parseDatasetFile(rawContent, filePath) {
-  const trimmed = rawContent.trim();
-  if (filePath.endsWith(".csv")) {
-    return rawContent;
-  }
-  if (trimmed.startsWith("[")) {
-    try {
-      const parsed = JSON.parse(trimmed);
-      if (!Array.isArray(parsed)) {
-        throw new MutagentError("INVALID_JSON", "Expected a JSON array in dataset file", "Dataset JSON files should contain an array of objects: [{...}, {...}]");
-      }
-      return trimmed;
-    } catch (e) {
-      if (e instanceof MutagentError)
-        throw e;
-      throw new MutagentError("INVALID_JSON", `Failed to parse JSON array from ${filePath}`, "Ensure the file contains valid JSON. For line-delimited JSON, use .jsonl extension or put one object per line.");
-    }
-  }
-  const lines = trimmed.split(`
-`).filter((line) => line.trim().length > 0);
-  const items = [];
-  for (let i = 0;i < lines.length; i++) {
-    const line = lines[i];
-    if (!line)
-      continue;
-    const trimmedLine = line.trim();
-    try {
-      items.push(JSON.parse(trimmedLine));
-    } catch {
-      throw new MutagentError("INVALID_JSONL", `Invalid JSON on line ${String(i + 1)} of ${filePath}`, `Each line must be valid JSON. Problem line: "${trimmedLine.substring(0, 80)}${trimmedLine.length > 80 ? "..." : ""}"`);
-    }
-  }
-  return JSON.stringify(items);
-}
 function createPromptsCommand() {
   const prompts = new Command3("prompts").description("Manage prompts, datasets, evaluations, and optimizations").addHelpText("after", `
 Examples:
   ${chalk6.dim("$")} mutagent prompts list
   ${chalk6.dim("$")} mutagent prompts get <prompt-id>
-  ${chalk6.dim("$")} mutagent prompts create --file prompt.json
+  ${chalk6.dim("$")} mutagent prompts create --name "my-prompt" --system "You are helpful" --human "{{input}}"
   ${chalk6.dim("$")} mutagent prompts dataset list <prompt-id>
   ${chalk6.dim("$")} mutagent prompts evaluation create <prompt-id> --name "My Eval"
-  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id>
+  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --evaluation <eval-id>
 
 Subcommands:
   list, get, create, update, delete
@@ -2972,12 +2945,11 @@ ${chalk6.dim("Tip: Combine --with-datasets and --with-evals to fetch all nested
       handleError(error, isJson);
     }
   });
-  prompts.command("create").description("Create a new prompt").option("-d, --data <json>", "Prompt as JSON string (recommended — curl-style inline)").option("-f, --file <path>", "Create from JSON file").option("--raw-file <path>", "Create from plain text file (used as rawPrompt)").option("-n, --name <name>", "Prompt name").option("-c, --content <content>", "Prompt content (rawPrompt) [DEPRECATED: use --raw]").option("-r, --raw <text>", "Raw prompt text (single prompt)").option("--system <text>", "System prompt (use with --human)").option("--human <text>", "Human prompt (use with --system)").option("--messages <json>", `Messages array as JSON (e.g., '[{"role":"system","content":"..."}]')`).option("--output-schema <json>", "Output schema as JSON string (required for optimization)").addHelpText("after", `
+  prompts.command("create").description("Create a new prompt").option("-d, --data <json>", "Prompt as JSON string (recommended — curl-style inline)").option("--raw-file <path>", "Create from plain text file (used as rawPrompt)").option("-n, --name <name>", "Prompt name").option("--description <text>", "Prompt description (shown in dashboard)").option("-c, --content <content>", "Prompt content (rawPrompt) [DEPRECATED: use --raw]").option("-r, --raw <text>", "Raw prompt text (single prompt)").option("--system <text>", "System prompt (use with --human)").option("--human <text>", "Human prompt (use with --system)").option("--messages <json>", `Messages array as JSON (e.g., '[{"role":"system","content":"..."}]')`).option("--output-schema <json>", "Output schema as JSON string (required for optimization)").addHelpText("after", `
 Examples:
-  ${chalk6.dim("$")} mutagent prompts create --name "my-prompt" --system "You are helpful" --human "{{input}}" --output-schema '{"type":"object","properties":{"result":{"type":"string","description":"The result"}}}'
+  ${chalk6.dim("$")} mutagent prompts create --name "my-prompt" --description "Greeting prompt for customers" --system "You are helpful" --human "{{input}}" --output-schema '{"type":"object","properties":{"result":{"type":"string","description":"The result"}}}'
   ${chalk6.dim("$")} mutagent prompts create --name "raw-prompt" --raw "Summarize: {{text}}" --output-schema '{"type":"object","properties":{"summary":{"type":"string","description":"Summary"}}}'
   ${chalk6.dim("$")} mutagent prompts create -d '{"name":"summarizer","systemPrompt":"Summarize","humanPrompt":"{{text}}","outputSchema":{"type":"object","properties":{"summary":{"type":"string","description":"Summary"}}}}'
-  ${chalk6.dim("$")} mutagent prompts create --file prompt.json  ${chalk6.dim("# full prompt object as JSON file")}
 
 Prompt Input Methods (pick one, priority order):
   --system/--human   Structured system + user message pair ${chalk6.green("(recommended)")}
@@ -2985,21 +2957,16 @@ Prompt Input Methods (pick one, priority order):
   -d, --data         Inline JSON object (CI/scripts/agents)
   --messages         Full messages array as JSON
   --raw-file         Load plain text file as raw prompt
-  --file             Load from JSON file (full prompt object)
 
 Expected JSON (--data):
   ${chalk6.dim(`'{"name":"my-prompt","systemPrompt":"You are...","humanPrompt":"{{input}}","outputSchema":{"type":"object","properties":{"result":{"type":"string","description":"The result"}}},"inputSchema":{"type":"object","properties":{"input":{"type":"string","description":"User input"}}}}'`)}
 
-${chalk6.yellow("Note: Prefer --system/--human or --data over --file to avoid stale files living in your repo.")}
-${chalk6.red("outputSchema is required.")} ${chalk6.dim("--data and --file are mutually exclusive.")}
+${chalk6.red("outputSchema is required.")}
     `).action(async (options) => {
     const isJson = getJsonFlag(prompts);
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
       let data;
-      if (options.data && options.file) {
-        throw new MutagentError("INVALID_ARGUMENTS", "Cannot use --data and --file together", "Use --data for inline JSON or --file for file-based input, not both");
-      }
       if (options.data) {
         try {
           data = JSON.parse(options.data);
@@ -3008,9 +2975,8 @@ ${chalk6.red("outputSchema is required.")} ${chalk6.dim("--data and --file are m
         }
         if (options.name)
           data.name = options.name;
-      } else if (options.file) {
-        const content = readFileSync4(options.file, "utf-8");
-        data = JSON.parse(content);
+        if (options.description)
+          data.description = options.description;
       } else if (options.rawFile) {
         if (!existsSync4(options.rawFile)) {
           throw new MutagentError("FILE_NOT_FOUND", `File not found: ${options.rawFile}`, "Check the file path and try again");
@@ -3018,10 +2984,11 @@ ${chalk6.red("outputSchema is required.")} ${chalk6.dim("--data and --file are m
         const textContent = readFileSync4(options.rawFile, "utf-8");
         data = {
           name: options.name ?? options.rawFile.replace(/^.*[\\/]/, "").replace(/\.[^.]+$/, ""),
+          description: options.description,
           rawPrompt: textContent
         };
       } else if (options.name) {
-        data = { name: options.name };
+        data = { name: options.name, description: options.description };
         if (options.messages) {
           try {
             const messages = JSON.parse(options.messages);
@@ -3044,10 +3011,10 @@ ${chalk6.red("outputSchema is required.")} ${chalk6.dim("--data and --file are m
         } else if (options.content) {
           data.rawPrompt = options.content;
         } else {
-          throw new MutagentError("MISSING_ARGUMENTS", "Prompt content required", "Use --data, --raw, --raw-file, --system/--human, or --messages to specify prompt content");
+          throw new MutagentError("MISSING_ARGUMENTS", "Prompt content required", "Use --data, --raw-file, --raw, --system/--human, or --messages to specify prompt content");
         }
       } else {
-        throw new MutagentError("MISSING_ARGUMENTS", "Either --data, --file, --raw-file, or --name with prompt content is required", "Use --data for inline JSON, --file to load from JSON, --raw-file for plain text, or provide --name with --raw, --system/--human, or --messages");
+        throw new MutagentError("MISSING_ARGUMENTS", "Either --data, --raw-file, or --name with prompt content is required", "Use --data for inline JSON, --raw-file for plain text, or provide --name with --raw, --system/--human, or --messages");
       }
       const promptContent = data.rawPrompt ?? data.systemPrompt ?? data.humanPrompt ?? "";
       if (promptContent && !isJson) {
@@ -3061,10 +3028,10 @@ ${chalk6.red("outputSchema is required.")} ${chalk6.dim("--data and --file are m
         }
       }
       if (isSchemaEmpty(data.outputSchema)) {
-        throw new MutagentError("MISSING_ARGUMENTS", "outputSchema is required for prompt creation", `Use --output-schema '{"type":"object","properties":{...}}' or include outputSchema in --data/--file`);
+        throw new MutagentError("MISSING_ARGUMENTS", "outputSchema is required for prompt creation", `Use --output-schema '{"type":"object","properties":{...}}' or include outputSchema in --data`);
       }
       if (isSchemaEmpty(data.inputSchema)) {
-        throw new MutagentError("VALIDATION_ERROR", "inputSchema is required. Optimization cannot run without defined input variables.", `Provide inputSchema via --data or --file. Example:
+        throw new MutagentError("VALIDATION_ERROR", "inputSchema is required. Optimization cannot run without defined input variables.", `Provide inputSchema via --data. Example:
 ` + `  --data '{"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"User query"}}}}'`);
       } else if (!isValidJsonSchema(data.inputSchema)) {
         throw new MutagentError("VALIDATION_ERROR", "inputSchema is not a valid JSON Schema object.", formatSchemaWarning("inputSchema"));
@@ -3095,37 +3062,32 @@ ${chalk6.red("outputSchema is required.")} ${chalk6.dim("--data and --file are m
         });
         console.log(hints);
       }
-      const sourceFile = options.file ?? options.rawFile;
-      if (sourceFile) {
+      if (options.rawFile) {
+        const rawFilePath = options.rawFile;
         updateMutationContext((ctx) => {
           const preview = (data.rawPrompt ?? data.systemPrompt ?? data.name ?? "").slice(0, 50);
-          ctx.addDiscoveredPrompt(sourceFile, 1, preview);
-          ctx.markPromptUploaded(sourceFile, String(prompt.id), prompt.version);
+          ctx.addDiscoveredPrompt(rawFilePath, 1, preview);
+          ctx.markPromptUploaded(rawFilePath, String(prompt.id), prompt.version);
         });
       }
     } catch (error) {
       handleError(error, isJson);
     }
   });
-  prompts.command("update").description("Update a prompt").argument("<id>", "Prompt ID (from: mutagent prompts list)").option("-d, --data <json>", "Update fields as JSON string (recommended — curl-style inline)").option("-f, --file <path>", "Update from JSON file").option("--raw-file <path>", "Update from plain text file (used as rawPrompt)").option("-n, --name <name>", "New name").option("-c, --content <content>", "New content (rawPrompt) [DEPRECATED: use --raw]").option("-r, --raw <text>", "Raw prompt text (single prompt)").option("--system <text>", "System prompt (use with --human)").option("--human <text>", "Human prompt (use with --system)").option("--messages <json>", `Messages array as JSON (e.g., '[{"role":"system","content":"..."}]')`).option("--input-schema <json>", "Input schema as JSON string").option("--input-schema-file <path>", "Input schema from JSON file").option("--output-schema <json>", "Output schema as JSON string").option("--output-schema-file <path>", "Output schema from JSON file").addHelpText("after", `
+  prompts.command("update").description("Update a prompt").argument("<id>", "Prompt ID (from: mutagent prompts list)").option("-d, --data <json>", "Update fields as JSON string (recommended — curl-style inline)").option("--raw-file <path>", "Update from plain text file (used as rawPrompt)").option("-n, --name <name>", "New name").option("--description <text>", "New description (shown in dashboard)").option("-c, --content <content>", "New content (rawPrompt) [DEPRECATED: use --raw]").option("-r, --raw <text>", "Raw prompt text (single prompt)").option("--system <text>", "System prompt (use with --human)").option("--human <text>", "Human prompt (use with --system)").option("--messages <json>", `Messages array as JSON (e.g., '[{"role":"system","content":"..."}]')`).option("--input-schema <json>", "Input schema as JSON string").option("--input-schema-file <path>", "Input schema from JSON file").option("--output-schema <json>", "Output schema as JSON string").option("--output-schema-file <path>", "Output schema from JSON file").addHelpText("after", `
 Examples:
   ${chalk6.dim("$")} mutagent prompts update <id> --system "Updated system prompt" --human "{{input}}"
-  ${chalk6.dim("$")} mutagent prompts update <id> --name "new-name"
+  ${chalk6.dim("$")} mutagent prompts update <id> --name "new-name" --description "Updated description"
   ${chalk6.dim("$")} mutagent prompts update <id> --raw "Summarize: {{text}}"
   ${chalk6.dim("$")} mutagent prompts update <id> -d '{"name":"new-name","systemPrompt":"Updated prompt"}'
   ${chalk6.dim("$")} mutagent prompts update <id> --input-schema '{"type":"object","properties":{"text":{"type":"string","description":"Input text"}}}'
-  ${chalk6.dim("$")} mutagent prompts update <id> --file updated-prompt.json  ${chalk6.dim("# full prompt object")}
 
-${chalk6.yellow("Note: Prefer --system/--human or --data over --file to avoid stale files living in your repo.")}
-${chalk6.dim("--data and --file are mutually exclusive. CLI flags (--name) override --data fields.")}
+${chalk6.dim("CLI flags (--name) override --data fields.")}
     `).action(async (id, options) => {
     const isJson = getJsonFlag(prompts);
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
       let data = {};
-      if (options.data && options.file) {
-        throw new MutagentError("INVALID_ARGUMENTS", "Cannot use --data and --file together", "Use --data for inline JSON or --file for file-based input, not both");
-      }
       if (options.data) {
         try {
           data = JSON.parse(options.data);
@@ -3134,9 +3096,8 @@ ${chalk6.dim("--data and --file are mutually exclusive. CLI flags (--name) overr
         }
         if (options.name)
           data.name = options.name;
-      } else if (options.file) {
-        const content = readFileSync4(options.file, "utf-8");
-        data = JSON.parse(content);
+        if (options.description)
+          data.description = options.description;
       } else if (options.rawFile) {
         if (!existsSync4(options.rawFile)) {
           throw new MutagentError("FILE_NOT_FOUND", `File not found: ${options.rawFile}`, "Check the file path and try again");
@@ -3145,9 +3106,13 @@ ${chalk6.dim("--data and --file are mutually exclusive. CLI flags (--name) overr
         data.rawPrompt = textContent;
         if (options.name)
           data.name = options.name;
+        if (options.description)
+          data.description = options.description;
       } else {
         if (options.name)
           data.name = options.name;
+        if (options.description)
+          data.description = options.description;
         if (options.messages) {
           try {
             const messages = JSON.parse(options.messages);
@@ -3216,7 +3181,7 @@ ${chalk6.dim("--data and --file are mutually exclusive. CLI flags (--name) overr
         }
       }
       if (Object.keys(data).length === 0) {
-        throw new MutagentError("MISSING_ARGUMENTS", "No update data provided", "Use --data, --file, --raw-file, --name, --raw, --system/--human, --messages, --input-schema, or --output-schema");
+        throw new MutagentError("MISSING_ARGUMENTS", "No update data provided", "Use --data, --raw-file, --name, --raw, --system/--human, --messages, --input-schema, or --output-schema");
       }
       const promptContent = data.rawPrompt ?? data.systemPrompt ?? data.humanPrompt ?? "";
       if (promptContent && !isJson) {
@@ -3237,10 +3202,10 @@ ${chalk6.dim("--data and --file are mutually exclusive. CLI flags (--name) overr
         });
         console.log(hints);
       }
-      const sourceFile = options.file ?? options.rawFile;
-      if (sourceFile) {
+      if (options.rawFile) {
+        const rawFilePath = options.rawFile;
         updateMutationContext((ctx) => {
-          ctx.markPromptUploaded(sourceFile, String(prompt.id), prompt.version);
+          ctx.markPromptUploaded(rawFilePath, String(prompt.id), prompt.version);
         });
       }
     } catch (error) {
@@ -3289,7 +3254,7 @@ ${chalk6.dim("Note: --force is required. The CLI is non-interactive — confirm
   const dataset = new Command3("dataset").description("Manage datasets for prompts").addHelpText("after", `
 Examples:
   ${chalk6.dim("$")} mutagent prompts dataset list <prompt-id>
-  ${chalk6.dim("$")} mutagent prompts dataset add <prompt-id> --file dataset.jsonl
+  ${chalk6.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{...},"expectedOutput":{...}}]'
   ${chalk6.dim("$")} mutagent prompts dataset remove <prompt-id> <dataset-id>
     `).action(() => {
     dataset.help();
@@ -3328,16 +3293,10 @@ Examples:
       handleError(error, isJson);
     }
   });
-  dataset.command("add").description("Add dataset to a prompt").argument("<prompt-id>", "Prompt ID (from: mutagent prompts list)").option("-f, --file <path>", "Dataset file (JSON array, JSONL, or CSV)").option("-d, --data <json>", "Inline JSON array of dataset items").option("-n, --name <name>", "Dataset name (default: timestamped)").addHelpText("after", `
+  dataset.command("add").description("Add dataset to a prompt").argument("<prompt-id>", "Prompt ID (from: mutagent prompts list)").option("-d, --data <json>", "Inline JSON array of dataset items").option("-n, --name <name>", "Dataset name").addHelpText("after", `
 Examples:
   ${chalk6.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{"text":"hello"},"expectedOutput":{"result":"world"}}]'
   ${chalk6.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{"text":"hello"},"expectedOutput":{"result":"world"}}]' --name "My Dataset"
-  ${chalk6.dim("$")} mutagent prompts dataset add <prompt-id> --file dataset.jsonl  ${chalk6.dim("# also supports .json, .csv")}
-
-Supported file formats:
-  ${chalk6.dim(".json")}   JSON array of objects: [{"input": {...}, "expectedOutput": {...}}, ...]
-  ${chalk6.dim(".jsonl")}  One JSON object per line (newline-delimited JSON)
-  ${chalk6.dim(".csv")}    Comma-separated values with header row
 
 Inline data format (-d):
   JSON array of objects, e.g.:
@@ -3346,44 +3305,30 @@ Inline data format (-d):
 Expected item format:
   ${chalk6.dim('{"input": {"<field>": "<value>"}, "expectedOutput": {"<field>": "<value>"}}')}
 
-${chalk6.red("Required: --data or --file must be provided.")}
-${chalk6.yellow("Note: Prefer -d/--data for inline JSON over --file to avoid stale files living in your repo.")}
-${chalk6.dim("--file and -d are mutually exclusive.")}
+${chalk6.red("Required: --data must be provided.")}
     `).action(async (promptId, options) => {
     const isJson = getJsonFlag(prompts);
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
-      if (options.file && options.data) {
-        throw new MutagentError("INVALID_ARGUMENTS", "Cannot use both --file and -d/--data", "Use --file to upload from a file or -d to provide inline JSON data, not both");
-      }
-      if (!options.file && !options.data) {
-        throw new MutagentError("MISSING_ARGUMENTS", "Either --file or -d/--data is required", "Use --file <path> to upload from a file or -d '[{...}]' for inline JSON data");
+      if (!options.data) {
+        throw new MutagentError("MISSING_ARGUMENTS", "-d/--data is required", "Use -d '[{...}]' to provide inline JSON data");
       }
       let content;
-      if (options.data) {
-        try {
-          const parsed = JSON.parse(options.data);
-          if (!Array.isArray(parsed)) {
-            throw new MutagentError("INVALID_JSON", "Inline data must be a JSON array", `Provide a JSON array, e.g., '[{"input": {...}, "expectedOutput": {...}}]'`);
-          }
-          content = options.data;
-        } catch (e) {
-          if (e instanceof MutagentError)
-            throw e;
-          throw new MutagentError("INVALID_JSON", "Invalid JSON in -d/--data flag", `Provide a valid JSON array, e.g., '[{"input": {...}, "expectedOutput": {...}}]'`);
+      try {
+        const parsed = JSON.parse(options.data);
+        if (!Array.isArray(parsed)) {
+          throw new MutagentError("INVALID_JSON", "Inline data must be a JSON array", `Provide a JSON array, e.g., '[{"input": {...}, "expectedOutput": {...}}]'`);
         }
-      } else {
-        const filePath = options.file;
-        const rawContent = readFileSync4(filePath, "utf-8");
-        content = parseDatasetFile(rawContent, filePath);
-      }
-      let datasetName = options.name;
-      if (!datasetName && options.file) {
-        datasetName = options.file.replace(/^.*[\\/]/, "").replace(/\.[^.]+$/, "");
+        content = options.data;
+      } catch (e) {
+        if (e instanceof MutagentError)
+          throw e;
+        throw new MutagentError("INVALID_JSON", "Invalid JSON in -d/--data flag", `Provide a valid JSON array, e.g., '[{"input": {...}, "expectedOutput": {...}}]'`);
       }
+      const datasetName = options.name;
       if (!datasetName) {
         throw new MutagentError("MISSING_ARGUMENTS", "Dataset name is required", `[Agent: Ask the user for a dataset name via AskUserQuestion, then pass --name]
-` + `Use --name <name>, e.g., mutagent prompts dataset add ${promptId} --name "my-dataset" --file data.jsonl`);
+` + `Use --name <name>, e.g., mutagent prompts dataset add ${promptId} --name "my-dataset" -d '[...]'`);
       }
       const client = getSDKClient();
       const datasetResult = await client.addDataset(promptId, content, datasetName);
@@ -3410,10 +3355,9 @@ ${chalk6.dim("--file and -d are mutually exclusive.")}
         });
         console.log(hints);
       }
-      const datasetFile = options.file ?? "inline-data";
       updateMutationContext((ctx) => {
-        ctx.addDiscoveredDataset(datasetFile, datasetResult.name, datasetResult.itemCount ?? 0);
-        ctx.markDatasetUploaded(datasetFile, String(datasetResult.id), promptId);
+        ctx.addDiscoveredDataset("inline-data", datasetResult.name, datasetResult.itemCount ?? 0);
+        ctx.markDatasetUploaded("inline-data", String(datasetResult.id), promptId);
       });
     } catch (error) {
       handleError(error, isJson);
@@ -3459,6 +3403,7 @@ Examples:
   const evaluation = new Command3("evaluation").description("Manage evaluations for prompts").addHelpText("after", `
 Examples:
   ${chalk6.dim("$")} mutagent prompts evaluation list <prompt-id>
+  ${chalk6.dim("$")} mutagent prompts evaluation get <evaluation-id>
   ${chalk6.dim("$")} mutagent prompts evaluation create <prompt-id> --name "My Eval"
   ${chalk6.dim("$")} mutagent prompts evaluation delete <evaluation-id>
     `).action(() => {
@@ -3499,7 +3444,63 @@ Examples:
       handleError(error, isJson);
     }
   });
-  evaluation.command("create").description("Create an evaluation configuration for a prompt").argument("<prompt-id>", "Prompt ID (from: mutagent prompts list)").option("-d, --data <json>", "Evaluation as JSON string (for pre-validated criteria only)").option("-n, --name <name>", "Evaluation name (required unless --guided)").option("-f, --file <path>", "Load evaluation criteria from JSON file (advanced — for pre-existing files only)").option("--description <text>", "Evaluation description").option("--dataset <id>", "Dataset ID to associate (from: mutagent prompts dataset list)").option("--guided", "Show evaluation workflow guide with prompt schema fields and criteria template (recommended)").addHelpText("after", `
+  evaluation.command("get").description("Get evaluation details including criteria").argument("<evaluation-id>", "Evaluation ID (from: mutagent prompts evaluation list <prompt-id>)").addHelpText("after", `
+Examples:
+  ${chalk6.dim("$")} mutagent prompts evaluation get <evaluation-id>
+  ${chalk6.dim("$")} mutagent prompts evaluation get <evaluation-id> --json
+    `).action(async (evaluationId) => {
+    const isJson = getJsonFlag(prompts);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      const client = getSDKClient();
+      const evalObj = await client.getEvaluation(evaluationId);
+      if (isJson) {
+        output.output({
+          ...evalObj,
+          _links: evaluationLinks(evalObj.promptGroupId, evalObj.id)
+        });
+      } else {
+        output.success(`Evaluation: ${evalObj.name} (ID: ${String(evalObj.id)})`);
+        if (evalObj.description) {
+          console.log(`  Description: ${evalObj.description}`);
+        }
+        if (evalObj.datasetId != null) {
+          console.log(`  Dataset ID:  ${String(evalObj.datasetId)}`);
+        }
+        console.log(`  Created:     ${evalObj.createdAt ? new Date(String(evalObj.createdAt)).toLocaleDateString() : "N/A"}`);
+        console.log("");
+        const config = evalObj.evalConfig;
+        const criteria = config?.criteria;
+        if (criteria && Array.isArray(criteria) && criteria.length > 0) {
+          console.log("  Criteria:");
+          for (const c of criteria) {
+            console.log(`    ${chalk6.cyan(c.name)}`);
+            if (c.description) {
+              console.log(`      Description: ${c.description}`);
+            }
+            if (c.evaluationParameter) {
+              console.log(`      Parameter:   ${c.evaluationParameter}`);
+            }
+            console.log("");
+          }
+        } else {
+          console.log("  No criteria defined.");
+        }
+        const llmConfig = evalObj.llmConfig;
+        if (llmConfig && Object.keys(llmConfig).length > 0) {
+          console.log("  LLM Config:");
+          for (const [key, value] of Object.entries(llmConfig)) {
+            console.log(`    ${key}: ${String(value)}`);
+          }
+          console.log("");
+        }
+        output.info(`View in dashboard: ${evaluationLink(evalObj.promptGroupId, evalObj.id)}`);
+      }
+    } catch (error) {
+      handleError(error, isJson);
+    }
+  });
+  evaluation.command("create").description("Create an evaluation configuration for a prompt").argument("<prompt-id>", "Prompt ID (from: mutagent prompts list)").option("-d, --data <json>", "Evaluation as JSON string (for pre-validated criteria only)").option("-n, --name <name>", "Evaluation name (required unless --guided)").option("--description <text>", "Evaluation description").option("--guided", "Show evaluation workflow guide with prompt schema fields and criteria template (recommended)").addHelpText("after", `
 Examples:
   ${chalk6.dim("$")} mutagent prompts evaluation create <prompt-id> --guided          ${chalk6.dim("# recommended: shows workflow guide + schema fields")}
   ${chalk6.dim("$")} mutagent prompts evaluation create <prompt-id> --guided --json  ${chalk6.dim("# structured workflow for AI agents")}
@@ -3518,16 +3519,14 @@ AI Agent Directive:
   Before creating an eval, CHECK if criteria already exist in the user's code:
     - If criteria match expected shape (name + description + evaluationParameter targeting schema fields) → use --data
     - If criteria are missing or malformed → use --guided
-    - NEVER use --file unless the user explicitly provides a file path
 
 Expected Criteria Shape (--data):
   ${chalk6.dim('{"evalConfig":{"criteria":[{"name":"<name>","description":"<scoring rubric>","evaluationParameter":"<schema field>"}]}}')}
   evaluationParameter must target an outputSchema OR inputSchema field.
 
-${chalk6.yellow("Note: Prefer --guided or --data. Avoid --file unless you have a pre-existing criteria file.")}
 ${chalk6.red("Required: --name (unless --guided). Criteria must include evaluationParameter.")}
-${chalk6.dim("--data and --file are mutually exclusive. CLI flags (--name, --description) override --data fields.")}
-${chalk6.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent prompts dataset list <prompt-id>")}
+${chalk6.dim("CLI flags (--name, --description) override --data fields.")}
+${chalk6.dim("Get prompt IDs: mutagent prompts list")}
     `).action(async (promptId, options) => {
     const isJson = getJsonFlag(prompts);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -3537,6 +3536,29 @@ ${chalk6.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent
         const prompt = await client2.getPrompt(promptId);
         const inputFields = prompt.inputSchema && typeof prompt.inputSchema === "object" ? Object.keys(prompt.inputSchema.properties ?? {}) : [];
         const outputFields = prompt.outputSchema && typeof prompt.outputSchema === "object" ? Object.keys(prompt.outputSchema.properties ?? {}) : [];
+        const allFields = [
+          ...outputFields.map((f) => ({ field: f, source: "outputSchema" })),
+          ...inputFields.map((f) => ({ field: f, source: "inputSchema" }))
+        ];
+        const askUserQuestions = allFields.map(({ field, source }) => ({
+          question: `How should "${field}" (${source}) be evaluated? Describe the scoring rubric — what does 1.0 (perfect) vs 0.0 (fail) mean for this field?`,
+          header: field,
+          options: [
+            {
+              label: "Exact Match",
+              description: `Score 1.0 if the "${field}" output exactly matches the expected value. Score 0.5 for same meaning but different format. Score 0.0 if substantively different.`
+            },
+            {
+              label: "Semantic Similarity",
+              description: `Score 0.0-1.0 based on how closely the "${field}" output matches the expected meaning. 1.0 = identical meaning, 0.5 = partially relevant, 0.0 = unrelated or contradictory.`
+            },
+            {
+              label: "Custom rubric",
+              description: `Write a detailed custom scoring rubric for "${field}" — explain what makes a 1.0 vs 0.0 score.`
+            }
+          ],
+          multiSelect: false
+        }));
         const workflow = {
           prompt: { id: promptId, name: prompt.name },
           inputSchema: { fields: inputFields },
@@ -3551,18 +3573,23 @@ ${chalk6.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent
               },
               {
                 step: 2,
-                action: "Define evaluation criteria with the user",
-                detail: "Ask the user what aspects of the output they want to evaluate (accuracy, quality, format, etc.)"
+                action: "Ask the user about each schema field using AskUserQuestion",
+                detail: "For EACH field listed in askUserQuestions below, present the question to the user. Collect their scoring rubric choice or custom description."
               },
               {
                 step: 3,
-                action: "Build criteria JSON",
-                detail: "Each criterion needs: name (label), description (scoring rubric), evaluationParameter (schema field to score)"
+                action: "Build criteria JSON from user answers",
+                detail: `Map each user answer to a criterion: { name: "<field> <rubric>", description: "<user's rubric>", evaluationParameter: "<field>" }`
               },
               {
                 step: 4,
+                action: "Ask for evaluation name",
+                detail: 'Ask the user what to name this evaluation (e.g., "Accuracy Check", "Quality Eval")'
+              },
+              {
+                step: 5,
                 action: "Create the evaluation",
-                detail: "Pass the criteria via --data flag"
+                detail: `Run: mutagent prompts evaluation create <prompt-id> --name "<name>" -d '{"evalConfig":{"criteria":[...]}}'`
               }
             ],
             criteriaTemplate: {
@@ -3571,7 +3598,7 @@ ${chalk6.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent
                   {
                     name: "<criterion_name>",
                     description: "<scoring rubric - describe what 1.0 vs 0.0 means>",
-                    evaluationParameter: `<one of: ${outputFields.concat(inputFields).length > 0 ? outputFields.concat(inputFields).join(", ") : "no fields detected - check prompt schemas"}>`
+                    evaluationParameter: `<one of: ${allFields.length > 0 ? allFields.map((f) => f.field).join(", ") : "no fields detected - check prompt schemas"}>`
                   }
                 ]
               }
@@ -3586,9 +3613,15 @@ ${chalk6.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent
               }
             })}'`
           },
+          askUserQuestions,
           _directive: {
             display: "workflow_guide",
-            instruction: "STOP. Present this workflow guide to the user. Ask them to define criteria for each output field they want to evaluate. Then construct the --data JSON and run the example command."
+            instruction: "STOP. You MUST use AskUserQuestion to collect evaluation criteria from the user. For EACH field in askUserQuestions, present the question. Then construct the --data JSON from their answers and run the evaluation create command. Do NOT skip fields or auto-generate criteria without user input.",
+            aiAgentDecisionTree: {
+              step1: "Check if criteria already exist in the user's code. If criteria match expected shape (name + description + evaluationParameter targeting schema fields), use --data directly.",
+              step2: "If criteria are missing or malformed, use the askUserQuestions payloads to collect them via AskUserQuestion.",
+              step3: `After collecting all criteria, construct the --data JSON and run: mutagent prompts evaluation create <prompt-id> --name "<name>" -d '<json>'`
+            }
           }
         };
         if (isJson) {
@@ -3603,20 +3636,20 @@ ${chalk6.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent
             console.log(`  Input Schema Fields:  ${inputFields.join(", ")}`);
           }
           console.log("");
-          console.log("  Steps:");
-          console.log("    1. Review the prompt schemas above");
-          console.log("    2. Define what aspects of output to evaluate (accuracy, quality, format, etc.)");
-          console.log("    3. For each criterion, define: name, description (rubric), evaluationParameter (field)");
-          console.log("    4. Run the create command with --data:");
+          console.log("  For each field, define a scoring criterion:");
+          for (const { field, source } of allFields) {
+            console.log(`    ${chalk6.cyan(field)} (${source})`);
+            console.log(`      → What does 1.0 vs 0.0 mean for "${field}"?`);
+          }
           console.log("");
-          console.log("  Example:");
+          console.log("  Then create the evaluation:");
           console.log(`    mutagent prompts evaluation create ${promptId} --name "My Eval" \\`);
           console.log(`      -d '{"evalConfig":{"criteria":[{"name":"accuracy","description":"Score 1.0 if correct","evaluationParameter":"${outputFields[0] ?? "<field>"}"}]}}'`);
           console.log("");
         }
         return;
       }
-      if (!options.data && !options.file) {
+      if (!options.data) {
         throw new MutagentError("MISSING_ARGUMENTS", "No criteria source provided", `[Agent: Run --guided first to see available schema fields, then ask the user to define criteria via AskUserQuestion]
 ` + `Use --guided to see the evaluation workflow and available schema fields, or provide criteria via --data.
 ` + "Example: mutagent prompts evaluation create " + promptId + " --guided");
@@ -3625,47 +3658,22 @@ ${chalk6.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent
         throw new MutagentError("MISSING_ARGUMENTS", "Evaluation name is required", `[Agent: Ask the user for an evaluation name via AskUserQuestion, then pass --name]
 ` + "Use --name <name>, e.g., mutagent prompts evaluation create " + promptId + ` --name "My Eval" --data '...'`);
       }
-      if (options.data && options.file) {
-        throw new MutagentError("INVALID_ARGUMENTS", "Cannot use --data and --file together", "Use --data for inline JSON or --file for file-based input, not both");
-      }
       const evalData = {
         name: options.name,
         description: options.description
       };
-      if (options.data) {
-        try {
-          const parsed = JSON.parse(options.data);
-          if (parsed.evalConfig)
-            evalData.evalConfig = parsed.evalConfig;
-          if (parsed.llmConfig)
-            evalData.llmConfig = parsed.llmConfig;
-          if (parsed.tags)
-            evalData.tags = parsed.tags;
-          if (parsed.metadata)
-            evalData.metadata = parsed.metadata;
-          if (parsed.datasetId)
-            evalData.datasetId = parsed.datasetId;
-        } catch {
-          throw new MutagentError("INVALID_JSON", "Invalid JSON in --data flag", `Provide a valid JSON object, e.g., '{"evalConfig":{"criteria":[...]},"llmConfig":{"model":"gpt-4"}}'`);
-        }
-      } else if (options.file) {
-        if (!existsSync4(options.file)) {
-          throw new MutagentError("FILE_NOT_FOUND", `File not found: ${options.file}`, "Check the file path and try again");
-        }
-        const fileContent = readFileSync4(options.file, "utf-8");
-        try {
-          const parsed = JSON.parse(fileContent);
-          if (parsed.evalConfig)
-            evalData.evalConfig = parsed.evalConfig;
-          if (parsed.llmConfig)
-            evalData.llmConfig = parsed.llmConfig;
-          if (parsed.tags)
-            evalData.tags = parsed.tags;
-          if (parsed.metadata)
-            evalData.metadata = parsed.metadata;
-        } catch {
-          throw new MutagentError("INVALID_JSON", `Failed to parse criteria file: ${options.file}`, "Ensure the file contains valid JSON with evalConfig and/or llmConfig");
-        }
+      try {
+        const parsed = JSON.parse(options.data);
+        if (parsed.evalConfig)
+          evalData.evalConfig = parsed.evalConfig;
+        if (parsed.llmConfig)
+          evalData.llmConfig = parsed.llmConfig;
+        if (parsed.tags)
+          evalData.tags = parsed.tags;
+        if (parsed.metadata)
+          evalData.metadata = parsed.metadata;
+      } catch {
+        throw new MutagentError("INVALID_JSON", "Invalid JSON in --data flag", `Provide a valid JSON object, e.g., '{"evalConfig":{"criteria":[...]},"llmConfig":{"model":"gpt-4"}}'`);
       }
       if (options.name)
         evalData.name = options.name;
@@ -3689,7 +3697,7 @@ Detected output fields from prompt schema: ${fields.join(", ")}
             }
           }
         } catch {}
-        throw new MutagentError("VALIDATION_ERROR", "Evaluation criteria are required. Provide criteria via --data or --file.", `Run with --guided to see available schema fields and criteria template.
+        throw new MutagentError("VALIDATION_ERROR", "Evaluation criteria are required. Provide criteria via --data.", `Run with --guided to see available schema fields and criteria template.
 ` + fieldsHint + `
 Example JSON (--data flag):
 ` + `  --data '{"evalConfig":{"criteria":[{"name":"Accuracy","description":"...","evaluationParameter":"classification"}]}}'
@@ -3743,12 +3751,6 @@ Available output fields: ${availableFields.join(", ")}` : "";
 Example:
   --data '{"evalConfig":{"criteria":[` + '{"name":"Accuracy","description":"...","evaluationParameter":"classification"},' + '{"name":"Confidence","description":"...","evaluationParameter":"confidence"}' + "]}}'");
       }
-      if (options.dataset) {
-        evalData.datasetId = parseInt(options.dataset, 10);
-        if (isNaN(evalData.datasetId)) {
-          throw new MutagentError("VALIDATION_ERROR", `Invalid dataset ID: ${options.dataset}`, "Dataset ID must be a number. Get IDs with: mutagent prompts dataset list <prompt-id>");
-        }
-      }
       const client = getSDKClient();
       const evalResult = await client.createEvaluation(promptId, evalData);
       if (isJson) {
@@ -3816,7 +3818,7 @@ Examples:
   });
   const optimize = new Command3("optimize").description("Manage prompt optimization jobs").addHelpText("after", `
 Examples:
-  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id>
+  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --evaluation <eval-id>
   ${chalk6.dim("$")} mutagent prompts optimize status <job-id>
   ${chalk6.dim("$")} mutagent prompts optimize results <job-id>
 
@@ -3825,17 +3827,14 @@ Workflow: start -> status (poll) -> results
     optimize.help();
   });
   prompts.addCommand(optimize);
-  optimize.command("start").description("Start prompt optimization").argument("<prompt-id>", "Prompt ID (from: mutagent prompts list)").requiredOption("-d, --dataset <id>", "Dataset ID for optimization (from: mutagent prompts dataset list <prompt-id>)").option("--max-iterations <n>", "Max optimization iterations (default: 1)").option("--target-score <n>", "Target accuracy 0-1 (default: 0.8)").option("--patience <n>", "Iterations without improvement before stopping").option("--model <model-id>", 'Target LLM model (e.g., "claude-sonnet-4-5-20250929")').option("--eval-model <model-id>", "Evaluation model (defaults to target model)").addHelpText("after", `
+  optimize.command("start").description("Start prompt optimization").argument("<prompt-id>", "Prompt ID (from: mutagent prompts list)").requiredOption("-d, --dataset <id>", "Dataset ID for optimization (from: mutagent prompts dataset list <prompt-id>)").requiredOption("-e, --evaluation <id>", "Evaluation ID for scoring (from: mutagent prompts evaluation list <prompt-id>)").option("--max-iterations <n>", "Max optimization iterations (default: 1)").option("--target-score <n>", "Target accuracy 0-1 (default: 0.8)").option("--patience <n>", "Iterations without improvement before stopping").option("--model <model-id>", 'Target LLM model (e.g., "claude-sonnet-4-5-20250929")').option("--eval-model <model-id>", "Evaluation model (defaults to target model)").addHelpText("after", `
 Examples:
-  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id>
-  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --max-iterations 5
-  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --target-score 0.95 --model claude-sonnet-4-5-20250929
-  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --json
+  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --evaluation <eval-id>
+  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --evaluation <eval-id> --max-iterations 5
+  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --evaluation <eval-id> --target-score 0.95 --model claude-sonnet-4-5-20250929
+  ${chalk6.dim("$")} mutagent prompts optimize start <prompt-id> --dataset <dataset-id> --evaluation <eval-id> --json
 ${PREREQUISITES_TEXT}
 
-${chalk6.yellow("Important: Ensure exactly 1 evaluation exists for this prompt before optimizing.")}
-${chalk6.yellow("Multiple evaluations produce conflicting scores. Delete extras first.")}
-
 ${chalk6.dim("Monitor progress with: mutagent prompts optimize status <job-id>")}
 
 ${chalk6.dim("AI Agent Note: After running commands, present CLI output to the user as a status report. Use --json for structured parsing.")}
@@ -3854,31 +3853,26 @@ ${chalk6.dim("AI Agent Note: After running commands, present CLI output to the u
           output.warn("Prompt has no inputSchema. Optimization works best with defined input variables.");
         }
         try {
-          const evals = await client.listEvaluations(promptId);
-          if (evals.length === 0) {
-            throw new MutagentError("MISSING_EVALUATION", "No evaluations found for this prompt — required for optimization", `Create an evaluation: mutagent prompts evaluation create ${promptId} --guided`);
-          }
-          const validEvals = evals.filter((e) => {
-            const config = e.evalConfig;
-            const criteria = config?.criteria;
-            if (!criteria || criteria.length === 0)
-              return false;
-            return criteria.some((c) => c.evaluationParameter ?? c.targetField);
-          });
-          if (validEvals.length === 0) {
-            output.warn("Evaluations exist but none have evaluationParameter set. " + "Optimization works best with criteria targeting specific output fields. " + `Re-create: mutagent prompts evaluation create ${promptId} --guided`);
-          } else if (validEvals.length > 1) {
-            output.warn(`Found ${String(validEvals.length)} evaluations. Optimization works best with exactly 1 evaluation. ` + "Multiple evaluations may produce conflicting scoring. " + `Delete extras: mutagent prompts evaluation delete <evaluation-id> --force`);
+          const evalObj = await client.getEvaluation(options.evaluation);
+          const evalConfig = evalObj.evalConfig;
+          const criteria = evalConfig?.criteria;
+          if (!criteria || criteria.length === 0) {
+            output.warn(`Evaluation ${options.evaluation} has no criteria defined. ` + "Optimization works best with criteria targeting specific output fields. " + `Re-create: mutagent prompts evaluation create ${promptId} --guided`);
           } else {
-            output.info(`Found ${String(validEvals.length)} evaluation with proper criteria.`);
+            const hasCriteriaWithParam = criteria.some((c) => c.evaluationParameter ?? c.targetField);
+            if (!hasCriteriaWithParam) {
+              output.warn(`Evaluation ${options.evaluation} has criteria but none have evaluationParameter set. ` + `Re-create: mutagent prompts evaluation create ${promptId} --guided`);
+            } else {
+              output.info(`Using evaluation ${options.evaluation} with ${String(criteria.length)} criteria.`);
+            }
           }
         } catch (e) {
           if (e instanceof MutagentError)
             throw e;
-          output.warn("Could not validate evaluations. Optimization will use default evaluation.");
+          output.warn(`Could not validate evaluation ${options.evaluation}. Proceeding anyway.`);
         }
       }
-      const job = await client.startOptimization(promptId, options.dataset, {
+      const job = await client.startOptimization(promptId, options.dataset, options.evaluation, {
         maxIterations: options.maxIterations ? parseInt(options.maxIterations, 10) : 1,
         targetScore: options.targetScore ? parseFloat(options.targetScore) : undefined,
         patience: options.patience ? parseInt(options.patience, 10) : undefined,
@@ -3912,7 +3906,7 @@ ${chalk6.dim("AI Agent Note: After running commands, present CLI output to the u
           suggestions.push("Dataset item inputs don't match the prompt's inputSchema. Verify field names and types.");
         }
         if (errorText.includes("has no items") || errorText.includes("Dataset") && errorText.includes("not found")) {
-          suggestions.push(`Upload data: mutagent prompts dataset add ${promptId} --file data.json`);
+          suggestions.push(`Upload data: mutagent prompts dataset add ${promptId} -d '[...]' --name "my-dataset"`);
         }
         if (errorText.includes("Evaluations are not present")) {
           suggestions.push(`Create evaluation: mutagent prompts evaluation create ${promptId} --guided`);
@@ -4939,14 +4933,13 @@ AI AGENT: Execute these steps using Bash for install, Write/Edit for code change
 // src/commands/agents.ts
 import { Command as Command6 } from "commander";
 import chalk9 from "chalk";
-import { readFileSync as readFileSync9 } from "fs";
 function createAgentsCommand() {
   const agents = new Command6("agents").description("Manage AI agents").addHelpText("after", `
 Examples:
   ${chalk9.dim("$")} mutagent agents list
   ${chalk9.dim("$")} mutagent agents get <agent-id>
-  ${chalk9.dim("$")} mutagent agents create --file agent.json
   ${chalk9.dim("$")} mutagent agents create --name "Code Reviewer" --slug code-reviewer --system-prompt "You are a code reviewer..."
+  ${chalk9.dim("$")} mutagent agents create -d '{"name":"Code Reviewer","slug":"code-reviewer","systemPrompt":"You are..."}'
   ${chalk9.dim("$")} mutagent agents update <agent-id> --name "Updated Name"
   ${chalk9.dim("$")} mutagent agents delete <agent-id> --force
   ${chalk9.dim("$")} mutagent agents conversations list <agent-id>
@@ -5055,11 +5048,10 @@ System Prompt:`));
       handleError(error, isJson);
     }
   });
-  agents.command("create").description("Create a new agent").option("-d, --data <json>", "Agent as JSON string (recommended for CI/scripts/agents)").option("-f, --file <path>", "Create from JSON file").option("-n, --name <name>", "Agent name").option("-s, --slug <slug>", "Agent slug (URL-friendly identifier)").option("-p, --system-prompt <prompt>", "System prompt").option("-m, --model <model>", "Model (claude-sonnet-4-5, claude-opus-4-5, claude-haiku-4-5)").option("--description <desc>", "Agent description").addHelpText("after", `
+  agents.command("create").description("Create a new agent").option("-d, --data <json>", "Agent as JSON string (recommended for CI/scripts/agents)").option("-n, --name <name>", "Agent name").option("-s, --slug <slug>", "Agent slug (URL-friendly identifier)").option("-p, --system-prompt <prompt>", "System prompt").option("-m, --model <model>", "Model (claude-sonnet-4-5, claude-opus-4-5, claude-haiku-4-5)").option("--description <desc>", "Agent description").addHelpText("after", `
 Examples:
   ${chalk9.dim("$")} mutagent agents create --name "Code Reviewer" --slug code-reviewer --system-prompt "You are a code reviewer..."
   ${chalk9.dim("$")} mutagent agents create -d '{"name":"Code Reviewer","slug":"code-reviewer","systemPrompt":"You are a code reviewer..."}'
-  ${chalk9.dim("$")} mutagent agents create --file agent.json  ${chalk9.dim("# full agent object as JSON file")}
 
 Expected JSON (--data):
   ${chalk9.dim('{"name":"<name>","slug":"<slug>","systemPrompt":"<system prompt>","model":"<model-id>","description":"<description>"}')}
@@ -5067,18 +5059,13 @@ Expected JSON (--data):
 Input Methods (pick one, priority order):
   --name/--slug/...  Individual flags ${chalk9.green("(recommended)")}
   -d, --data         Inline JSON object (CI/scripts/agents)
-  --file             Load from JSON file
 
-${chalk9.yellow("Note: Prefer individual flags or --data over --file to avoid stale files living in your repo.")}
-${chalk9.red("Required: name, slug, systemPrompt.")} ${chalk9.dim("--data and --file are mutually exclusive. CLI flags override --data fields.")}
+${chalk9.red("Required: name, slug, systemPrompt.")} ${chalk9.dim("CLI flags override --data fields.")}
     `).action(async (options) => {
     const isJson = getJsonFlag(agents);
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
       let data;
-      if (options.data && options.file) {
-        throw new MutagentError("INVALID_ARGUMENTS", "Cannot use --data and --file together", "Use --data for inline JSON or --file for file-based input, not both");
-      }
       if (options.data) {
         try {
           data = JSON.parse(options.data);
@@ -5095,9 +5082,6 @@ ${chalk9.red("Required: name, slug, systemPrompt.")} ${chalk9.dim("--data and --
           data.model = options.model;
         if (options.description)
           data.description = options.description;
-      } else if (options.file) {
-        const content = readFileSync9(options.file, "utf-8");
-        data = JSON.parse(content);
       } else if (options.name && options.slug && options.systemPrompt) {
         data = {
           name: options.name,
@@ -5109,7 +5093,7 @@ ${chalk9.red("Required: name, slug, systemPrompt.")} ${chalk9.dim("--data and --
         if (options.description)
           data.description = options.description;
       } else {
-        throw new MutagentError("MISSING_ARGUMENTS", "Either --data, --file, or (--name, --slug, and --system-prompt) are required", "Use --data for inline JSON, --file to load from JSON, or provide --name, --slug, and --system-prompt");
+        throw new MutagentError("MISSING_ARGUMENTS", "Either --data or (--name, --slug, and --system-prompt) are required", "Use --data for inline JSON or provide --name, --slug, and --system-prompt");
       }
       const client = getSDKClient();
       const agent = await client.createAgent(data);
@@ -5119,28 +5103,22 @@ ${chalk9.red("Required: name, slug, systemPrompt.")} ${chalk9.dim("--data and --
       handleError(error, isJson);
     }
   });
-  agents.command("update").description("Update an agent").argument("<id>", "Agent ID").option("-d, --data <json>", "Agent updates as JSON string (CI/scripts/agents)").option("-f, --file <path>", "Update from JSON file").option("-n, --name <name>", "New name").option("-p, --system-prompt <prompt>", "New system prompt").option("-m, --model <model>", "New model").option("--description <desc>", "New description").option("-s, --status <status>", "New status (active, paused, archived)").addHelpText("after", `
+  agents.command("update").description("Update an agent").argument("<id>", "Agent ID").option("-d, --data <json>", "Agent updates as JSON string (CI/scripts/agents)").option("-n, --name <name>", "New name").option("-p, --system-prompt <prompt>", "New system prompt").option("-m, --model <model>", "New model").option("--description <desc>", "New description").option("-s, --status <status>", "New status (active, paused, archived)").addHelpText("after", `
 Examples:
   ${chalk9.dim("$")} mutagent agents update <id> --name "New Name"
   ${chalk9.dim("$")} mutagent agents update <id> --system-prompt "Updated prompt" --status active
   ${chalk9.dim("$")} mutagent agents update <id> -d '{"name":"New Name","systemPrompt":"Updated prompt"}'
-  ${chalk9.dim("$")} mutagent agents update <id> --file updated-agent.json  ${chalk9.dim("# full agent object")}
 
 Input Methods (pick one, priority order):
   --name/--system-prompt/...  Individual flags ${chalk9.green("(recommended)")}
   -d, --data                  Inline JSON object (CI/scripts/agents)
-  --file                      Load from JSON file
 
-${chalk9.yellow("Note: Prefer individual flags or --data over --file to avoid stale files living in your repo.")}
-${chalk9.dim("--data and --file are mutually exclusive. CLI flags override --data fields.")}
+${chalk9.dim("CLI flags override --data fields.")}
     `).action(async (id, options) => {
     const isJson = getJsonFlag(agents);
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
       let data = {};
-      if (options.data && options.file) {
-        throw new MutagentError("INVALID_ARGUMENTS", "Cannot use --data and --file together", "Use --data for inline JSON or --file for file-based input, not both");
-      }
       if (options.data) {
         try {
           data = JSON.parse(options.data);
@@ -5157,9 +5135,6 @@ ${chalk9.dim("--data and --file are mutually exclusive. CLI flags override --dat
           data.description = options.description;
         if (options.status)
           data.status = options.status;
-      } else if (options.file) {
-        const content = readFileSync9(options.file, "utf-8");
-        data = JSON.parse(content);
       } else {
         if (options.name)
           data.name = options.name;
@@ -5173,7 +5148,7 @@ ${chalk9.dim("--data and --file are mutually exclusive. CLI flags override --dat
           data.status = options.status;
       }
       if (Object.keys(data).length === 0) {
-        throw new MutagentError("MISSING_ARGUMENTS", "No update data provided", "Use --data, --file, --name, --system-prompt, --model, --description, or --status");
+        throw new MutagentError("MISSING_ARGUMENTS", "No update data provided", "Use --data, --name, --system-prompt, --model, --description, or --status");
       }
       const client = getSDKClient();
       const agent = await client.updateAgent(id, data);
@@ -5461,7 +5436,6 @@ ${chalk10.dim("Persists organization ID for org-scoped API keys.")}
 // src/commands/playground.ts
 import { Command as Command8 } from "commander";
 import chalk11 from "chalk";
-import { readFileSync as readFileSync10 } from "fs";
 function parseSSELine(line) {
   if (!line || line.startsWith(":")) {
     return null;
@@ -5488,7 +5462,6 @@ function createPlaygroundCommand() {
   const playground = new Command8("playground").description("Execute and test prompts interactively").addHelpText("after", `
 Examples:
   ${chalk11.dim("$")} mutagent playground run <prompt-id> --input '{"name": "John"}'
-  ${chalk11.dim("$")} mutagent playground run <prompt-id> --file input.json
   ${chalk11.dim("$")} mutagent playground run <prompt-id> --input '{}' --stream
   ${chalk11.dim("$")} mutagent playground run <prompt-id> -i '{}' --model gpt-4-turbo
   ${chalk11.dim("$")} mutagent playground run <prompt-id> --system "You are helpful" --human "Hello"
@@ -5496,7 +5469,7 @@ Examples:
 
 Input Format:
   The input must be a valid JSON object matching the prompt's input schema.
-  Use --input for inline JSON or --file to load from a file.
+  Use --input for inline JSON.
 
 Prompt Style Flags:
   Use --system and --human to quickly construct a messages array.
@@ -5506,10 +5479,10 @@ Streaming:
   Use --stream to receive tokens as they are generated.
   In JSON mode (--json), each token is output as a separate JSON object.
     `);
-  playground.command("run").description("Execute a prompt with input variables").argument("<prompt-id>", "Prompt ID to execute (from: mutagent prompts list)").option("-i, --input <json>", "Input variables as JSON").option("-f, --file <path>", "Input from JSON file").option("-s, --stream", "Stream the response").option("-m, --model <model>", "Override model").option("--system <text>", "Set system prompt text").option("--human <text>", "Set human/user message text").option("--messages <json>", "Pass full messages array as JSON string").addHelpText("after", `
+  playground.command("run").description("Execute a prompt with input variables").argument("<prompt-id>", "Prompt ID to execute (from: mutagent prompts list)").option("-i, --input <json>", "Input variables as JSON").option("-s, --stream", "Stream the response").option("-m, --model <model>", "Override model").option("--system <text>", "Set system prompt text").option("--human <text>", "Set human/user message text").option("--messages <json>", "Pass full messages array as JSON string").addHelpText("after", `
 Examples:
   ${chalk11.dim("$")} mutagent playground run <prompt-id> --input '{"name": "John"}'
-  ${chalk11.dim("$")} mutagent playground run <prompt-id> --file input.json --stream
+  ${chalk11.dim("$")} mutagent playground run <prompt-id> --input '{}' --stream
   ${chalk11.dim("$")} mutagent playground run <prompt-id> --system "You are helpful" --human "Hello"
   ${chalk11.dim("$")} mutagent playground run <prompt-id> --input '{}' --model gpt-4-turbo --json
 
@@ -5517,9 +5490,6 @@ Input Methods (pick one, priority order):
   --system/--human            Quick system + user message ${chalk11.green("(recommended)")}
   --input '{"key":"value"}'   Inline JSON variables
   --messages '[...]'          Full messages array
-  --file input.json           Load from JSON file
-
-${chalk11.yellow("Note: Prefer --system/--human or --input over --file to avoid stale files living in your repo.")}
 ${chalk11.dim(`Hint: Test before evaluating: mutagent playground run <id> --input '{"key":"value"}'`)}
     `).action(async (promptId, options) => {
     const isJson = getJsonFlag(playground);
@@ -5567,13 +5537,9 @@ Execution Result:`));
   return playground;
 }
 function parseInput(options) {
-  const hasInputOrFile = options.input ?? options.file;
   const hasPromptStyleFlags = options.system ?? options.human ?? options.messages;
-  if (hasInputOrFile && hasPromptStyleFlags) {
-    throw new MutagentError("INVALID_ARGUMENTS", "Cannot use --input/--file with prompt style flags (--system, --human, --messages)", "Use either --input/--file OR prompt style flags, not both");
-  }
-  if (options.input && options.file) {
-    throw new MutagentError("INVALID_ARGUMENTS", "Cannot use both --input and --file options", "Use either --input for inline JSON or --file to load from a file");
+  if (options.input && hasPromptStyleFlags) {
+    throw new MutagentError("INVALID_ARGUMENTS", "Cannot use --input with prompt style flags (--system, --human, --messages)", "Use either --input OR prompt style flags, not both");
   }
   if (hasPromptStyleFlags) {
     return parsePromptStyleInput(options);
@@ -5621,17 +5587,10 @@ function parsePromptStyleInput(options) {
   return { messages };
 }
 function getInputJson(options) {
-  if (options.file) {
-    try {
-      return readFileSync10(options.file, "utf-8");
-    } catch (err) {
-      throw new MutagentError("FILE_READ_ERROR", `Failed to read input file: ${options.file}`, err instanceof Error ? err.message : "Check the file path and permissions");
-    }
-  }
   if (options.input) {
     return options.input;
   }
-  throw new MutagentError("MISSING_ARGUMENTS", "Input is required", `Use --input '{"key": "value"}' or --file input.json or --system/--human/--messages flags`);
+  throw new MutagentError("MISSING_ARGUMENTS", "Input is required", `Use --input '{"key": "value"}' or --system/--human/--messages flags`);
 }
 function parseJsonInput(inputJson) {
   try {
@@ -5989,7 +5948,7 @@ Available Models:`));
 import { Command as Command11 } from "commander";
 import inquirer3 from "inquirer";
 import chalk14 from "chalk";
-import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync11, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "fs";
 import { execSync as execSync2 } from "child_process";
 import { join as join5 } from "path";
 var FRAMEWORK_DETECTION_MAP = {
@@ -6077,7 +6036,7 @@ function detectFrameworkFromPackageJson(cwd = process.cwd()) {
   }
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
+    pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
   } catch {
     return null;
   }
@@ -6677,7 +6636,7 @@ if (process.env.CLI_VERSION) {
   try {
     const __dirname2 = dirname(fileURLToPath(import.meta.url));
     const pkgPath = join7(__dirname2, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync10(pkgPath, "utf-8"));
     cliVersion = pkg.version ?? cliVersion;
   } catch {}
 }
@@ -6702,8 +6661,8 @@ program.addHelpText("after", `
 ${chalk18.yellow("Workflows:")}
   ${chalk18.bold("Evaluate → Optimize Loop:")}
     1. mutagent prompts create --name "..." --raw-file prompt.txt
-    2. mutagent prompts dataset add <prompt-id> --name "..." --file data.json
-    3. mutagent prompts evaluation create <prompt-id> --name "..." --file criteria.json
+    2. mutagent prompts dataset add <prompt-id> --name "..." -d '[{"input":{...},"expectedOutput":{...}}]'
+    3. mutagent prompts evaluation create <prompt-id> --name "..." -d '{"evalConfig":{"criteria":[...]}}'
     4. mutagent prompts optimize start <prompt-id> --dataset <id> --max-iterations 1
 
   ${chalk18.bold("Quick Test:")}
@@ -6778,5 +6737,5 @@ program.addCommand(createSkillsCommand());
 program.addCommand(createUsageCommand());
 program.parse();
 
-//# debugId=50A4FEB3E212CA6764756E2164756E21
+//# debugId=C797200705360DE264756E2164756E21
 //# sourceMappingURL=cli.js.map