@salesforce/afv-skills 1.29.0 → 1.31.0

package/skills/experience-ui-bundle-metadata-generate/references/csp-metadata-format.md

@@ -2,7 +2,7 @@
 
 ## File location
 
-```
+```text
 force-app/main/default/cspTrustedSites/{Name}.cspTrustedSite-meta.xml
 ```
 
@@ -256,7 +256,7 @@ Some services split resources across multiple subdomains. Create one CSP Trusted
 
 If the browser console shows a CSP error like:
 
-```
+```text
 Refused to load the image 'https://example.com/image.png' because it violates
 the following Content Security Policy directive: "img-src 'self' ..."
 ```

package/skills/experience-ui-bundle-metadata-generate/scripts/check-api-version.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Checks that sourceApiVersion in sfdx-project.json is 67.0 or higher.
+# If lower, updates it to "67.0".
+
+set -e
+
+PROJECT_FILE="sfdx-project.json"
+
+if [[ ! -f "$PROJECT_FILE" ]]; then
+  echo "ERROR: $PROJECT_FILE not found in current directory"
+  exit 1
+fi
+
+# Extract sourceApiVersion and check if it's below 67.0
+version=$(jq -r '.sourceApiVersion // "0"' "$PROJECT_FILE")
+is_below=$(jq --arg v "$version" -n '($v | split(".") | .[0] | tonumber) < 67')
+
+if [[ "$is_below" == "true" ]]; then
+  echo "WARNING: sourceApiVersion is $version (< 67.0)"
+  echo "Updating $PROJECT_FILE to set sourceApiVersion to \"67.0\""
+
+  # Update the file
+  jq '.sourceApiVersion = "67.0"' "$PROJECT_FILE" > "$PROJECT_FILE.tmp"
+  mv "$PROJECT_FILE.tmp" "$PROJECT_FILE"
+
+  echo "OK: Updated sourceApiVersion to 67.0"
+  exit 0
+fi
+
+echo "OK: sourceApiVersion is $version (>= 67.0)"

package/skills/external-diagram-mermaid-generate/README.md

@@ -19,7 +19,7 @@
 
 ## Quick Start
 
-```
+```text
 # Generate an OAuth diagram
 "Create a JWT Bearer OAuth flow diagram"
 
@@ -85,7 +85,7 @@ sequenceDiagram
 ```
 
 ### ASCII Fallback
-```
+```text
 ┌───────────────┐     ┌───────────────┐
 │    Server     │     │   Salesforce  │
 └───────┬───────┘     └───────┬───────┘

package/skills/external-diagram-mermaid-generate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: external-diagram-mermaid-generate
-description: "Salesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says \"diagram\", \"visualize\", \"ERD\", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user wants PNG/SVG image output (use external-diagram-visual-generate), or asks about non-Salesforce systems."
+description: "Salesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says \"diagram\", \"visualize\", \"ERD\", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user asks about non-Salesforce systems."
 compatibility: "Requires Mermaid-capable renderer for diagram previews"
 metadata:
   version: "1.0"
@@ -20,7 +20,6 @@ Use `external-diagram-mermaid-generate` when the user wants:
 - diagrams that can live directly in docs, READMEs, or issues
 
 ### Out of Scope — Delegate elsewhere when the user wants:
-- rendered PNG/SVG images or polished mockups → [external-diagram-visual-generate](../external-diagram-visual-generate/SKILL.md)
 - non-Salesforce systems only → use a more general diagramming skill
 - object discovery before an ERD → [platform-custom-object-generate](../platform-custom-object-generate/SKILL.md) or [platform-custom-field-generate](../platform-custom-field-generate/SKILL.md)
 
@@ -125,7 +124,6 @@ Call out the key relationships, flow direction, and any assumptions.
 | Need | Delegate to | Reason |
 |---|---|---|
 | real object / field definitions | [platform-custom-object-generate](../platform-custom-object-generate/SKILL.md) / [platform-custom-field-generate](../platform-custom-field-generate/SKILL.md) | grounded ERD generation |
-| rendered diagram / image output | [external-diagram-visual-generate](../external-diagram-visual-generate/SKILL.md) | visual polish beyond Mermaid |
 | connected-app auth setup context | [integration-connectivity-connected-app-configure](../integration-connectivity-connected-app-configure/SKILL.md) | accurate OAuth flows |
 | Agentforce logic visualization | [agentforce-generate](../agentforce-generate/SKILL.md) | source-of-truth behavior details |
 | Flow behavior diagrams | [automation-flow-generate](../automation-flow-generate/SKILL.md) | actual Flow logic grounding |

package/skills/external-diagram-mermaid-generate/assets/agentforce/agent-flow.md

@@ -202,7 +202,7 @@ flowchart TD
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │                        🤖 SERVICE AGENT STRUCTURE                           │
 └─────────────────────────────────────────────────────────────────────────────┘
@@ -283,17 +283,17 @@ flowchart TD
 ## Conversation Flow Patterns
 
 ### 1. Linear Flow
-```
+```text
 Start → Topic → Action → Response → End
 ```
 
 ### 2. Branching Flow
