@mutagent/cli 0.1.192 → 0.1.194

package/dist/bin/cli.js

@@ -546,6 +546,31 @@ class SDKClientWrapper {
     }
     return response.json();
   }
+  async requestRaw(path, options) {
+    const optHeaders = options?.headers;
+    let extraHeaders = {};
+    if (optHeaders instanceof Headers) {
+      optHeaders.forEach((value, key) => {
+        extraHeaders[key] = value;
+      });
+    } else if (optHeaders) {
+      extraHeaders = optHeaders;
+    }
+    const tenancyHeaders = {};
+    if (this.workspaceId)
+      tenancyHeaders["x-workspace-id"] = this.workspaceId;
+    if (this.organizationId)
+      tenancyHeaders["x-organization-id"] = this.organizationId;
+    return fetch(`${this.endpoint}${path}`, {
+      ...options,
+      headers: {
+        "x-api-key": this.apiKey,
+        "Content-Type": "application/json",
+        ...tenancyHeaders,
+        ...extraHeaders
+      }
+    });
+  }
   async listPrompts() {
     try {
       const response = await this.sdk.prompt.listPrompts();
@@ -675,10 +700,24 @@ class SDKClientWrapper {
           metadata: item.metadata
         }));
         const missingExpectedOutputCount = mappedItems.filter((item) => item.expectedOutput === undefined).length;
