mcp-prompt-optimizer 3.3.0 → 3.4.0

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.4.0] - 2026-05-26
+
+### Added
+- `explore_sop_approaches` tool: generates 3 parallel SOP variants (process-oriented, decision-tree, role-based) for comparison. Optionally accepts `blend_description` to blend variants directly into a single SOP. Innovator tier required.
+
 ## [3.1.3] - 2026-04-13
 
 ### Changed

package/index.js

@@ -65,9 +65,17 @@ const ENDPOINTS = {
     TRANSFORM:               '/api/v1/context-engineer/transform',
     QUOTA:                   '/api/v1/context-engineer/quota',
     HARNESS_BUNDLE:          '/api/v1/context-engineer/harness-bundle',
+    SOP_EXPLORE:             '/api/v1/context-engineer/sop-explore',
+    SOP_BLEND:               '/api/v1/context-engineer/sop-blend',
   },
 };
 
+const DEPLOY_TARGET_ENUM = [
+  "claude_code", "claude_desktop", "cursor", "copilot",
+  "windsurf", "cline", "zed", "replit", "openai_agents", "ollama",
+  "amazon_q", "aider", "continue_dev", "crewai"
+];
+
 class MCPPromptOptimizer {
   constructor() {
     this.server = new Server(
@@ -392,9 +400,27 @@ class MCPPromptOptimizer {
                 description: "The workflow goal the harness is built for."
               },
               deploy_target: {
-                type: "string",
-                enum: ["claude_code", "claude_desktop", "cursor", "copilot", "windsurf", "cline", "zed", "replit", "openai_agents", "ollama"],
-                description: "Target deployment platform. Default: claude_code."
+                oneOf: [
+                  {
+                    type: "string",
+                    enum: DEPLOY_TARGET_ENUM,
+                    description: "Single deploy target."
+                  },
+                  {
+                    type: "array",
+                    minItems: 1,
+                    items: {
+                      type: "string",
+                      enum: DEPLOY_TARGET_ENUM
+                    },
+                    description: "Multiple deploy targets simultaneously (Creator+ required)."
+                  }
+                ],
+                description: (
+                  "Target deployment platform(s). Single string (Explorer+) or array (Creator+). "
+                  + "amazon_q, aider, continue_dev, crewai require Creator+. "
+                  + "Default: claude_code."
+                )
               },
               session_id: {
                 type: "string",
@@ -408,6 +434,37 @@ class MCPPromptOptimizer {
             required: ["goal"]
           }
         },
+        {
+          name: "explore_sop_approaches",
+          description: (
+            "Generate 3 parallel SOP variants (process-oriented, decision-tree, role-based) for comparison before committing. " +
+            "Returns exploration_html (self-contained comparison grid), variants array, and a recommended variant. " +
+            "Innovator tier required. " +
+            "Optionally provide blend_description to skip comparison and receive a single blended SOP instead."
+          ),
+          inputSchema: {
+            type: "object",
+            properties: {
+              goal: {
+                type: "string",
+                description: "The workflow goal to generate SOP variants for"
+              },
+              context: {
+                type: "string",
+                description: "Optional background context or documentation excerpt"
+              },
+              blend_description: {
+                type: "string",
+                description: "Optional: if provided, skips variant comparison and blends all 3 into one SOP using this description"
+              },
+              perspective: { type: "string", description: "Agent role or viewpoint (IntentFrame)" },
+              out_of_scope: { type: "string", description: "What is explicitly excluded (IntentFrame)" },
+              success_definition: { type: "string", description: "Measurable success criteria (IntentFrame)" },
+            },
+            required: ["goal"],
+            additionalProperties: false
+          }
+        },
       ];
 
       // Add advanced tools if Bayesian optimization is enabled
@@ -466,6 +523,7 @@ class MCPPromptOptimizer {
           case "transform_for_framework": return await this.handleTransformForFramework(args);
           case "get_ce_quota_status": return await this.handleGetCEQuotaStatus();
           case "generate_harness_bundle": return await this.handleGenerateHarnessBundle(args);
+          case "explore_sop_approaches": return await this.handleExploreSopApproaches(args);
           default: throw new Error(`Unknown tool: ${name}`);
         }
       } catch (error) {
@@ -1175,11 +1233,24 @@ class MCPPromptOptimizer {
     if (!args.sop_content && !args.session_id) {
       return { content: [{ type: "text", text: "Error: provide either sop_content or session_id." }] };
     }
-    const deployTarget = args.deploy_target || "claude_code";
+    // Normalize deploy_target: string → [string], array → array, undefined → ["claude_code"]
+    let deployTargets;
+    if (!args.deploy_target) {
+      deployTargets = ["claude_code"];
+    } else if (Array.isArray(args.deploy_target)) {
+      deployTargets = args.deploy_target;
+    } else {
+      deployTargets = [args.deploy_target];
+    }
+    // Guard: empty array falls back to default
+    if (deployTargets.length === 0) {
+      deployTargets = ["claude_code"];
+    }
+
     const payload = {
       goal: args.goal,
-      deploy_target: deployTarget,
-      platform: deployTarget,
+      deploy_target: deployTargets.length === 1 ? deployTargets[0] : deployTargets,
+      platform: deployTargets[0],
       user_goal: args.goal,
       sop_content: args.sop_content || "",
     };
@@ -1201,18 +1272,89 @@ class MCPPromptOptimizer {
       return {
         content: [{
           type: "text",
-          text: `# Harness Bundle Requested\n\nDeploy target: **${deployTarget}**\nGoal: ${args.goal}\n\nDownload from the CE dashboard or via the /harness-bundle API endpoint.`
+          text: `# Harness Bundle Requested\n\nDeploy target: **${deployTargets.join(", ")}**\nGoal: ${args.goal}\n\nDownload from the CE dashboard or via the /harness-bundle API endpoint.`
         }]
       };
     } catch (error) {
       const msg = error?.message || String(error);
       if (msg.includes("TIER_LIMIT_REACHED")) {
-        return { content: [{ type: "text", text: `Upgrade required: Deploy target requires Explorer tier. Upgrade at /pricing.` }] };
+        const CREATOR_ONLY = ["amazon_q", "aider", "continue_dev", "crewai"];
+        const needsCreator =
+          msg.includes("creator") ||
+          deployTargets.length > 1 ||
+          CREATOR_ONLY.some(t => deployTargets.includes(t));
+        const tierNeeded = needsCreator ? "Creator" : "Explorer";
+        return { content: [{ type: "text",
+          text: `Upgrade required: this deploy target requires ${tierNeeded} tier or higher. Upgrade at /pricing.`
+        }] };
       }
       throw error;
     }
   }
 
+  async handleExploreSopApproaches(args) {
+    if (!args.goal) {
+      return { content: [{ type: "text", text: "Error: goal is required." }] };
+    }
+
+    // If blend_description provided, explore then blend in one call chain
+    if (args.blend_description) {
+      try {
+        const explorePayload = {
+          goal: args.goal,
+          context: args.context || undefined,
+          perspective: args.perspective || undefined,
+          out_of_scope: args.out_of_scope || undefined,
+          success_definition: args.success_definition || undefined,
+        };
+        const exploreResult = await this.callBackendAPI(ENDPOINTS.CE.SOP_EXPLORE, explorePayload);
+        const blendPayload = {
+          variants: exploreResult.variants,
+          blend_description: args.blend_description,
+          goal: args.goal,
+        };
+        const blendResult = await this.callBackendAPI(ENDPOINTS.CE.SOP_BLEND, blendPayload);
+        return {
+          content: [{
+            type: "text",
+            text: `# Blended SOP\n\n${blendResult.sop_content}`
+          }]
+        };
+      } catch (error) {
+        throw new Error(`Failed to blend SOP approaches: ${error.message}`);
+      }
+    }
+
+    // Standard exploration: return 3 variant summaries
+    try {
+      const payload = {
+        goal: args.goal,
+        context: args.context || undefined,
+        perspective: args.perspective || undefined,
+        out_of_scope: args.out_of_scope || undefined,
+        success_definition: args.success_definition || undefined,
+      };
+      const result = await this.callBackendAPI(ENDPOINTS.CE.SOP_EXPLORE, payload);
+
+      const variantSummaries = result.variants.map(v => {
+        const rec = v.id === result.recommended ? " *(Recommended)*" : "";
+        return `## Variant ${v.id} — ${v.approach.replace('_', '-')}${rec}\n\n${v.content.slice(0, 600)}${v.content.length > 600 ? '\n\n...(truncated)' : ''}`;
+      }).join('\n\n---\n\n');
+
+      return {
+        content: [{
+          type: "text",
+          text: `# SOP Exploration Results\n\n**Goal:** ${args.goal}\n**Recommended:** Variant ${result.recommended}\n\n---\n\n${variantSummaries}\n\n---\n\n*To select a variant, call generate_skill_package with the full content of your chosen variant as sop_content. To blend variants, re-call explore_sop_approaches with blend_description.*`
+        }]
+      };
+    } catch (error) {
+      if (error.message && error.message.includes('403')) {
+        return { content: [{ type: "text", text: "Error: SOP exploration requires Innovator tier. Upgrade at /pricing." }] };
+      }
+      throw new Error(`Failed to explore SOP approaches: ${error.message}`);
+    }
+  }
+
   _formatSkillPackage(result) {
     const sections = ['# Skill Package Generated'];
     const artifacts = result.artifacts || result.steps || {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-prompt-optimizer",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Professional cloud-based MCP server for AI-powered prompt optimization with intelligent context detection, Bayesian optimization, AG-UI real-time optimization, template auto-save, optimization insights, personal model configuration via WebUI, team collaboration, enterprise-grade features, production resilience, and startup validation. Universal compatibility with Claude Desktop, Cursor, Windsurf, and 17+ MCP clients.",
   "main": "index.js",
   "bin": {