-```
+```text
 Start → Classify → [Topic A | Topic B | Escalate]
 ```
 
 ### 3. Loop Back
-```
+```text
 Start → Topic → Action → Validate → [Success | Retry]
 ```
 

package/skills/external-diagram-mermaid-generate/assets/architecture/system-landscape.md

@@ -268,7 +268,7 @@ flowchart TB
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │                              SYSTEM LANDSCAPE                               │
 └─────────────────────────────────────────────────────────────────────────────┘

package/skills/external-diagram-mermaid-generate/assets/datamodel/b2b-commerce-erd.md

@@ -107,7 +107,7 @@ flowchart LR
 ## Key Concepts
 
 ### B2B Commerce Flow
-```
+```text
 WebStore → ProductCatalog → Product2
     ↓           ↓
 BuyerAccount → WebCart → CartItem → Order
@@ -123,7 +123,7 @@ BuyerGroup → Entitlements (What they can see/buy)
 | BuyerGroup | Pricing/entitlement grouping |
 
 ### Entitlement Model
-```
+```text
 CommerceEntitlementPolicy
     ├── CommerceEntitlementProduct (What products)
     └── CommerceEntitlementBuyerGroup (Who can see)
@@ -223,7 +223,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  B2B COMMERCE DATA MODEL (L→R)                                               │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/campaigns-erd.md

@@ -130,7 +130,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  CAMPAIGNS DATA MODEL (L→R)                                                  │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/consent-erd.md

@@ -114,7 +114,7 @@ flowchart LR
 Each contact point links to an Individual.
 
 ### Consent Model
-```
+```text
 DataUsePurpose  →  ContactPointConsent  ←  ContactPoint
 (e.g., Marketing)        (Opt-In/Out)        (Email/Phone)
 ```
@@ -179,7 +179,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  CONSENT DATA MODEL (GDPR/PRIVACY) (L→R)                                     │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/files-erd.md

@@ -86,7 +86,7 @@ flowchart LR
 ## Key Concepts
 
 ### Content Architecture
-```
+```text
 ContentDocument (Container)
     ├── ContentVersion (Current + History)
     ├── ContentDocumentLink (Sharing to Records)
@@ -177,7 +177,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  SALESFORCE FILES DATA MODEL (L→R)                                           │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/forecasting-erd.md

@@ -114,7 +114,7 @@ flowchart LR
 | Omitted | Excluded from forecast |
 
 ### Forecast Rollup Hierarchy
-```
+```text
 CEO
  └── VP Sales
       ├── Regional Manager 1
@@ -182,7 +182,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  COLLABORATIVE FORECASTS DATA MODEL (L→R)                                    │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/fsl-erd.md

@@ -127,7 +127,7 @@ flowchart LR
 ## Key Concepts
 
 ### FSL Object Hierarchy
-```
+```text
 Case/Asset → WorkOrder → WorkOrderLineItem → ServiceAppointment
                    ↓              ↓                    ↓
               ProductRequired  ProductConsumed   AssignedResource
@@ -245,7 +245,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  FIELD SERVICE LIGHTNING DATA MODEL (L→R)                                    │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/party-model-erd.md

@@ -157,7 +157,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  PARTY MODEL (INDUSTRY CLOUD) DATA MODEL (L→R)                              │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/quote-order-erd.md

@@ -102,7 +102,7 @@ flowchart LR
 ## Key Concepts
 
 ### Quote-to-Cash Flow
-```
+```text
 Opportunity → Quote → Order → Invoice → Payment
       ↓          ↓        ↓
     OLI        QLI   OrderItem
@@ -121,7 +121,7 @@ Opportunity → Quote → Order → Invoice → Payment
 | Reduction Orders | Negative quantity adjustments |
 
 ### Pricebook Structure
-```
+```text
 Pricebook2 (Standard + Custom)
     ↓
 PricebookEntry (Product + Price per Pricebook)
@@ -176,7 +176,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  QUOTE & ORDER DATA MODEL (L→R)                                              │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/revenue-cloud-erd.md

@@ -109,7 +109,7 @@ flowchart LR
 | **Dynamic Revenue Orchestration** | Guided selling |
 
 ### Product Hierarchy
-```
+```text
 ProductCatalog
     └── ProductCategory (Hierarchy)
             └── Product2
@@ -244,7 +244,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  REVENUE CLOUD DATA MODEL (L→R)                                              │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/sales-cloud-erd.md

@@ -116,7 +116,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  SALES CLOUD DATA MODEL (L→R)                                               │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>), -.-> = converts       │

package/skills/external-diagram-mermaid-generate/assets/datamodel/salesforce-erd.md

@@ -94,7 +94,7 @@ flowchart LR
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  DATA MODEL (L→R)                                                           │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/scheduler-erd.md

@@ -112,7 +112,7 @@ flowchart LR
 ## Key Concepts
 
 ### Scheduling Flow
-```
+```text
 Customer (Contact) → WorkType → ServiceAppointment ← ServiceResource
                                         ↓
                                ServiceTerritory
@@ -184,7 +184,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  SALESFORCE SCHEDULER DATA MODEL (L→R)                                       │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/datamodel/service-cloud-erd.md

@@ -120,7 +120,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  SERVICE CLOUD DATA MODEL (L→R)                                             │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │
@@ -173,14 +173,14 @@ flowchart LR
 ## Service Cloud Patterns
 
 ### Case Flow
-```
+```text
 Customer → Contact → Case → CaseComment
               ↓
          Entitlement (SLA)
 ```
 
 ### Entitlement Coverage