-        await this.request(`/api/prompts/datasets/${String(dataset.id)}/items/bulk`, {
+        const bulkResult = await this.requestRaw(`/api/prompts/datasets/${String(dataset.id)}/items/bulk`, {
           method: "POST",
           body: JSON.stringify({ items: mappedItems })
         });
+        if (!bulkResult.ok) {
+          const bodyText = await bulkResult.text();
+          let parsed2;
+          try {
+            parsed2 = JSON.parse(bodyText);
+          } catch {}
+          const typed = parsed2;
+          if (typed && typed.kind === "bulk_insert_rollback") {
+            const constraint = typeof typed.failingConstraint === "string" ? typed.failingConstraint : "unknown";
+            const rowIndex = typeof typed.failingRowIndex === "number" ? typed.failingRowIndex : null;
+            throw new ApiError(bulkResult.status, `Bulk insert rolled back — constraint: ${constraint}` + (rowIndex !== null ? `, first failing row: ${String(rowIndex)}` : ""));
+          }
+          throw new ApiError(bulkResult.status, bodyText || "Bulk insert failed");
+        }
         itemCount = mappedItems.length;
         return { ...dataset, itemCount, missingExpectedOutputCount };
       }
@@ -839,10 +878,9 @@ class SDKClientWrapper {
             maxIterations: config?.maxIterations ?? 1,
             targetScore: config?.targetScore ?? 0.8,
             patience: config?.patience,
-            ...config?.execModel ? { executionModel: config.execModel } : {},
-            ...config?.model ? { model: config.model } : {},
-            ...config?.evalModel ? { evaluationModel: config.evalModel } : {},
-            ...config?.optModel ? { optimizationModel: config.optModel } : {},
+            ...config?.executionModel ? { executionModel: config.executionModel } : {},
+            ...config?.evaluationModel ? { evaluationModel: config.evaluationModel } : {},
+            ...config?.optimizationModel ? { optimizationModel: config.optimizationModel } : {},
             ...config?.providerId ? { executionProviderId: config.providerId } : {},
             ...config?.evalProviderId ? { evaluationProviderId: config.evalProviderId } : {},
             ...config?.optProviderId ? { optimizationProviderId: config.optProviderId } : {}
@@ -1271,7 +1309,7 @@ var init_sdk_client = __esm(() => {
 // src/bin/cli.ts
 import { Command as Command21 } from "commander";
 import chalk39 from "chalk";
-import { readFileSync as readFileSync14, existsSync as existsSync17 } from "fs";
+import { readFileSync as readFileSync15, existsSync as existsSync18 } from "fs";
 import { join as join12, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
@@ -2847,7 +2885,7 @@ init_errors();
 init_sdk_client();
 import { Command as Command7 } from "commander";
 import chalk18 from "chalk";
-import { readFileSync as readFileSync5, existsSync as existsSync5 } from "fs";
+import { readFileSync as readFileSync6, existsSync as existsSync6 } from "fs";
 
 // src/lib/ui-links.ts
 function getAppBaseUrl() {
@@ -3617,10 +3655,14 @@ inputSchema must be provided. Pass it via the API or dashboard.`);
 Add a 'description' field to each property in your inputSchema. Example: { "properties": { "field": { "type": "string", "description": "What this field contains" } } }`);
         }
       }
-      if (isSchemaEmpty(data.outputSchema)) {
-        output.warn("No outputSchema provided. This may limit optimization effectiveness.");
-      } else if (!isValidJsonSchema(data.outputSchema)) {
+      if (!isValidJsonSchema(data.outputSchema)) {
         output.warn(formatSchemaWarning("outputSchema"));
+      } else {
+        const missingOutputDescs = validateSchemaDescriptions(data.outputSchema);
+        if (missingOutputDescs.length > 0) {
+          throw new MutagentError("VALIDATION_ERROR", `outputSchema properties missing descriptions: ${missingOutputDescs.join(", ")}`, `Run: mutagent prompts create --help
+Add a 'description' field to each property in your outputSchema. Example: { "properties": { "field": { "type": "string", "description": "What this field contains" } } }`);
+        }
       }
       const client = await getSDKClient();
       const prompt = await client.createPrompt(data);
@@ -3696,6 +3738,13 @@ Examples:
 ` + `Add a 'description' field to each property in your inputSchema. Example: { "properties": { "field": { "type": "string", "description": "What this field contains" } } }`);
         }
       }
+      if (data.outputSchema && isValidJsonSchema(data.outputSchema)) {
+        const missingOutputDescs = validateSchemaDescriptions(data.outputSchema);
+        if (missingOutputDescs.length > 0) {
+          throw new MutagentError("VALIDATION_ERROR", `outputSchema properties missing descriptions: ${missingOutputDescs.join(", ")}`, `Run: mutagent prompts update --help
+` + `Add a 'description' field to each property in your outputSchema. Example: { "properties": { "field": { "type": "string", "description": "What this field contains" } } }`);
+        }
+      }
       if (Object.keys(data).length === 0) {
         throw new MutagentError("MISSING_ARGUMENTS", "No update data provided", `Run: mutagent prompts update --help
 ` + "Use --name, --raw, --system/--human, --messages, --input-schema, or --output-schema");
@@ -4117,7 +4166,76 @@ async function fetchAndBuildGuidedDatasetWorkflow(promptId) {
   return result;
 }
 
+// src/commands/prompts/dataset-file-utils.ts
+init_errors();
+import { readFileSync as readFileSync5, existsSync as existsSync5 } from "fs";
+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", `Run: mutagent prompts dataset add --help
+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}`, `Run: mutagent prompts dataset add --help
+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}`, `Run: mutagent prompts dataset add --help
+Each line must be valid JSON. Problem line: "${trimmedLine.substring(0, 80)}${trimmedLine.length > 80 ? "..." : ""}"`);
+    }
+  }
+  return JSON.stringify(items);
+}
+function readDatasetFile(filePath) {
+  if (!existsSync5(filePath)) {
+    throw new MutagentError("FILE_NOT_FOUND", `File not found: ${filePath}`, `Run: mutagent prompts dataset add --help
+Verify the file path exists and is readable.`);
+  }
+  const rawContent = readFileSync5(filePath, "utf-8");
+  const content = parseDatasetFile(rawContent, filePath);
+  if (filePath.endsWith(".csv")) {
+    return { content, expectedItemCount: null };
+  }
+  const expectedItemCount = JSON.parse(content).length;
+  return { content, expectedItemCount };
+}
+
 // src/commands/prompts/datasets.ts
+async function verifyItemCount(client, datasetId, expectedItemCount, isJson, output, uploadHint) {
+  try {
+    const fetched = await client.getDataset(datasetId);
+    const serverCount = fetched.itemCount;
+    if (serverCount !== undefined && serverCount !== expectedItemCount) {
+      throw new MutagentError("ITEM_COUNT_MISMATCH", `Dataset created but itemCount mismatch: expected ${String(expectedItemCount)}, server reports ${String(serverCount)}`, `The server may have rolled back part of the bulk insert. Re-upload with:
+${uploadHint}`);
+    }
+  } catch (err) {
+    if (err instanceof MutagentError)
+      throw err;
+    if (!isJson)
+      output.warn("Could not verify itemCount after upload (re-fetch failed)");
+  }
+}
 function registerDatasetCommands(prompts) {
   const dataset = new Command3("dataset").description("Manage datasets for prompts").addHelpText("after", `
 Examples:
@@ -4217,12 +4335,21 @@ Verify the dataset ID exists, or list datasets for a prompt to find valid IDs.`)
       }
     }
   });
-  dataset.command("add").description("Add dataset to a prompt").argument("[prompt-id]", "Prompt ID (from: mutagent prompts list) — optional when --guided is set").option("-d, --data <json>", "Inline JSON array of dataset items").option("-n, --name <name>", "Dataset name").option("--guided", "Guided mode — analyze prompt schema and suggest dataset categories. prompt-id is optional when --guided is set.").addHelpText("after", `
+  dataset.command("add").description("Add dataset to a prompt").argument("[prompt-id]", "Prompt ID (from: mutagent prompts list) — optional when --guided is set").option("-d, --data <json>", "Inline JSON array of dataset items").option("-f, --file <path>", "Path to a JSONL or JSON file. JSONL: one JSON object per line. JSON: array of objects. Avoids shell ARG_MAX limits for large datasets.").option("-n, --name <name>", "Dataset name").option("--guided", "Guided mode — analyze prompt schema and suggest dataset categories. prompt-id is optional when --guided is set.").option("--allow-missing-expected", "Skip the expectedOutput requirement (backwards-compat escape hatch). Items missing expectedOutput are uploaded but evaluation scoring will be broken.").addHelpText("after", `
 Examples:
   ${chalk8.dim("$")} mutagent prompts dataset add --guided --json                 # no prompt-id: returns generic workflow + upload instructions
   ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> --guided --json    # recommended: schema-aware category suggestions
   ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{"text":"hello"},"expectedOutput":{"result":"world"}}]'
   ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{"text":"hello"},"expectedOutput":{"result":"world"}}]' --name "My Dataset"
+  ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> -f ./items.jsonl --name "My Dataset"   # recommended for large datasets (avoids ARG_MAX)
+  ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> -f ./items.json --name "My Dataset"    # JSON array file
+  ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{"text":"hello"}}]' --name "legacy" --allow-missing-expected
+
+File mode (-f / --file):
+  Streams the file line-by-line (JSONL) or parses it as a JSON array, then submits as a
+  single bulk request. Throws with the line number on any malformed line.
+  Avoids the macOS ARG_MAX limit that truncates large -d payloads.
+  After upload, re-fetches the created dataset and verifies itemCount matches the file.
 
 Guided mode (--guided):
   Fetches the prompt's inputSchema + outputSchema and returns structured JSON
@@ -4244,7 +4371,8 @@ ${chalk8.yellow("AI Agent (MANDATORY):")}
   expectedOutput is REQUIRED for evaluation scoring.
   Check schemas: mutagent prompts get <prompt-id> --json
 
-${chalk8.red("Required: --data or --guided must be provided.")}
+${chalk8.red("Required: --data, --file, or --guided must be provided.")}
+${chalk8.yellow("--allow-missing-expected: Use ONLY for legacy datasets where expectedOutput cannot be provided. Evaluation will not work without it.")}
     `).action(async (promptId, options) => {
     const isJson = options.guided ? true : getJsonFlag(prompts);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -4264,23 +4392,30 @@ ${chalk8.red("Required: --data or --guided must be provided.")}
 ` + `Usage: mutagent prompts dataset add <prompt-id> [options]
 ` + "With --guided: mutagent prompts dataset add --guided --json (returns generic workflow)");
       }
-      if (!options.data) {
-        throw new MutagentError("MISSING_ARGUMENTS", "-d/--data is required", `Run: mutagent prompts dataset add --help
-` + "Use -d '[{...}]' to provide inline JSON data");
+      if (!options.data && !options.file) {
+        throw new MutagentError("MISSING_ARGUMENTS", "-d/--data or -f/--file is required", `Run: mutagent prompts dataset add --help
+` + "Use -d '[{...}]' for inline JSON, or -f ./items.jsonl for file upload (recommended for large datasets)");
       }
       let content;
-      try {
-        const parsed = JSON.parse(options.data);
-        if (!Array.isArray(parsed)) {
-          throw new MutagentError("INVALID_JSON", "Inline data must be a JSON array", `Run: mutagent prompts dataset add --help
+      let expectedItemCount = null;
+      if (options.file) {
+        const result = readDatasetFile(options.file);
+        content = result.content;
+        expectedItemCount = result.expectedItemCount;
+      } else {
+        try {
+          const parsed = JSON.parse(options.data);
+          if (!Array.isArray(parsed)) {
+            throw new MutagentError("INVALID_JSON", "Inline data must be a JSON array", `Run: mutagent prompts dataset add --help
 ` + `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", `Run: mutagent prompts dataset add --help
+          }
+          content = options.data;
+        } catch (e) {
+          if (e instanceof MutagentError)
+            throw e;
+          throw new MutagentError("INVALID_JSON", "Invalid JSON in -d/--data flag", `Run: mutagent prompts dataset add --help
 ` + `Provide a valid JSON array, e.g., '[{"input": {...}, "expectedOutput": {...}}]'`);
+        }
       }
       const parsedItems = JSON.parse(content);
       if (parsedItems.length === 0) {
@@ -4288,6 +4423,7 @@ ${chalk8.red("Required: --data or --guided must be provided.")}
 Provide at least one item in the array.`);
       }
       const warnings = [];
+      const missingExpectedIndices = [];
       for (let i = 0;i < parsedItems.length; i++) {
         const item = parsedItems[i];
         if (!("input" in item)) {
@@ -4299,9 +4435,18 @@ Each item must have: {"input": {...}, "expectedOutput": {...}}`);
 "input" must be a JSON object: {"input": {"field": "value"}}`);
         }
         if (!("expectedOutput" in item)) {
-          warnings.push(`Item at index ${i} is missing "expectedOutput" (recommended for evaluation scoring)`);
+          missingExpectedIndices.push(i);
         }
       }
+      if (missingExpectedIndices.length > 0) {
+        if (!options.allowMissingExpected) {
+          throw new MutagentError("VALIDATION_ERROR", `${missingExpectedIndices.length} dataset item(s) are missing "expectedOutput" at indices: ${missingExpectedIndices.join(", ")}`, `Run: mutagent prompts dataset add --help
+` + `Each item must have: {"input": {...}, "expectedOutput": {...}}
+` + `"expectedOutput" is required for evaluation scoring.
+` + "If you intentionally want to upload items without expectedOutput, use: --allow-missing-expected");
+        }
+        warnings.push(`${missingExpectedIndices.length} item(s) missing "expectedOutput" at indices: ${missingExpectedIndices.join(", ")}. Evaluation scoring will not work.`);
+      }
       const datasetName = options.name;
       if (!datasetName) {
         throw new MutagentError("MISSING_ARGUMENTS", "Dataset name is required", `Run: mutagent prompts dataset add --help
@@ -4311,6 +4456,10 @@ Each item must have: {"input": {...}, "expectedOutput": {...}}`);
       const resolvedPromptId = promptId;
       const client = await getSDKClient();
       const datasetResult = await client.addDataset(resolvedPromptId, content, datasetName);
+      if (expectedItemCount !== null && datasetResult.id !== undefined) {
+        const hint = `mutagent prompts dataset add ${resolvedPromptId} -f ${options.file ?? "<file>"} --name "${datasetName}"`;
+        await verifyItemCount(client, datasetResult.id, expectedItemCount, isJson, output, hint);
+      }
       if (isJson) {
         let rsState;
         try {
@@ -4344,9 +4493,10 @@ Each item must have: {"input": {...}, "expectedOutput": {...}}`);
         });
         console.log(hints);
       }
+      const dataSource = options.file ? `file:${options.file}` : "inline-data";
       updateMutationContext((ctx) => {
-        ctx.addDiscoveredDataset("inline-data", datasetResult.name, datasetResult.itemCount ?? 0);
-        ctx.markDatasetUploaded("inline-data", String(datasetResult.id), resolvedPromptId);
+        ctx.addDiscoveredDataset(dataSource, datasetResult.name, datasetResult.itemCount ?? 0);
+        ctx.markDatasetUploaded(dataSource, String(datasetResult.id), resolvedPromptId);
       });
     } catch (error) {
       handleError(error, isJson);
@@ -6319,14 +6469,21 @@ ${chalk16.bold("Hit a bug or unexpected result?")}
           output.warn("--optimizer-model is deprecated, use --opt-model");
         options.optModel = options.optModel ?? options.optimizerModel;
       }
