sf-message-catalog

Salesforce Managed Package — Message Catalog Generator

Generate a complete, customer-facing catalog of every user-facing message in a Salesforce managed package. The output is a professional landscape .docx with color-coded severity, organized by component type.

Before You Begin

1. Read the docx skill — locate and read the docx SKILL.md in your available skills. You will generate a .docx using docx-js.
2. Identify the Salesforce org connector. Ask the user which connected Salesforce org to query. Look for available MCP tools matching patterns like mcp__salesforce-*__tooling_execute or mcp__Salesforce-*__tooling_execute. If multiple orgs are connected, ask the user to pick one. If only one is available, confirm it.
3. Identify the managed package namespace prefix. Ask the user for the namespace (e.g., kugo2p). This is used to filter Tooling API queries to only components belonging to that package.

Phase 1: Extract Messages from All Component Types

Query the Salesforce Tooling API for source code across five component types. For each, extract every user-facing message string along with its method/context, triggering condition, and severity.

1.1 Apex Classes and Triggers

Query all Apex classes and triggers in the namespace:

SELECT Id, Name, Body FROM ApexClass WHERE NamespacePrefix = '{namespace}'
SELECT Id, Name, Body FROM ApexTrigger WHERE NamespacePrefix = '{namespace}'

Search each body for these patterns (in priority order):

Pattern	Severity
.addError('...')	ERROR
ApexPages.addMessage(...) with ApexPages.Severity.ERROR	ERROR
ApexPages.addMessage(...) with ApexPages.Severity.WARNING	WARNING
ApexPages.addMessage(...) with ApexPages.Severity.INFO	INFO
ApexPages.addMessage(...) with ApexPages.Severity.CONFIRM	CONFIRM
throw new ...Exception('...')	ERROR
String variables assigned then passed to addError or addMessage	Varies

For each message found, record:

• Method: The Apex method name where the message lives
• Message: The exact string literal (preserve {merge fields})
• Condition: The if / guard clause that triggers it (summarize in plain English)
• Severity: ERROR, WARNING, INFO, or CONFIRM