-```
+```text
 Account → ServiceContract → Entitlement → Case
     └─────────────────────────────────────┘
                   (direct)

package/skills/external-diagram-mermaid-generate/assets/datamodel/territory-management-erd.md

@@ -162,7 +162,7 @@ flowchart LR
 
 ## ASCII Fallback
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  ENTERPRISE TERRITORY MANAGEMENT DATA MODEL (L→R)                           │
 │  Legend: LK = Lookup (-->), MD = Master-Detail (==>)                        │

package/skills/external-diagram-mermaid-generate/assets/integration/api-sequence.md

@@ -217,7 +217,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template - Outbound Integration
 
-```
+```text
 ┌───────────────┐  ┌───────────────┐  ┌───────────────┐  ┌───────────────┐
 │    Trigger    │  │   Queueable   │  │     Named     │  │   External    │
 │               │  │               │  │   Credential  │  │     API       │

package/skills/external-diagram-mermaid-generate/assets/oauth/authorization-code-pkce.md

@@ -80,7 +80,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌──────────┐     ┌───────────────┐     ┌────────────────────┐
 │  User    │     │  Mobile App   │     │     Salesforce     │
 │          │     │   or SPA      │     │   (Auth Server)    │

package/skills/external-diagram-mermaid-generate/assets/oauth/authorization-code.md

@@ -83,7 +83,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌──────────┐     ┌───────────────┐     ┌────────────────────┐
 │  User/   │     │  Application  │     │     Salesforce     │
 │  Browser │     │    Server     │     │  (Auth Server)     │

package/skills/external-diagram-mermaid-generate/assets/oauth/client-credentials.md

@@ -71,7 +71,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌───────────────────────┐     ┌────────────────────┐
 │    Service/Backend    │     │     Salesforce     │
 │   (client_id/secret)  │     │   (Auth Server)    │

package/skills/external-diagram-mermaid-generate/assets/oauth/device-authorization.md

@@ -94,7 +94,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌──────────┐  ┌───────────┐  ┌────────────┐  ┌────────────────┐
 │  User    │  │  Browser  │  │   Device   │  │   Salesforce   │
 │          │  │(phone/PC) │  │ (CLI/TV)   │  │  (Auth Server) │
@@ -166,7 +166,7 @@ curl -X POST https://login.salesforce.com/services/oauth2/device/code \
 
 ## Step 2: Display to User
 
-```
+```text
 ═══════════════════════════════════════════════════════════════
   To authorize this device, please:
 

package/skills/external-diagram-mermaid-generate/assets/oauth/jwt-bearer.md

@@ -82,7 +82,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌───────────────────────┐     ┌────────────────────┐
 │     Server/CI/CD      │     │     Salesforce     │
 │    (Private Key)      │     │   (Certificate)    │