-      if (options.optModel) {
-        validateOptimizerModel(options.optModel);
+      const resolvedExecModel = options.execModel ?? options.model;
+      const resolvedEvalModel = options.evalModel ?? options.model;
+      const resolvedOptModel = options.optModel ?? options.model;
+      if (resolvedOptModel) {
+        validateOptimizerModel(resolvedOptModel);
       }
-      const execModel = options.execModel ?? options.model;
-      if (!execModel && !isJson) {
-        output.warn("No --model specified. Server will use default. Pass --model <id> to control costs.");
+      if (!resolvedExecModel && !isJson) {
+        output.warn("No --model specified. Server will use workspace defaults. Pass --model <id> to control costs.");
       }
-      if (execModel) {
+      const modelsToValidate = [
+        ...resolvedExecModel ? [{ slot: "exec", model: resolvedExecModel }] : [],
+        ...resolvedEvalModel && resolvedEvalModel !== resolvedExecModel ? [{ slot: "eval", model: resolvedEvalModel }] : [],
+        ...resolvedOptModel && resolvedOptModel !== resolvedExecModel && resolvedOptModel !== resolvedEvalModel ? [{ slot: "opt", model: resolvedOptModel }] : []
+      ];
+      if (modelsToValidate.length > 0) {
         try {
           const providers = await client.listProviders();
           if (providers.data && providers.data.length > 0) {
@@ -6339,18 +6496,20 @@ ${chalk16.bold("Hit a bug or unexpected result?")}
               }
             } else {
               const modelFamilies = getModelFamiliesForProviderTypes(configuredTypes);
-              const modelLower = execModel.toLowerCase();
-              const matchedFamily = modelFamilies.find(({ prefixes }) => prefixes.some((prefix) => modelLower.startsWith(prefix)));
-              if (!matchedFamily) {
-                const supportedModels = modelFamilies.flatMap((f) => f.examples).join(", ");
-                const errorMsg = `Model '${execModel}' is not supported by any configured provider. ` + `Your providers: [${configuredTypes.join(", ")}]. ` + `Supported models: ${supportedModels || "(unknown — check mutagent providers list --json)"}. ` + `Run: mutagent providers list --json`;
-                if (isJson) {
-                  output.output({ success: false, error: errorMsg, code: "MODEL_NOT_SUPPORTED" });
+              for (const { slot, model } of modelsToValidate) {
+                const modelLower = model.toLowerCase();
+                const matchedFamily = modelFamilies.find(({ prefixes }) => prefixes.some((prefix) => modelLower.startsWith(prefix)));
+                if (!matchedFamily) {
+                  const supportedModels = modelFamilies.flatMap((f) => f.examples).join(", ");
+                  const errorMsg = `${slot} model '${model}' is not supported by any configured provider. ` + `Your providers: [${configuredTypes.join(", ")}]. ` + `Supported models: ${supportedModels || "(unknown — check mutagent providers list --json)"}. ` + `Run: mutagent providers list --json`;
+                  if (isJson) {
+                    output.output({ success: false, error: errorMsg, code: "MODEL_NOT_SUPPORTED" });
+                    return;
+                  }
+                  output.error(errorMsg);
+                  process.exitCode = 1;
                   return;
                 }
-                output.error(errorMsg);
-                process.exitCode = 1;
-                return;
               }
             }
           }
@@ -6507,10 +6666,9 @@ ${chalk16.bold("Hit a bug or unexpected result?")}
         maxIterations: options.maxIterations ? parseInt(options.maxIterations, 10) : 1,
         targetScore: options.targetScore ? parseFloat(options.targetScore) : undefined,
         patience: options.patience ? parseInt(options.patience, 10) : undefined,
-        model: options.execModel ? undefined : options.model,
-        execModel: options.execModel,
-        evalModel: options.evalModel,
-        optModel: options.optModel,
+        executionModel: resolvedExecModel,
+        evaluationModel: resolvedEvalModel,
+        optimizationModel: resolvedOptModel,
         providerId: options.providerId,
         evalProviderId: options.evalProviderId,
         optProviderId: options.optProviderId
@@ -6959,12 +7117,12 @@ Provide a valid JSON Schema, e.g., '{"type":"object","properties":{"field":{"typ
     }
   }
   if (filePath) {
-    if (!existsSync5(filePath)) {
+    if (!existsSync6(filePath)) {
       throw new MutagentError("FILE_NOT_FOUND", `File not found: ${filePath}`, `Run: ${helpCommand}
 Check the file path and try again`);
     }
     try {
-      return JSON.parse(readFileSync5(filePath, "utf-8"));
+      return JSON.parse(readFileSync6(filePath, "utf-8"));
     } catch {
       throw new MutagentError("INVALID_JSON", `Failed to parse JSON from ${filePath}`, `Run: ${helpCommand}
 Ensure the file contains valid JSON Schema`);
@@ -7262,20 +7420,20 @@ ${chalk22.dim("Returns full trace details including spans, tokens, and latency."
 init_config();
 import { Command as Command9 } from "commander";
 import chalk23 from "chalk";
-import { writeFileSync as writeFileSync3, existsSync as existsSync10 } from "fs";
+import { writeFileSync as writeFileSync3, existsSync as existsSync11 } from "fs";
 import { execSync } from "child_process";
 init_errors();
 
 // src/lib/integrations/langchain.ts
-import { readFileSync as readFileSync6, existsSync as existsSync6 } from "fs";
+import { readFileSync as readFileSync7, existsSync as existsSync7 } from "fs";
 var langchainIntegration = {
   name: "langchain",
   description: "LangChain framework",
   detect() {
     let hasLangchain = false;
-    if (existsSync6("package.json")) {
+    if (existsSync7("package.json")) {
       try {
-        const pkg = JSON.parse(readFileSync6("package.json", "utf-8"));
+        const pkg = JSON.parse(readFileSync7("package.json", "utf-8"));
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
         hasLangchain = "langchain" in deps || "@langchain/core" in deps;
       } catch {}
@@ -7407,15 +7565,15 @@ mutagent traces analyze <prompt-id>
 };
 
 // src/lib/integrations/langgraph.ts
-import { readFileSync as readFileSync7, existsSync as existsSync7 } from "fs";
+import { readFileSync as readFileSync8, existsSync as existsSync8 } from "fs";
 var langgraphIntegration = {
   name: "langgraph",
   description: "LangGraph agent workflow framework",
   detect() {
     let hasLanggraph = false;
-    if (existsSync7("package.json")) {
+    if (existsSync8("package.json")) {
       try {
-        const pkg = JSON.parse(readFileSync7("package.json", "utf-8"));
+        const pkg = JSON.parse(readFileSync8("package.json", "utf-8"));
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
         hasLanggraph = "@langchain/langgraph" in deps;
       } catch {}
@@ -7497,15 +7655,15 @@ mutagent integrate langgraph --verify
 };
 
 // src/lib/integrations/vercel-ai.ts
-import { readFileSync as readFileSync8, existsSync as existsSync8 } from "fs";
+import { readFileSync as readFileSync9, existsSync as existsSync9 } from "fs";
 var vercelAiIntegration = {
   name: "vercel-ai",
   description: "Vercel AI SDK",
   detect() {
     let hasAiSdk = false;
-    if (existsSync8("package.json")) {
+    if (existsSync9("package.json")) {
       try {
-        const pkg = JSON.parse(readFileSync8("package.json", "utf-8"));
+        const pkg = JSON.parse(readFileSync9("package.json", "utf-8"));
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
         hasAiSdk = "ai" in deps;
       } catch {}
@@ -7647,15 +7805,15 @@ mutagent integrate vercel-ai --verify
 };
 
 // src/lib/integrations/openai.ts
-import { readFileSync as readFileSync9, existsSync as existsSync9 } from "fs";
+import { readFileSync as readFileSync10, existsSync as existsSync10 } from "fs";
 var openaiIntegration = {
   name: "openai",
   description: "OpenAI SDK integration with automatic tracing",
   detect() {
     let hasOpenAI = false;
-    if (existsSync9("package.json")) {
+    if (existsSync10("package.json")) {
       try {
-        const pkg = JSON.parse(readFileSync9("package.json", "utf-8"));
+        const pkg = JSON.parse(readFileSync10("package.json", "utf-8"));
         const deps = { ...pkg.dependencies, ...pkg.devDependencies };
         hasOpenAI = "openai" in deps;
       } catch {}
@@ -7804,16 +7962,16 @@ function getFrameworkMetadata(name) {
 
 // src/commands/integrate.ts
 function detectPackageManager() {
-  if (existsSync10("bun.lockb") || existsSync10("bun.lock")) {
+  if (existsSync11("bun.lockb") || existsSync11("bun.lock")) {
     return "bun";
   }
-  if (existsSync10("pnpm-lock.yaml")) {
+  if (existsSync11("pnpm-lock.yaml")) {
     return "pnpm";
   }
-  if (existsSync10("yarn.lock")) {
+  if (existsSync11("yarn.lock")) {
     return "yarn";
   }
-  if (existsSync10("package-lock.json")) {
+  if (existsSync11("package-lock.json")) {
     return "npm";
   }
   try {
@@ -9199,13 +9357,13 @@ init_config();
 import { Command as Command15 } from "commander";
 import inquirer2 from "inquirer";
 import chalk34 from "chalk";
-import { existsSync as existsSync12, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
 import { execSync as execSync3 } from "child_process";
 import { join as join7 } from "path";
 init_errors();
 
 // src/lib/framework-detection.ts
-import { existsSync as existsSync11, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync11 } from "fs";
 import { execSync as execSync2 } from "child_process";
 import { join as join6 } from "path";
 var FRAMEWORK_DETECTION_MAP = {
@@ -9257,16 +9415,16 @@ var FRAMEWORK_DETECTION_MAP = {
   }
 };
 function detectPackageManager2(cwd = process.cwd()) {
-  if (existsSync11(join6(cwd, "bun.lockb")) || existsSync11(join6(cwd, "bun.lock"))) {
+  if (existsSync12(join6(cwd, "bun.lockb")) || existsSync12(join6(cwd, "bun.lock"))) {
     return "bun";
   }
-  if (existsSync11(join6(cwd, "pnpm-lock.yaml"))) {
+  if (existsSync12(join6(cwd, "pnpm-lock.yaml"))) {
     return "pnpm";
   }
-  if (existsSync11(join6(cwd, "yarn.lock"))) {
+  if (existsSync12(join6(cwd, "yarn.lock"))) {
     return "yarn";
   }
-  if (existsSync11(join6(cwd, "package-lock.json"))) {
+  if (existsSync12(join6(cwd, "package-lock.json"))) {
     return "npm";
   }
   try {
@@ -9288,12 +9446,12 @@ function getInstallCommand2(pm, packages) {
 }
 function detectFrameworkFromPackageJson(cwd = process.cwd()) {
   const pkgPath = join6(cwd, "package.json");
-  if (!existsSync11(pkgPath)) {
+  if (!existsSync12(pkgPath)) {
     return null;
   }
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync10(pkgPath, "utf-8"));
+    pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
   } catch {
     return null;
   }
@@ -9309,7 +9467,7 @@ function detectFrameworkFromPackageJson(cwd = process.cwd()) {
   return null;
 }
 function hasRcConfig(cwd = process.cwd()) {
-  return existsSync11(join6(cwd, ".mutagentrc.json"));
+  return existsSync12(join6(cwd, ".mutagentrc.json"));
 }
 
 // src/commands/init.ts
@@ -9531,7 +9689,7 @@ Modes:
         }
       }
       const skillPath = join7(cwd, ".claude/skills/mutagent-cli/SKILL.md");
-      const skillInstalled = existsSync12(skillPath);
+      const skillInstalled = existsSync13(skillPath);
       if (!isNonInteractive && !skillInstalled) {
         const { installSkill } = await inquirer2.prompt([{
           type: "confirm",
@@ -9542,7 +9700,7 @@ Modes:
         if (installSkill) {
           try {
             const skillDir = join7(cwd, ".claude/skills/mutagent-cli");
-            if (!existsSync12(skillDir)) {
+            if (!existsSync13(skillDir)) {
               mkdirSync3(skillDir, { recursive: true });
             }
             execSync3("node " + join7(cwd, "node_modules/.bin/mutagent") + " skills install", {
@@ -9593,7 +9751,7 @@ Modes:
         framework: confirmedFramework?.name ?? null,
         authenticated,
         workspaceValidation: workspaceValidation ?? null,
-        skillInstalled: skillInstalled || existsSync12(skillPath),
+        skillInstalled: skillInstalled || existsSync13(skillPath),
         _directive: initDirective
       };
       output.output(summary);
@@ -9767,7 +9925,7 @@ Scanning ${scanPath}...
 // src/commands/skills.ts
 import { Command as Command17 } from "commander";
 import chalk36 from "chalk";
-import { existsSync as existsSync13, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "fs";
 import { dirname, join as join8 } from "path";
 import { execSync as execSync4 } from "child_process";
 
@@ -10035,7 +10193,7 @@ After every CLI command:
 - **CI / automated**: \`export MUTAGENT_API_KEY=mt_... && mutagent login --json\` -- no browser, no prompts.
 - **Onboarding a user**: \`mutagent login --browser --json\` -- CLI prints auth URL to stdout, polls 5 min. **Surface the URL verbatim to the user.** \`--non-interactive\` is NOT needed when \`--browser\` is set.
 
-\`mutagent login\` is canonical. \`mutagent auth login\` is a back-compat alias. Both delegate to \`lib/auth-flow.ts\`. Decision record: [cli-design-principles.md](../../docs/cli-design-principles.md) -> Login Unification.
+\`mutagent login\` is canonical. \`mutagent auth login\` is a back-compat alias. Both delegate to a single shared implementation; they are thin wrappers and stay that way by design.
 
 ---
 
@@ -12294,7 +12452,7 @@ that teaches coding agents how to use the MutagenT CLI effectively.
     for (const relPath of sortedKeys) {
       const destPath = join8(skillDir, relPath);
       const parentDir = dirname(destPath);
-      if (!existsSync13(parentDir)) {
+      if (!existsSync14(parentDir)) {
         mkdirSync4(parentDir, { recursive: true });
       }
       const raw = files[relPath] ?? "";
@@ -12428,7 +12586,7 @@ import { Command as Command19 } from "commander";
 import { randomUUID } from "crypto";
 
 // src/commands/hooks/state.ts
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync6, renameSync, unlinkSync, existsSync as existsSync14 } from "fs";
+import { readFileSync as readFileSync12, writeFileSync as writeFileSync6, renameSync, unlinkSync, existsSync as existsSync15 } from "fs";
 import { join as join9 } from "path";
 import { tmpdir } from "os";
 function stateFilePath(sessionId) {
@@ -12436,10 +12594,10 @@ function stateFilePath(sessionId) {
 }
 function readState(sessionId) {
   const path = stateFilePath(sessionId);
-  if (!existsSync14(path))
+  if (!existsSync15(path))
     return null;
   try {
-    const raw = JSON.parse(readFileSync11(path, "utf-8"));
+    const raw = JSON.parse(readFileSync12(path, "utf-8"));
     if (!Array.isArray(raw.parentStack)) {
       raw.parentStack = [];
     }
@@ -12459,7 +12617,7 @@ function writeState(sessionId, state) {
 }
 function deleteState(sessionId) {
   const path = stateFilePath(sessionId);
-  if (existsSync14(path)) {
+  if (existsSync15(path)) {
     try {
       unlinkSync(path);
     } catch {}
@@ -13106,7 +13264,7 @@ async function handlePostToolUseFailure() {
 }
 
 // src/commands/hooks/install.ts
-import { readFileSync as readFileSync12, writeFileSync as writeFileSync7, existsSync as existsSync15, mkdirSync as mkdirSync5 } from "fs";
+import { readFileSync as readFileSync13, writeFileSync as writeFileSync7, existsSync as existsSync16, mkdirSync as mkdirSync5 } from "fs";
 import { join as join10 } from "path";
 
 class SettingsParseError extends Error {
@@ -13171,10 +13329,10 @@ function migrateV1Hooks(settings) {
 function installHooks(cwd) {
   const claudeDir = join10(cwd, ".claude");
   const settingsPath = join10(claudeDir, "settings.local.json");
-  const existed = existsSync15(settingsPath);
+  const existed = existsSync16(settingsPath);
   let settings = {};
   if (existed) {
-    const raw = readFileSync12(settingsPath, "utf-8");
+    const raw = readFileSync13(settingsPath, "utf-8");
     try {
       settings = JSON.parse(raw);
     } catch (err) {
@@ -13209,7 +13367,7 @@ function installHooks(cwd) {
   }
   let userWarning;
   if (added.length > 0 || migrated.length > 0) {
-    if (!existsSync15(claudeDir)) {
+    if (!existsSync16(claudeDir)) {
       mkdirSync5(claudeDir, { recursive: true });
     }
     writeFileSync7(settingsPath, JSON.stringify(settings, null, 2) + `
@@ -13359,7 +13517,7 @@ import { Command as Command20 } from "commander";
 import chalk38 from "chalk";
 init_errors();
 init_config();
-import { readFileSync as readFileSync13, existsSync as existsSync16 } from "fs";
+import { readFileSync as readFileSync14, existsSync as existsSync17 } from "fs";
 import { join as join11, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
 var VALID_CATEGORIES = ["bug", "feature", "improvement", "praise"];
@@ -13370,7 +13528,7 @@ function getCliVersion() {
   try {
     const __dirname2 = dirname2(fileURLToPath(import.meta.url));
     const pkgPath = join11(__dirname2, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
     return pkg.version ?? "0.1.1";
   } catch {
     return "0.1.1";
@@ -13401,12 +13559,12 @@ async function resolveContextSource(source, _readStdinOverride) {
     raw = await (_readStdinOverride ?? readStdin2)();
   } else if (source.startsWith("@")) {
     const filePath = source.slice(1);
-    if (!existsSync16(filePath)) {
+    if (!existsSync17(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 = readFileSync13(filePath, "utf-8").trim();
+      raw = readFileSync14(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}"`);
@@ -13559,7 +13717,7 @@ if (process.env.CLI_VERSION) {
   try {
     const __dirname2 = dirname3(fileURLToPath2(import.meta.url));
     const pkgPath = join12(__dirname2, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync15(pkgPath, "utf-8"));
     cliVersion = pkg.version ?? cliVersion;
   } catch {}
 }
@@ -13754,11 +13912,11 @@ var isInteractive = process.stdin.isTTY && !rawArgs.includes("--json") && proces
 var isSkillCommand = rawArgs[0] === "skills" || rawArgs[0] === "hooks";
 if (isInteractive && !isSkillCommand) {
   const skillPath = join12(process.cwd(), ".claude/skills/mutagent-cli/SKILL.md");
-  if (!existsSync17(skillPath)) {
+  if (!existsSync18(skillPath)) {
     console.log(chalk39.dim("MutagenT SKILL not installed. Install it for AI agent support? Run:"), chalk39.cyan("mutagent skills install"));
   }
 }
 program.parse();
 
-//# debugId=6F6C59E53DD7DB6E64756E2164756E21
+//# debugId=62DF92692E0B964164756E2164756E21
 //# sourceMappingURL=cli.js.map