mcp-prompt-optimizer 3.8.1 → 3.8.2

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.8.2] - 2026-08-27
+
+### Added
+- **Surface CE structural warnings in tool output.** The backend `/context-engineer/transform`
+  and `/context-engineer/generate-skill-package` responses now carry a non-fatal `warnings`
+  array (dropped SOP stages, duplicated tables, fabricated headings). `transform_for_framework`
+  and `generate_skill_package` previously discarded it, so a structurally degraded artifact
+  shipped silently. Both now render a `## ⚠️ Structural Warnings` section when the array is
+  non-empty. No change when it is empty (the normal case) — output is byte-identical.
+
 ## [3.8.1] - 2026-07-29
 
 ### Fixed

package/index.js

@@ -1289,7 +1289,7 @@ class MCPPromptOptimizer {
         sop_content: args.sop_content, goal: args.goal, framework: args.framework
       });
       const code = result.code || result.content || result.result || JSON.stringify(result, null, 2);
-      return { content: [{ type: "text", text: `# ${args.framework} Implementation\n\n\`\`\`python\n${code}\n\`\`\`\n\n---\n*Transformed by MCP Prompt Optimizer CE*` }] };
+      return { content: [{ type: "text", text: `# ${args.framework} Implementation\n\n\`\`\`python\n${code}\n\`\`\`${this._formatWarnings(result)}\n\n---\n*Transformed by MCP Prompt Optimizer CE*` }] };
     } catch (error) {
       throw new Error(`Failed to transform: ${error.message}`);
     }
@@ -1566,10 +1566,23 @@ class MCPPromptOptimizer {
     } else {
       sections.push('\n```json\n' + JSON.stringify(result, null, 2) + '\n```');
     }
+    const warn = this._formatWarnings(result);
+    if (warn) sections.push(warn);
     sections.push('\n---\n*Generated by MCP Prompt Optimizer CE*');
     return sections.join('\n');
   }
 
+  // Backend CE responses carry a non-fatal `warnings` array (dropped SOP
+  // stages, duplicated tables, fabricated headings). Surface it so a degraded
+  // artifact travels with the reason instead of shipping silently. Returns ''
+  // when there is nothing to report.
+  _formatWarnings(result) {
+    const w = result && (result.warnings || result.validation_warnings);
+    if (!Array.isArray(w) || w.length === 0) return '';
+    return `\n\n## ⚠️ Structural Warnings\n\n${w.map(x => `- ${x}`).join('\n')}\n\n` +
+      `_The artifact is delivered as-is; review these before use._`;
+  }
+
   _buildUrl(path) {
     return `${this.backendUrl}${path}`;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-prompt-optimizer",
-  "version": "3.8.1",
+  "version": "3.8.2",
   "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": {
@@ -26,6 +26,7 @@
     "test:simple": "node tests/simple-test.js",
     "test:contract": "node tests/contract-check.js",
     "test:e2e": "node tests/e2e-stdio-smoke.js",
+    "test:prod-canary": "node tests/prod-canary.js",
     "pretest": "npm run health-check",
     "prepublishOnly": "npm run test:quick",
     "version": "echo 'Updating version...' && npm run test:quick"