@mutagent/cli 0.1.53 → 0.1.55

package/dist/bin/cli.js

@@ -608,7 +608,7 @@ class SDKClientWrapper {
   async deletePrompt(id, options) {
     try {
       if (options?.force) {
-        await this.request(`/api/prompts/${id}?force=true`, { method: "DELETE" });
+        await this.request(`/api/prompt/${id}?force=true`, { method: "DELETE" });
       } else {
         await this.sdk.prompt.deletePrompt({ id: parseInt(id, 10) });
       }
@@ -1003,6 +1003,45 @@ class SDKClientWrapper {
       this.handleError(error);
     }
   }
+  async createProvider(data) {
+    try {
+      const response = await this.sdk.providerConfigs.createProvider({
+        name: data.name,
+        provider: data.provider,
+        apiKey: data.apiKey,
+        scope: data.scope ?? {},
+        baseUrl: data.baseUrl,
+        isDefault: data.isDefault
+      });
+      return response;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  async updateProvider(id, data) {
+    try {
+      const response = await this.sdk.providerConfigs.updateProvider({
+        id,
+        body: {
+          name: data.name,
+          apiKey: data.apiKey,
+          isActive: data.isActive,
+          isDefault: data.isDefault,
+          baseUrl: data.baseUrl
+        }
+      });
+      return response;
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  async deleteProvider(id) {
+    try {
+      await this.sdk.providerConfigs.deleteProvider({ id });
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
 }
 function getSDKClient() {
   if (!sdkClient) {
@@ -1067,7 +1106,7 @@ var init_sdk_client = __esm(() => {
 
 // src/bin/cli.ts
 import { Command as Command19 } from "commander";
-import chalk27 from "chalk";
+import chalk30 from "chalk";
 import { readFileSync as readFileSync11 } from "fs";
 import { join as join9, dirname } from "path";
 import { fileURLToPath } from "url";
@@ -7208,11 +7247,290 @@ Examples:
   return workspaces;
 }
 
-// src/commands/providers.ts
+// src/commands/providers/index.ts
 init_sdk_client();
 import { Command as Command13 } from "commander";
+import chalk25 from "chalk";
+init_errors();
+
+// src/commands/providers/add.ts
+init_sdk_client();
 import chalk22 from "chalk";
 init_errors();
+function resolveScope(scopeFlag, client) {
+  const scope = scopeFlag ?? "workspace";
+  if (scope === "workspace") {
+    const wsId = client.getCurrentWorkspaceId();
+    if (!wsId) {
+      throw new MutagentError("MISSING_WORKSPACE", "No workspace configured. Cannot create workspace-scoped provider.", "Run: mutagent config set defaultWorkspace <workspace-id>");
+    }
+    return { workspaceId: wsId };
+  }
+  if (scope === "org") {
+    const orgId = client.getCurrentOrgId();
+    if (!orgId) {
+      throw new MutagentError("MISSING_ORGANIZATION", "No organization configured. Cannot create org-scoped provider.", "Run: mutagent config set defaultOrganization <org-id>");
+    }
+    return { organizationId: orgId };
+  }
+  return {};
+}
+function registerAddCommand(parent) {
+  parent.command("add").description("Add a new provider configuration").requiredOption("-p, --provider <type>", "Provider type (openai, anthropic, google, ...)").requiredOption("-n, --name <name>", "Display name for this provider").requiredOption("-k, --api-key <key>", "API key for the provider").option("-s, --scope <scope>", "Scope: workspace (default), org, user", "workspace").option("--base-url <url>", "Custom base URL for the provider API").option("--set-default", "Set as default provider for this scope").addHelpText("after", `
+Examples:
+  ${chalk22.dim("$")} mutagent providers add --provider openai --name "My OpenAI" --api-key $OPENAI_API_KEY
+  ${chalk22.dim("$")} mutagent providers add --provider anthropic --name "Team Claude" --api-key $KEY --scope org
+  ${chalk22.dim("$")} mutagent providers add --provider openai --name "Personal" --api-key $KEY --scope user --set-default
+  ${chalk22.dim("$")} mutagent providers add --provider custom --name "Ollama" --api-key none --base-url http://localhost:11434 --json
+
+Scope Resolution:
+  workspace (default)   Uses your configured workspace
+  org                   Uses your configured organization
+  user                  Personal provider config
+
+The API key is encrypted server-side and never returned in plain text.
+    `).action(async (options) => {
+    const isJson = getJsonFlag(parent);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      const providerType = validateProviderType(options.provider);
+      if (!options.apiKey || options.apiKey.trim() === "") {
+        throw new MutagentError("MISSING_API_KEY", "API key cannot be empty", "Provide a valid API key with --api-key");
+      }
+      const validScopes = ["workspace", "org", "user"];
+      if (options.scope && !validScopes.includes(options.scope)) {
+        throw new MutagentError("INVALID_SCOPE", `Invalid scope: ${options.scope}`, `Valid scopes: ${validScopes.join(", ")}`);
+      }
+      const client = getSDKClient();
+      const scope = resolveScope(options.scope, client);
+      const created = await client.createProvider({
+        name: options.name,
+        provider: providerType,
+        apiKey: options.apiKey,
+        scope,
+        baseUrl: options.baseUrl,
+        isDefault: options.setDefault
+      });
+      if (isJson) {
+        const directive = buildProviderCreatedDirective(created, options.scope ?? "workspace");
+        echoDirectiveToStderr(directive);
+        output.output({
+          success: true,
+          ...created,
+          _links: providerLinks(created.id),
+          _directive: directive
+        });
+      } else {
+        output.success(`Provider created: ${created.name ?? options.name}`);
+        console.log(`  ID:    ${String(created.id)}`);
+        console.log(`  Type:  ${providerType}`);
+        console.log(`  Scope: ${options.scope ?? "workspace"}`);
+        console.log(`  URL:   ${providerLink(created.id)}`);
+        if (options.setDefault) {
+          console.log(chalk22.green("  Set as default provider"));
+        }
+        console.log("");
+        console.log(chalk22.dim("API key is encrypted server-side. Use `providers get` to see masked key."));
+      }
+    } catch (error) {
+      handleError(error, isJson);
+    }
+  });
+}
+function buildProviderCreatedDirective(provider, scope) {
+  const title = `Provider Created — ${provider.name ?? "Unknown"}`;
+  const dashboardUrl = providerLink(provider.id);
+  const apiUrl = `/api/providers/${String(provider.id)}`;
+  const rows = [
+    { label: "Name", value: provider.name ?? "Unknown" },
+    { label: "Provider ID", value: String(provider.id) },
+    { label: "Scope", value: scope }
+  ];
+  const links = [
+    { label: "Settings", url: dashboardUrl },
+    { label: "API", url: apiUrl }
+  ];
+  const next = [
+    `mutagent providers test ${String(provider.id)} --json`,
+    `mutagent providers list --json`
+  ];
+  return {
+    display: "status_card",
+    template: "provider_created",
+    title,
+    fields: { providerId: String(provider.id), name: provider.name, scope },
+    links: { settings: dashboardUrl, api: apiUrl },
+    next,
+    instruction: "MANDATORY: Display this card to the user before proceeding.",
+    renderedCard: renderPlainCard({ title, icon: "+", rows, links, next })
+  };
+}
+
+// src/commands/providers/update.ts
+init_sdk_client();
+import chalk23 from "chalk";
+init_errors();
+function registerUpdateCommand(parent) {
+  parent.command("update").description("Update an existing provider configuration").argument("<id>", "Provider ID (from: mutagent providers list)").option("-n, --name <name>", "Updated display name").option("-k, --api-key <key>", "Updated API key (will be re-encrypted)").option("--active <bool>", "Activate or deactivate (true|false)").option("--set-default", "Set as default provider for its scope").option("--base-url <url>", 'Updated base URL (use "" to clear)').addHelpText("after", `
+Examples:
+  ${chalk23.dim("$")} mutagent providers update <id> --name "New Name"
+  ${chalk23.dim("$")} mutagent providers update <id> --api-key $NEW_KEY --json
+  ${chalk23.dim("$")} mutagent providers update <id> --active false
+  ${chalk23.dim("$")} mutagent providers update <id> --set-default --json
+
+PATCH semantics — only provided fields are updated.
+    `).action(async (id, options) => {
+    const isJson = getJsonFlag(parent);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      const updateData = {};
+      let hasUpdates = false;
+      if (options.name !== undefined) {
+        updateData.name = options.name;
+        hasUpdates = true;
+      }
+      if (options.apiKey !== undefined) {
+        updateData.apiKey = options.apiKey;
+        hasUpdates = true;
+      }
+      if (options.active !== undefined) {
+        if (options.active !== "true" && options.active !== "false") {
+          throw new MutagentError("INVALID_OPTION", `Invalid --active value: ${options.active}`, "Use --active true or --active false");
+        }
+        updateData.isActive = options.active === "true";
+        hasUpdates = true;
+      }
+      if (options.setDefault) {
+        updateData.isDefault = true;
+        hasUpdates = true;
+      }
+      if (options.baseUrl !== undefined) {
+        updateData.baseUrl = options.baseUrl === "" ? null : options.baseUrl;
+        hasUpdates = true;
+      }
+      if (!hasUpdates) {
+        throw new MutagentError("NO_UPDATES", "No update fields provided", "Provide at least one of: --name, --api-key, --active, --set-default, --base-url");
+      }
+      const client = getSDKClient();
+      const updated = await client.updateProvider(id, updateData);
+      if (isJson) {
+        const directive = buildProviderUpdatedDirective(updated, id);
+        echoDirectiveToStderr(directive);
+        output.output({
+          success: true,
+          ...updated,
+          _links: providerLinks(updated.id ?? id),
+          _directive: directive
+        });
+      } else {
+        output.success(`Provider updated: ${String(updated.name ?? id)}`);
+        console.log(`  ID:  ${String(updated.id ?? id)}`);
+        console.log(`  URL: ${providerLink(updated.id ?? id)}`);
+        if (options.apiKey) {
+          console.log(chalk23.dim("  API key re-encrypted server-side."));
+        }
+      }
+    } catch (error) {
+      handleError(error, isJson);
+    }
+  });
+}
+function buildProviderUpdatedDirective(provider, requestId) {
+  const id = provider.id ?? requestId;
+  const title = `Provider Updated — ${provider.name ?? String(id)}`;
+  const dashboardUrl = providerLink(id);
+  const apiUrl = `/api/providers/${String(id)}`;
+  const rows = [
+    { label: "Provider ID", value: String(id) },
+    ...provider.name ? [{ label: "Name", value: provider.name }] : []
+  ];
+  const links = [
+    { label: "Settings", url: dashboardUrl },
+    { label: "API", url: apiUrl }
+  ];
+  const next = [
+    `mutagent providers get ${String(id)} --json`,
+    `mutagent providers test ${String(id)} --json`
+  ];
+  return {
+    display: "status_card",
+    template: "provider_updated",
+    title,
+    fields: { providerId: String(id), name: provider.name },
+    links: { settings: dashboardUrl, api: apiUrl },
+    next,
+    instruction: "MANDATORY: Display this card to the user before proceeding.",
+    renderedCard: renderPlainCard({ title, icon: "~", rows, links, next })
+  };
+}
+
+// src/commands/providers/delete.ts
+init_sdk_client();
+import chalk24 from "chalk";
+init_errors();
+function registerDeleteCommand(parent) {
+  parent.command("delete").description("Delete a provider configuration").argument("<id>", "Provider ID (from: mutagent providers list)").option("-f, --force", "Skip confirmation prompt").addHelpText("after", `
+Examples:
+  ${chalk24.dim("$")} mutagent providers delete <id> --force
+  ${chalk24.dim("$")} mutagent providers delete <id> --force --json
+
+Safety:
+  --force is required in non-interactive (--json) mode.
+  Idempotent: deleting a non-existent provider returns success.
+    `).action(async (id, options) => {
+    const isJson = getJsonFlag(parent);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      if (isJson && !options.force) {
+        throw new MutagentError("CONFIRMATION_REQUIRED", "Delete requires --force flag in non-interactive (--json) mode", "Add --force to confirm deletion: mutagent providers delete <id> --force --json");
+      }
+      if (!isJson && !options.force) {
+        throw new MutagentError("CONFIRMATION_REQUIRED", `Deleting provider ${id} requires explicit confirmation`, `Add --force to confirm: mutagent providers delete ${id} --force`);
+      }
+      const client = getSDKClient();
+      try {
+        await client.deleteProvider(id);
+      } catch (error) {
+        if (error instanceof ApiError && error.statusCode === 404) {} else {
+          throw error;
+        }
+      }
+      if (isJson) {
+        const directive = buildProviderDeletedDirective(id);
+        echoDirectiveToStderr(directive);
+        output.output({
+          success: true,
+          deletedId: id,
+          _directive: directive
+        });
+      } else {
+        output.success(`Provider deleted: ${id}`);
+        console.log(`  Settings: ${providerSettingsLink()}`);
+      }
+    } catch (error) {
+      handleError(error, isJson);
+    }
+  });
+}
+function buildProviderDeletedDirective(id) {
+  const title = `Provider Deleted — ${id}`;
+  const settingsUrl = providerSettingsLink();
+  const rows = [{ label: "Provider ID", value: id }];
+  const links = [{ label: "Settings", url: settingsUrl }];
+  const next = [`mutagent providers list --json`];
+  return {
+    display: "status_card",
+    template: "provider_deleted",
+    title,
+    fields: { providerId: id },
+    links: { settings: settingsUrl },
+    next,
+    instruction: "MANDATORY: Display this card to the user before proceeding.",
+    renderedCard: renderPlainCard({ title, icon: "x", rows, links, next })
+  };
+}
+
+// src/commands/providers/index.ts
 var VALID_PROVIDER_TYPES = [
   "openai",
   "anthropic",
@@ -7233,29 +7551,26 @@ function validateProviderType(type) {
   return type;
 }
 function createProvidersCommand() {
-  const providers = new Command13("providers").description("View LLM providers (read-only)").addHelpText("after", `
+  const providers = new Command13("providers").description("Manage LLM provider configurations (BYOK)").addHelpText("after", `
 Examples:
-  ${chalk22.dim("$")} mutagent providers list
-  ${chalk22.dim("$")} mutagent providers get <provider-id>
-  ${chalk22.dim("$")} mutagent providers test <provider-id>
+  ${chalk25.dim("$")} mutagent providers list
+  ${chalk25.dim("$")} mutagent providers get <provider-id>
+  ${chalk25.dim("$")} mutagent providers add --provider openai --name "My OpenAI" --api-key $KEY
+  ${chalk25.dim("$")} mutagent providers update <id> --name "New Name"
+  ${chalk25.dim("$")} mutagent providers delete <id> --force
+  ${chalk25.dim("$")} mutagent providers test <provider-id>
 
 Provider Types:
   openai, anthropic, google, azure, bedrock, cohere, mistral, groq, together, replicate, custom
 
 Subcommands:
-  list, get, test
-
-Note: Provider management (create, update, delete) is available in the Admin Panel only.
-
-${chalk22.yellow("Note:")} The providers module is not yet active. This is a placeholder
-for future external provider configuration. The server currently uses
-built-in provider settings.
+  list, get, add, update, delete, test
     `);
   providers.command("list").description("List all providers").option("-l, --limit <n>", "Limit results", "50").option("-o, --offset <n>", "Offset for pagination").option("-t, --type <type>", "Filter by provider type").addHelpText("after", `
 Examples:
-  ${chalk22.dim("$")} mutagent providers list
-  ${chalk22.dim("$")} mutagent providers list --type openai
-  ${chalk22.dim("$")} mutagent providers list --json
+  ${chalk25.dim("$")} mutagent providers list
+  ${chalk25.dim("$")} mutagent providers list --type openai
+  ${chalk25.dim("$")} mutagent providers list --json
     `).action(async (options) => {
     const isJson = getJsonFlag(providers);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -7282,8 +7597,6 @@ Examples:
         }));
         output.output({ ...result, data: withLinks });
       } else {
-        console.log(chalk22.yellow("Note: The providers module is not yet active. This is a placeholder for future external provider configuration."));
-        console.log("");
         if (result.data.length === 0) {
           output.info("No providers configured.");
           output.info(`Configure at: ${providerSettingsLink()}`);
@@ -7306,8 +7619,8 @@ Examples:
   });
   providers.command("get").description("Get provider details").argument("<id>", "Provider ID (from: mutagent providers list)").addHelpText("after", `
 Examples:
-  ${chalk22.dim("$")} mutagent providers get <provider-id>
-  ${chalk22.dim("$")} mutagent providers get <provider-id> --json
+  ${chalk25.dim("$")} mutagent providers get <provider-id>
+  ${chalk25.dim("$")} mutagent providers get <provider-id> --json
     `).action(async (id) => {
     const isJson = getJsonFlag(providers);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -7317,8 +7630,6 @@ Examples:
       if (isJson) {
         output.output({ ...provider, _links: providerLinks(provider.id) });
       } else {
-        console.log(chalk22.yellow("Note: The providers module is not yet active. This is a placeholder for future external provider configuration."));
-        console.log("");
         const formatted = {
           id: provider.id,
           name: provider.name,
@@ -7338,18 +7649,16 @@ Examples:
   });
   providers.command("test").description("Test provider connectivity").argument("<id>", "Provider ID (from: mutagent providers list)").addHelpText("after", `
 Examples:
-  ${chalk22.dim("$")} mutagent providers test <provider-id>
-  ${chalk22.dim("$")} mutagent providers test <provider-id> --json
+  ${chalk25.dim("$")} mutagent providers test <provider-id>
+  ${chalk25.dim("$")} mutagent providers test <provider-id> --json
 
-${chalk22.dim("Tests connectivity and lists available models for the provider.")}
+${chalk25.dim("Tests connectivity and lists available models for the provider.")}
     `).action(async (id) => {
     const isJson = getJsonFlag(providers);
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
       const client = getSDKClient();
       if (!isJson) {
-        console.log(chalk22.yellow("Note: The providers module is not yet active. This is a placeholder for future external provider configuration."));
-        console.log("");
         output.info(`Testing provider ${id}...`);
       }
       const result = await client.testProvider(id);
@@ -7358,9 +7667,9 @@ ${chalk22.dim("Tests connectivity and lists available models for the provider.")
       } else {
         if (result.success) {
           output.success(`Provider test passed (${String(result.responseTimeMs)}ms)`);
-          console.log(chalk22.green(`Message: ${result.message}`));
+          console.log(chalk25.green(`Message: ${result.message}`));
           if (result.availableModels && result.availableModels.length > 0) {
-            console.log(chalk22.bold(`
+            console.log(chalk25.bold(`
 Available Models:`));
             result.availableModels.forEach((model) => {
               console.log(`  - ${model}`);
@@ -7369,7 +7678,7 @@ Available Models:`));
         } else {
           output.error(`Provider test failed: ${result.message}`);
           if (result.error) {
-            console.log(chalk22.red(`Error: ${result.error}`));
+            console.log(chalk25.red(`Error: ${result.error}`));
           }
         }
       }
@@ -7377,6 +7686,9 @@ Available Models:`));
       handleError(error, isJson);
     }
   });
+  registerAddCommand(providers);
+  registerUpdateCommand(providers);
+  registerDeleteCommand(providers);
   return providers;
 }
 
@@ -7384,7 +7696,7 @@ Available Models:`));
 init_config();
 import { Command as Command14 } from "commander";
 import inquirer3 from "inquirer";
-import chalk23 from "chalk";
+import chalk26 from "chalk";
 import { existsSync as existsSync11, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
 import { execSync as execSync3 } from "child_process";
 import { join as join6 } from "path";
@@ -7507,13 +7819,13 @@ function writeRcConfig(config, cwd = process.cwd()) {
 function createInitCommand() {
   const init = new Command14("init").description("Initialize MutagenT in your project").option("--non-interactive", "Skip interactive prompts (defaults to CLI-only mode)").addHelpText("after", `
 Examples:
-  ${chalk23.dim("$")} mutagent init                     # Interactive setup wizard
-  ${chalk23.dim("$")} mutagent init --non-interactive    # CLI-only mode (no prompts)
+  ${chalk26.dim("$")} mutagent init                     # Interactive setup wizard
+  ${chalk26.dim("$")} mutagent init --non-interactive    # CLI-only mode (no prompts)
 
 Modes:
-  ${chalk23.bold("Full scaffold")}     Install SDK + integration package, create config, setup tracing
-  ${chalk23.bold("CLI-only")}          Verify auth + create .mutagentrc.json with workspace/endpoint
-  ${chalk23.bold("Skip")}              Exit without changes
+  ${chalk26.bold("Full scaffold")}     Install SDK + integration package, create config, setup tracing
+  ${chalk26.bold("CLI-only")}          Verify auth + create .mutagentrc.json with workspace/endpoint
+  ${chalk26.bold("Skip")}              Exit without changes
     `).action(async (options) => {
     const isJson = getJsonFlag(init);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -7782,23 +8094,23 @@ Modes:
 
 // src/commands/explore.ts
 import { Command as Command15 } from "commander";
-import chalk24 from "chalk";
+import chalk27 from "chalk";
 import { resolve as resolve3 } from "path";
 init_errors();
 function createExploreCommand() {
   const explore = new Command15("explore").description("Scan codebase for prompts, datasets, and MutagenT markers").option("-p, --path <dir>", "Directory to scan", ".").option("--depth <n>", "Max directory depth", "10").option("--include <glob>", "Include file pattern", "**/*.{ts,js,py,tsx,jsx}").option("--exclude <dirs>", "Comma-separated directories to exclude", "node_modules,dist,.git,build,.next,__pycache__,venv,.venv").option("--markers-only", "Only find existing MutagenT markers").addHelpText("after", `
 Examples:
-  ${chalk24.dim("$")} mutagent explore
-  ${chalk24.dim("$")} mutagent explore --path ./src
-  ${chalk24.dim("$")} mutagent explore --include "**/*.{ts,py}" --depth 5
-  ${chalk24.dim("$")} mutagent explore --markers-only
-  ${chalk24.dim("$")} mutagent explore --json
+  ${chalk27.dim("$")} mutagent explore
+  ${chalk27.dim("$")} mutagent explore --path ./src
+  ${chalk27.dim("$")} mutagent explore --include "**/*.{ts,py}" --depth 5
+  ${chalk27.dim("$")} mutagent explore --markers-only
+  ${chalk27.dim("$")} mutagent explore --json
 
 Detection modes:
-  ${chalk24.dim("Heuristic")}  Template variables ({{var}}), prompt constants, schema definitions
-  ${chalk24.dim("Marker")}     MutagenT:START/END comment markers from previous uploads
+  ${chalk27.dim("Heuristic")}  Template variables ({{var}}), prompt constants, schema definitions
+  ${chalk27.dim("Marker")}     MutagenT:START/END comment markers from previous uploads
 
-${chalk24.dim("Results are saved to .mutagent/mutation-context.md for use by other commands.")}
+${chalk27.dim("Results are saved to .mutagent/mutation-context.md for use by other commands.")}
     `).action((options) => {
     const isJson = getJsonFlag(explore);
     const output = new OutputFormatter(isJson ? "json" : "table");
@@ -7816,7 +8128,7 @@ ${chalk24.dim("Results are saved to .mutagent/mutation-context.md for use by oth
         markersOnly
       };
       if (!isJson) {
-        console.log(chalk24.cyan(`
+        console.log(chalk27.cyan(`
 Scanning ${scanPath}...
 `));
       }
@@ -7845,41 +8157,41 @@ Scanning ${scanPath}...
         const totalFindings = result.prompts.length + result.datasets.length + result.markers.length;
         if (totalFindings === 0) {
           output.info("No prompts, datasets, or markers found.");
-          console.log(chalk24.dim(`
+          console.log(chalk27.dim(`
   Tip: Create a prompt with template variables like {{input}} to get started.`));
           return;
         }
         if (result.prompts.length > 0) {
-          console.log(chalk24.bold(`  Prompts Found (${String(result.prompts.length)}):`));
+          console.log(chalk27.bold(`  Prompts Found (${String(result.prompts.length)}):`));
           console.log();
           for (const p of result.prompts) {
-            const confidenceTag = p.confidence === "high" ? chalk24.green("[high]") : p.confidence === "medium" ? chalk24.yellow("[medium]") : chalk24.dim("[low]");
-            const reasonTag = chalk24.dim(`[${p.reason}]`);
-            console.log(`    ${confidenceTag} ${chalk24.green(p.file)}:${chalk24.yellow(String(p.line))} ${reasonTag}`);
-            console.log(`      ${chalk24.dim(p.preview)}`);
+            const confidenceTag = p.confidence === "high" ? chalk27.green("[high]") : p.confidence === "medium" ? chalk27.yellow("[medium]") : chalk27.dim("[low]");
+            const reasonTag = chalk27.dim(`[${p.reason}]`);
+            console.log(`    ${confidenceTag} ${chalk27.green(p.file)}:${chalk27.yellow(String(p.line))} ${reasonTag}`);
+            console.log(`      ${chalk27.dim(p.preview)}`);
           }
           console.log();
         }
         if (result.datasets.length > 0) {
-          console.log(chalk24.bold(`  Datasets Found (${String(result.datasets.length)}):`));
+          console.log(chalk27.bold(`  Datasets Found (${String(result.datasets.length)}):`));
           console.log();
           for (const d of result.datasets) {
-            console.log(`    ${chalk24.green(d.file)} ${chalk24.dim(`(${String(d.items)} items)`)}`);
+            console.log(`    ${chalk27.green(d.file)} ${chalk27.dim(`(${String(d.items)} items)`)}`);
           }
           console.log();
         }
         if (result.markers.length > 0) {
-          console.log(chalk24.bold(`  MutagenT Markers (${String(result.markers.length)}):`));
+          console.log(chalk27.bold(`  MutagenT Markers (${String(result.markers.length)}):`));
           console.log();
           for (const m of result.markers) {
-            const idPart = m.platformId ? chalk24.cyan(` id=${m.platformId}`) : "";
-            console.log(`    ${chalk24.green(m.file)}:${chalk24.yellow(String(m.line))} ${chalk24.magenta(m.type)}${idPart}`);
+            const idPart = m.platformId ? chalk27.cyan(` id=${m.platformId}`) : "";
+            console.log(`    ${chalk27.green(m.file)}:${chalk27.yellow(String(m.line))} ${chalk27.magenta(m.type)}${idPart}`);
           }
           console.log();
         }
-        console.log(chalk24.dim("  ─────────────────────────────────"));
-        console.log(`  ${chalk24.bold("Summary:")} ${String(result.prompts.length)} prompts, ${String(result.datasets.length)} datasets, ${String(result.markers.length)} markers`);
-        console.log(chalk24.dim(`  Saved to .mutagent/mutation-context.md`));
+        console.log(chalk27.dim("  ─────────────────────────────────"));
+        console.log(`  ${chalk27.bold("Summary:")} ${String(result.prompts.length)} prompts, ${String(result.datasets.length)} datasets, ${String(result.markers.length)} markers`);
+        console.log(chalk27.dim(`  Saved to .mutagent/mutation-context.md`));
         console.log();
       }
     } catch (error) {
@@ -7891,7 +8203,7 @@ Scanning ${scanPath}...
 
 // src/commands/skills.ts
 import { Command as Command16 } from "commander";
-import chalk25 from "chalk";
+import chalk28 from "chalk";
 import { existsSync as existsSync12, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "fs";
 import { join as join7 } from "path";
 import { execSync as execSync4 } from "child_process";
@@ -8015,7 +8327,7 @@ function createSkillsCommand() {
   const skills = new Command16("skills").description("Manage MutagenT CLI skills for coding agents");
   skills.command("install").description("Install MutagenT CLI skill for Claude Code").addHelpText("after", `
 Examples:
-  ${chalk25.dim("$")} mutagent skills install
+  ${chalk28.dim("$")} mutagent skills install
 
 This creates a Claude Code skill at .claude/skills/mutagent-cli/SKILL.md
 that teaches coding agents how to use the MutagenT CLI effectively.
@@ -8042,10 +8354,10 @@ ${SKILL_BODY}
       });
     } else {
       output.success(`Installed MutagenT CLI skill`);
-      console.log(`  ${chalk25.dim("Path:")} ${skillPath}`);
+      console.log(`  ${chalk28.dim("Path:")} ${skillPath}`);
       console.log("");
-      console.log(`  ${chalk25.dim("This skill teaches coding agents how to use the MutagenT CLI.")}`);
-      console.log(`  ${chalk25.dim("It will be automatically loaded by Claude Code when relevant triggers match.")}`);
+      console.log(`  ${chalk28.dim("This skill teaches coding agents how to use the MutagenT CLI.")}`);
+      console.log(`  ${chalk28.dim("It will be automatically loaded by Claude Code when relevant triggers match.")}`);
     }
   });
   return skills;
@@ -8054,7 +8366,7 @@ ${SKILL_BODY}
 // src/commands/usage.ts
 init_config();
 import { Command as Command17 } from "commander";
-import chalk26 from "chalk";
+import chalk29 from "chalk";
 init_errors();
 init_sdk_client();
 var TRIAL_OPTIMIZATION_LIMIT = 5;
@@ -8070,8 +8382,8 @@ function renderProgressBar(used, limit, width = 30) {
 function createUsageCommand() {
   const usage = new Command17("usage").description("Show resource counts and optimization run limits").addHelpText("after", `
 Examples:
-  ${chalk26.dim("$")} mutagent usage
-  ${chalk26.dim("$")} mutagent usage --json
+  ${chalk29.dim("$")} mutagent usage
+  ${chalk29.dim("$")} mutagent usage --json
     `);
   usage.action(async () => {
     const isJson = getJsonFlag(usage);
@@ -8126,21 +8438,21 @@ Examples:
         });
       } else {
         console.log("");
-        console.log(chalk26.bold("\uD83D\uDCCA MutagenT Usage"));
-        console.log(chalk26.dim("─".repeat(45)));
+        console.log(chalk29.bold("\uD83D\uDCCA MutagenT Usage"));
+        console.log(chalk29.dim("─".repeat(45)));
         console.log("");
-        console.log(chalk26.bold("Resources:"));
-        console.log(`  Prompts:       ${chalk26.cyan(String(promptCount))}`);
-        console.log(`  Datasets:      ${chalk26.cyan(String(datasetCount))}`);
-        console.log(`  Evaluations:   ${chalk26.cyan(String(evaluationCount))}`);
+        console.log(chalk29.bold("Resources:"));
+        console.log(`  Prompts:       ${chalk29.cyan(String(promptCount))}`);
+        console.log(`  Datasets:      ${chalk29.cyan(String(datasetCount))}`);
+        console.log(`  Evaluations:   ${chalk29.cyan(String(evaluationCount))}`);
         console.log("");
-        console.log(chalk26.bold(`Optimization Runs (${chalk26.yellow("trial")} plan):`));
-        console.log(`  Remaining:  ${chalk26.cyan(String(optimizationRemaining))} / ${String(optimizationLimit)}`);
+        console.log(chalk29.bold(`Optimization Runs (${chalk29.yellow("trial")} plan):`));
+        console.log(`  Remaining:  ${chalk29.cyan(String(optimizationRemaining))} / ${String(optimizationLimit)}`);
         console.log(`  ${renderProgressBar(optimizationUsed, optimizationLimit)}`);
         console.log("");
-        console.log(chalk26.yellow(`  ⚠ ${String(optimizationRemaining)} optimization runs remaining`));
-        console.log(chalk26.dim(`  ℹ Optimization run counts are approximate`));
-        console.log(`  Upgrade: ${chalk26.underline(BILLING_URL)}`);
+        console.log(chalk29.yellow(`  ⚠ ${String(optimizationRemaining)} optimization runs remaining`));
+        console.log(chalk29.dim(`  ℹ Optimization run counts are approximate`));
+        console.log(`  Upgrade: ${chalk29.underline(BILLING_URL)}`);
         console.log("");
       }
     } catch (error) {
@@ -8439,100 +8751,100 @@ program.name("mutagent").description(`MutagenT CLI - AI-native prompt optimizati
   showGlobalOptions: true
 });
 program.addHelpText("after", `
-${chalk27.yellow("Non-Interactive Mode (CI/CD & Coding Agents):")}
-  export MUTAGENT_API_KEY=mt_...  ${chalk27.dim("or")}  --api-key mt_...
-  --json ${chalk27.dim("for structured output")}    --non-interactive ${chalk27.dim("to disable prompts")}
-
-${chalk27.yellow("Command Navigation:")}
-  mutagent auth login --browser         ${chalk27.dim("Authenticate (OAuth)")}
-  mutagent auth status                  ${chalk27.dim("Check auth + workspace")}
-  mutagent init                         ${chalk27.dim("Initialize project (.mutagentrc.json)")}
-  mutagent explore                      ${chalk27.dim("Discover prompts in codebase")}
-  mutagent workspaces list --json       ${chalk27.dim("List workspaces (verify ID)")}
-  mutagent config set workspace <id>    ${chalk27.dim("Set active workspace")}
-  mutagent usage --json                 ${chalk27.dim("Check plan limits")}
-
-  mutagent prompts create --help        ${chalk27.dim("Upload prompt (read help first!)")}
-  mutagent prompts list --json          ${chalk27.dim("List prompts")}
-  mutagent prompts get <id> --json      ${chalk27.dim("Full prompt details + schemas")}
-
-  mutagent prompts dataset add --help   ${chalk27.dim("Upload dataset (read help first!)")}
-  mutagent prompts dataset list <id>    ${chalk27.dim("List datasets")}
-
-  mutagent prompts evaluation create --help           ${chalk27.dim("Create eval (read help first!)")}
-  mutagent prompts evaluation create <id> --guided --json   ${chalk27.dim("Guided eval workflow")}
-  mutagent prompts evaluation list <id> --json        ${chalk27.dim("List evaluations")}
-
-  mutagent prompts optimize start --help      ${chalk27.dim("Run optimization (read help first!)")}
-  mutagent prompts optimize status <job-id>   ${chalk27.dim("Poll progress")}
-  mutagent prompts optimize results <job-id>  ${chalk27.dim("View scorecard")}
-
-  mutagent integrate <framework>        ${chalk27.dim("Framework integration guide")}
-  mutagent hooks --help                 ${chalk27.dim("Hook setup for Claude Code telemetry")}
-  mutagent playground run <id> --input '{...}'  ${chalk27.dim("Quick test")}
-
-${chalk27.yellow("★ Workflow: Framework Integration (Tracing):")}
-  1. mutagent explore                                    ${chalk27.dim("← discover prompts/agents in codebase")}
-  2. mutagent integrate <framework>                      ${chalk27.dim("← get integration instructions")}
-  3. Apply tracing code to your codebase                 ${chalk27.dim("← follow the guide output")}
-  4. mutagent traces list --json                         ${chalk27.dim("← verify traces are arriving")}
-
-${chalk27.yellow("★ Workflow: Evaluate → Optimize:")}
-  1. mutagent prompts create --help               ${chalk27.dim("← read help")}
-  2. mutagent prompts create ... --json            ${chalk27.dim("← upload prompt with {variables} + inputSchema")}
-  3. mutagent prompts dataset add --help           ${chalk27.dim("← read help")}
-  4. mutagent prompts dataset add <id> ... --json  ${chalk27.dim("← upload dataset")}
-  5. mutagent prompts evaluation create <id> --guided --json  ${chalk27.dim("← guided eval")}
+${chalk30.yellow("Non-Interactive Mode (CI/CD & Coding Agents):")}
+  export MUTAGENT_API_KEY=mt_...  ${chalk30.dim("or")}  --api-key mt_...
+  --json ${chalk30.dim("for structured output")}    --non-interactive ${chalk30.dim("to disable prompts")}
+
+${chalk30.yellow("Command Navigation:")}
+  mutagent auth login --browser         ${chalk30.dim("Authenticate (OAuth)")}
+  mutagent auth status                  ${chalk30.dim("Check auth + workspace")}
+  mutagent init                         ${chalk30.dim("Initialize project (.mutagentrc.json)")}
+  mutagent explore                      ${chalk30.dim("Discover prompts in codebase")}
+  mutagent workspaces list --json       ${chalk30.dim("List workspaces (verify ID)")}
+  mutagent config set workspace <id>    ${chalk30.dim("Set active workspace")}
+  mutagent usage --json                 ${chalk30.dim("Check plan limits")}
+
+  mutagent prompts create --help        ${chalk30.dim("Upload prompt (read help first!)")}
+  mutagent prompts list --json          ${chalk30.dim("List prompts")}
+  mutagent prompts get <id> --json      ${chalk30.dim("Full prompt details + schemas")}
+
+  mutagent prompts dataset add --help   ${chalk30.dim("Upload dataset (read help first!)")}
+  mutagent prompts dataset list <id>    ${chalk30.dim("List datasets")}
+
+  mutagent prompts evaluation create --help           ${chalk30.dim("Create eval (read help first!)")}
+  mutagent prompts evaluation create <id> --guided --json   ${chalk30.dim("Guided eval workflow")}
+  mutagent prompts evaluation list <id> --json        ${chalk30.dim("List evaluations")}
+
+  mutagent prompts optimize start --help      ${chalk30.dim("Run optimization (read help first!)")}
+  mutagent prompts optimize status <job-id>   ${chalk30.dim("Poll progress")}
+  mutagent prompts optimize results <job-id>  ${chalk30.dim("View scorecard")}
+
+  mutagent integrate <framework>        ${chalk30.dim("Framework integration guide")}
+  mutagent hooks --help                 ${chalk30.dim("Hook setup for Claude Code telemetry")}
+  mutagent playground run <id> --input '{...}'  ${chalk30.dim("Quick test")}
+
+${chalk30.yellow("★ Workflow: Framework Integration (Tracing):")}
+  1. mutagent explore                                    ${chalk30.dim("← discover prompts/agents in codebase")}
+  2. mutagent integrate <framework>                      ${chalk30.dim("← get integration instructions")}
+  3. Apply tracing code to your codebase                 ${chalk30.dim("← follow the guide output")}
+  4. mutagent traces list --json                         ${chalk30.dim("← verify traces are arriving")}
+
+${chalk30.yellow("★ Workflow: Evaluate → Optimize:")}
+  1. mutagent prompts create --help               ${chalk30.dim("← read help")}
+  2. mutagent prompts create ... --json            ${chalk30.dim("← upload prompt with {variables} + inputSchema")}
+  3. mutagent prompts dataset add --help           ${chalk30.dim("← read help")}
+  4. mutagent prompts dataset add <id> ... --json  ${chalk30.dim("← upload dataset")}
+  5. mutagent prompts evaluation create <id> --guided --json  ${chalk30.dim("← guided eval")}
   6. mutagent prompts optimize start <id> --dataset <d> --evaluation <e> --json
 
-${chalk27.yellow("Post-Onboarding Decision Tree:")}
-  After ${chalk27.bold("mutagent auth login")}, users land in one of 3 paths:
-  ${chalk27.bold("Path A")} (Tracing):      explore → integrate <framework> → apply tracing → verify
-  ${chalk27.bold("Path B")} (Optimization): explore → prompts create → dataset add → eval create → optimize
-  ${chalk27.bold("Path C")} (Manual):       Use CLI commands directly — run mutagent <command> --help
+${chalk30.yellow("Post-Onboarding Decision Tree:")}
+  After ${chalk30.bold("mutagent auth login")}, users land in one of 3 paths:
+  ${chalk30.bold("Path A")} (Tracing):      explore → integrate <framework> → apply tracing → verify
+  ${chalk30.bold("Path B")} (Optimization): explore → prompts create → dataset add → eval create → optimize
+  ${chalk30.bold("Path C")} (Manual):       Use CLI commands directly — run mutagent <command> --help
 
-${chalk27.yellow("Directive System:")}
+${chalk30.yellow("Directive System:")}
   Every --json response may include:
-  ${chalk27.bold("_directive.renderedCard")}  Pre-formatted card for the user ${chalk27.red("(MUST be shown in chat)")}
-  ${chalk27.bold("_directive.instruction")}   Next step for the agent
-  ${chalk27.bold("_directive.next")}          Array of suggested follow-up commands
-  ${chalk27.bold("_links")}                   Dashboard/API URLs (format as markdown links)
+  ${chalk30.bold("_directive.renderedCard")}  Pre-formatted card for the user ${chalk30.red("(MUST be shown in chat)")}
+  ${chalk30.bold("_directive.instruction")}   Next step for the agent
+  ${chalk30.bold("_directive.next")}          Array of suggested follow-up commands
+  ${chalk30.bold("_links")}                   Dashboard/API URLs (format as markdown links)
 
-${chalk27.yellow("Evaluation Criteria Format:")}
-  Each criterion MUST have: ${chalk27.bold("name")}, ${chalk27.bold("description")} (scoring rubric), ${chalk27.bold("evaluationParameter")}
+${chalk30.yellow("Evaluation Criteria Format:")}
+  Each criterion MUST have: ${chalk30.bold("name")}, ${chalk30.bold("description")} (scoring rubric), ${chalk30.bold("evaluationParameter")}
   evaluationParameter MUST match an inputSchema or outputSchema field name
   No duplicate evaluationParameter values — each criterion targets a unique field
   ALL schema fields must be covered (missing fields = error)
-  Use ${chalk27.bold("--guided --json")} to generate criteria templates from prompt schemas
+  Use ${chalk30.bold("--guided --json")} to generate criteria templates from prompt schemas
 
-${chalk27.yellow("Optimization Cost Control:")}
-  Default max-iterations is 1. ${chalk27.red("NEVER increase without explicit user request.")}
+${chalk30.yellow("Optimization Cost Control:")}
+  Default max-iterations is 1. ${chalk30.red("NEVER increase without explicit user request.")}
   Each iteration incurs LLM costs — confirm with user before starting >1.
 
-${chalk27.yellow("Post-Optimization:")}
-  After ${chalk27.bold("optimize results")}: ALWAYS show the before/after diff to the user first.
-  Then offer choices: ${chalk27.bold("Apply")} / ${chalk27.bold("Reject")}.
+${chalk30.yellow("Post-Optimization:")}
+  After ${chalk30.bold("optimize results")}: ALWAYS show the before/after diff to the user first.
+  Then offer choices: ${chalk30.bold("Apply")} / ${chalk30.bold("Reject")}.
 
-${chalk27.yellow("State Tracking:")}
+${chalk30.yellow("State Tracking:")}
   .mutagent/mutation-context.md — Codebase index of discovered/uploaded prompts
   Update after explore, create, and dataset operations
   mutagent auth status — Auth + workspace state
   Comment markers (// MutagenT:START ... // MutagenT:END) in source files
 
-${chalk27.yellow("AI Agent Rules (MANDATORY for coding agents):")}
+${chalk30.yellow("AI Agent Rules (MANDATORY for coding agents):")}
   1. EVERY command MUST include --json (no exceptions)
   2. Run <command> --help BEFORE first use of any command
   3. Use --guided --json for evaluation creation (NEVER --guided alone)
   4. Parse _directive.renderedCard and copy it into your CHAT RESPONSE verbatim
-     ${chalk27.red("HARD STOP")}: do NOT run further commands until the card is rendered in chat
+     ${chalk30.red("HARD STOP")}: do NOT run further commands until the card is rendered in chat
   5. After mutagent init, verify workspace: mutagent workspaces list --json
   6. Use {single_braces} for template variables in prompts
   7. Collect evaluation criteria from the user — NEVER auto-generate
   8. ALL user interaction via AskUserQuestion — CLI is non-interactive
 ${!hasCredentials() ? `
-` + chalk27.yellow("  Warning: Not authenticated. Run: mutagent auth login --browser") + `
+` + chalk30.yellow("  Warning: Not authenticated. Run: mutagent auth login --browser") + `
 ` : ""}${!hasRcConfig() ? `
-` + chalk27.green("  Get started: mutagent init") + `
+` + chalk30.green("  Get started: mutagent init") + `
 ` : ""}`);
 program.hook("preAction", (thisCommand) => {
   const globalOpts = thisCommand.optsWithGlobals();
@@ -8563,5 +8875,5 @@ program.addCommand(createUsageCommand());
 program.addCommand(createHooksCommand());
 program.parse();
 
-//# debugId=DC3AE5F1F511B4AF64756E2164756E21
+//# debugId=4C609807D0CBF5B664756E2164756E21
 //# sourceMappingURL=cli.js.map