@@ -145,7 +145,7 @@ sequenceDiagram
 ```
 
 ### Signature
-```
+```text
 RS256(
   base64URLEncode(header) + "." + base64URLEncode(payload),
   privateKey

package/skills/external-diagram-mermaid-generate/assets/oauth/refresh-token.md

@@ -66,7 +66,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌───────────────────────┐     ┌────────────────────┐
 │     Application       │     │     Salesforce     │
 │   (stored tokens)     │     │   (Auth Server)    │

package/skills/external-diagram-mermaid-generate/assets/oauth/user-agent-social-sign-on.md

@@ -115,7 +115,7 @@ sequenceDiagram
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌────────────────┐     ┌────────────────────┐     ┌─────────────────────┐
 │     Client     │     │    Salesforce      │     │   OIDC Provider     │
 │  (Mobile App)  │     │ (Auth/RP Server)   │     │  (Google/Facebook)  │
@@ -221,7 +221,7 @@ sequenceDiagram
 
 ### Auth. Provider Setup
 
-```
+```text
 Setup → Auth. Providers → New
 ├── Provider Type: OpenID Connect (or specific: Google, Facebook)
 ├── Consumer Key: [From OP Developer Console]

package/skills/external-diagram-mermaid-generate/assets/role-hierarchy/user-hierarchy.md

@@ -211,7 +211,7 @@ flowchart TB
 
 ## ASCII Fallback Template
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │                           ROLE HIERARCHY                                    │
 └─────────────────────────────────────────────────────────────────────────────┘

package/skills/external-diagram-mermaid-generate/references/color-palette.md

@@ -5,7 +5,7 @@ Soft pastel color palette (Tailwind 200-level) with dark borders for clear defin
 
 ## Primary Palette (Tailwind 200 + Dark Borders)
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  COMPONENT                │  FILL (200)  │  STROKE (700+) │  TEXT COLOR    │
 ├───────────────────────────┼──────────────┼────────────────┼────────────────┤
@@ -24,7 +24,7 @@ Soft pastel color palette (Tailwind 200-level) with dark borders for clear defin
 
 ## Subgraph Background Colors (Tailwind 50-level)
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  SUBGRAPH                 │  FILL (50)   │  STROKE (700+) │  STYLE         │
 ├───────────────────────────┼──────────────┼────────────────┼────────────────┤
@@ -45,7 +45,7 @@ Soft pastel color palette (Tailwind 200-level) with dark borders for clear defin
 
 ## Salesforce-Specific Colors
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  SALESFORCE COMPONENT     │  FILL (200)  │  STROKE (700+) │  TEXT COLOR    │
 ├───────────────────────────┼──────────────┼────────────────┼────────────────┤
@@ -62,7 +62,7 @@ Soft pastel color palette (Tailwind 200-level) with dark borders for clear defin
 
 Color coding for data model diagrams by object type:
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  OBJECT TYPE              │  FILL (200)  │  STROKE (700+) │  TEXT COLOR    │
 ├───────────────────────────┼──────────────┼────────────────┼────────────────┤
@@ -114,7 +114,7 @@ style ext fill:#ecfdf5,stroke:#047857,stroke-dasharray:5
 
 ## Status Colors
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │  STATUS                   │  FILL (200)  │  STROKE (700+) │  ICON          │
 ├───────────────────────────┼──────────────┼────────────────┼────────────────┤
@@ -132,7 +132,7 @@ style ext fill:#ecfdf5,stroke:#047857,stroke-dasharray:5
 
 Mermaid supports custom fonts via `%%{init}`:
 
-```
+```text
 %%{init: { "fontFamily": "Inter, sans-serif", "fontSize": "14px" }}%%
 ```
 
@@ -187,7 +187,7 @@ Control diagram density with `%%{init}` configuration:
 
 For clean, readable diagrams:
 
-```
+```text
 %%{init: {"flowchart": {"nodeSpacing": 80, "rankSpacing": 70}} }%%
 ```
 
@@ -248,7 +248,7 @@ flowchart TB
 
 ### Simple Label (Recommended)
 
-```
+```json
 ["🤖 agentforce-generate"]
 ```
 
@@ -256,7 +256,7 @@ Keep labels short for consistent rendering.
 
 ### Database/Cylinder
 
-```
+```json
 [(💾 Database)]
 ```
 
@@ -344,7 +344,7 @@ flowchart TB
 ### Detailed Guidelines
 
 #### Node Labels: lowercase (Recommended)
-```
+```text
 ["🤖 agentforce-generate"]    ✅ Preferred
 ["🤖 agentforce-generate"]    ❌ Avoid
 ["🤖 agentforce-generate"]    ❌ Avoid
@@ -357,7 +357,7 @@ flowchart TB
 - Easier to read in compact diagram nodes
 
 #### Subgraph Titles: UPPERCASE
-```
+```text
 subgraph ai["🤖 AI & AGENTS"]           ✅ UPPERCASE
 subgraph ai["🤖 ai & agents"]           ❌ lowercase
 subgraph ai["🤖 Ai & Agents"]           ❌ Title Case
@@ -370,7 +370,7 @@ subgraph ai["🤖 Ai & Agents"]           ❌ Title Case
 - Maximum contrast between group titles and contents
 
 #### Edge Labels: lowercase
-```
+```text
 -->|"schema"|              ✅ lowercase
 -->|"Schema"|              ❌ Title Case
 -->|"SCHEMA"|              ❌ ALL CAPS
@@ -382,7 +382,7 @@ subgraph ai["🤖 Ai & Agents"]           ❌ Title Case
 - Consistent with node label style
 
 #### ASCII Diagrams: UPPERCASE for Headers
-```
+```text
 ┌─────────────────────────────────────┐
 │         SYSTEM LANDSCAPE            │   ✅ UPPERCASE header
 └─────────────────────────────────────┘