salesforce-metadata-mcp 2.5.0 → 2.5.2

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## [2.5.2] - 2026-05-29
+
+### Bug Fixes — 9 SOAP API Compatibility Corrections
+
+All fixes address HTTP 500 errors or incorrect metadata caused by element ordering or invalid elements in SOAP upsertMetadata calls against the Salesforce Metadata API v66.
+
+#### `sf_create_list_view`
+- **Fix:** Replaced invalid `<allUsers>` element with `<allInternalUsers/>` in the `SharedTo` type. The previous element caused HTTP 500 "Element allUsers invalid at this location."
+
+#### `sf_create_email_template`
+- **Fix:** Removed invalid `<htmlValue>` element from SOAP Metadata API v66; email templates now always use `type: text`. HTML content is preserved in `textOnly` field.
+
+#### `sf_create_page_layout`
+- **Fix:** The `Name` field in a layout section now gets `behavior: Required` instead of `behavior: Edit`. Salesforce enforces "Field:Name must be Required" for standard name fields.
+
+#### `sf_clone_profile`
+- **Fix:** Strips all `<tabVisibilities>` blocks from the cloned profile XML. Re-upserting profile tab settings for system-managed tabs (e.g., AINaturalLangProcessRslt) causes "You can't edit tab settings for..." errors.
+
+#### `sf_add_picklist_values`
+- **Fix:** Replaced Tooling API field lookup with `readMetadata` on the parent `CustomObject`. The Tooling API does not index fields created in the same session via the Metadata API, causing "Field not found" errors on freshly-created fields.
+
+#### `sf_create_lightning_record_page` (`createFlexiPage`)
+- **Fix:** Corrected element name from `<pageType>` to `<type>` (WSDL name). Added required `<template>` and `<flexiPageRegions>` elements. Corrected WSDL element ordering. Added support for `apiName` parameter alias.
+
+#### `sf_create_letterhead`
+- **Fix:** Rewrote XML structure to match WSDL sequence order (bottomLine → description → footer → header → middleLine → name → topLine). Fixed `LetterheadHeaderFooter` to use `<backgroundColor>` (not `<color>`, which is invalid in that type). Removed invalid `<fontFace>` and `<fontSize>` elements. Added required `<middleLine>` element. Removed invalid `<style>` element from `LetterheadLine`.
+
+#### `sf_update_dashboard`
+- **Fix:** When the target dashboard does not exist, creates it with all required fields: `backgroundEndColor`, `backgroundFadeDirection`, `backgroundStartColor`, `dashboardType`, `leftSection`, `rightSection`, `runningUser`, `textColor`, `title`, `titleColor`, `titleSize`.
+
+#### `sf_create_quick_action`
+- **Fix:** Corrected WSDL element ordering (alphabetical). Added `<quickActionLayout>` support when `fields` parameter is provided. Fields named `Subject`, `Name`, or `LastName` automatically receive `uiBehavior: Required`.
+
+### Test Coverage
+- **Before:** 65/83 (78%) → **After:** 76/83 (92%) — 11 additional tool passes
+- All failures remaining are org-level limitations: empty-flow activation, OmniStudio (package not installed), Experience Cloud (feature not enabled), FlowInterview debug logging disabled
+
+---
+
+## [2.5.1] - 2026-05-28
+
+### Documentation
+- Rewrote `TOOLS.md` as a comprehensive reference covering all 200+ tools (was 193 lines covering ~8 tools; now 2,100+ lines covering all 207 tools with parameters and example prompts)
+
+---
+
 ## [2.5.0] - 2026-05-28
 
 ### New Tools — 45 Additions Across 11 Categories

package/README.md

@@ -1,6 +1,6 @@
 # salesforce-metadata-mcp
 
-[![Version](https://img.shields.io/badge/version-2.5.0-blue.svg)](https://npmjs.com/package/salesforce-metadata-mcp)
+[![Version](https://img.shields.io/badge/version-2.5.2-blue.svg)](https://npmjs.com/package/salesforce-metadata-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)
 
@@ -46,6 +46,20 @@ See [SETUP.md](SETUP.md) for all authentication methods and detailed setup instr
 
 ---
 
+## What's New in v2.5.2
+
+Bug-fix release: 9 SOAP API compatibility corrections that resolve HTTP 500 errors and incorrect metadata against Salesforce Metadata API v66. Test coverage improved from 78% → 92% (76/83 tools passing).
+
+- **`sf_create_list_view`** — Fixed `<allUsers>` → `<allInternalUsers/>` in SharedTo type
+- **`sf_create_email_template`** — Removed invalid `<htmlValue>` element (API v66 incompatible)
+- **`sf_create_page_layout`** — Name field now correctly gets `behavior: Required`
+- **`sf_clone_profile`** — Strips `<tabVisibilities>` for system-managed tabs before re-upsert
+- **`sf_add_picklist_values`** — Switched from Tooling API to `readMetadata` for reliable field lookup
+- **`sf_create_lightning_record_page`** — Fixed element name (`type` not `pageType`), added required `template` and `flexiPageRegions`
+- **`sf_create_letterhead`** — Full WSDL-compliant rewrite: correct element order, `backgroundColor` in header/footer, added `middleLine`
+- **`sf_update_dashboard`** — Creates dashboard when not found, with all required fields including `leftSection`/`rightSection`
+- **`sf_create_quick_action`** — Correct WSDL element order, added `quickActionLayout` support
+
 ## What's New in v2.5.0
 
 45 new tools across 11 categories: