Merge branch 'main' into rw/publication-updates

Author: muenzpraeger

.github/workflows/ci-pr.yml

@@ -79,7 +79,7 @@ jobs:
               id: run-code-analyzer
               uses: forcedotcom/run-code-analyzer@v2
               with:
-                  run-arguments: --workspace "force-app/**" --view detail --output-file "sca-results.csv" --config-file "code-analyzer.yml"
+                  run-arguments: --workspace "force-app/main" --view detail --output-file "sca-results.csv" --config-file "code-analyzer.yml"
                   results-artifact-name: code-analyzer-results
                   github-token: ${{ github.token }}
 

.github/workflows/ci.yml

@@ -62,7 +62,7 @@ jobs:
               id: run-code-analyzer
               uses: forcedotcom/run-code-analyzer@v2
               with:
-                  run-arguments: --workspace "force-app/**" --view detail --output-file "sca-results.csv" --config-file "code-analyzer.yml"
+                  run-arguments: --workspace "force-app/main" --view detail --output-file "sca-results.csv" --config-file "code-analyzer.yml"
                   results-artifact-name: code-analyzer-results
                   github-token: ${{ github.token }}
 

README.md

@@ -9,15 +9,19 @@ A collection of easy-to-digest [Agent Script](https://developer.salesforce.com/d
 
 ## Table of contents
 
-- [Salesforce CLI prerequisite](#salesforce-cli-prerequisite)
+- [Prerequisites](#prerequisites)
 
 - Install the app with either one of these options:
     - **Option 1:** [Developer Edition Org installation](#installing-the-app-using-a-developer-edition-org) - Use this option if you want the app deployed to a more permanent environment than a Scratch org.
     - **Option 2:** [Scratch Org installation](#installing-the-app-using-a-scratch-org) - Use this option if you are a developer who wants to experience the app and the code in a temporary environment.
 
 - [Optional installation instructions](#optional-installation-instructions)
 
-## Salesforce CLI prerequisite
+## Prerequisites
+
+Regardless of the installation type you chose, make sure to review the following prerequisites.
+
+### Salesforce CLI Version
 
 > [!IMPORTANT]
 > This project requires Salesforce CLI with version `2.113.6` or greater.
@@ -26,6 +30,20 @@ A collection of easy-to-digest [Agent Script](https://developer.salesforce.com/d
 
 If you need to [update the Salesforce CLI](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_update_cli.htm), either run `sf update` or `npm install --global @salesforce/cli` depending on how you installed the CLI.
 
+### Feature Activation
+
+1. **Einstein:** Enable Einstein in your org. From **Setup**, search for **Einstein Setup** in Quick Find. Click on that entry and turn on the **Einstein** toggle.
+
+1. **Agentforce:** Enable Agentforce in your org. From **Setup**, search for **Agentforce** in Quick Find. Click on **Agentforce Agents**, and turn on the **Agentforce** toggle.
+
+### User Permissions
+
+**Prompt Template Manager:** Assign yourself the `Prompt Template Manager` permission set. You can either do this from **Setup** or with the Salesforce CLI by running this command:
+
+```bash
+sf org assign permset -n EinsteinGPTPromptTemplateManager
+```
+
 ## Installing the app using a Developer Edition Org
 
 Follow this set of instructions if you want to deploy the app to a more permanent environment than a Scratch org.
@@ -34,10 +52,6 @@ This includes non source-tracked orgs such as a free [Developer Edition Org](htt
 > [!IMPORTANT]
 > Make sure to start from a brand-new environment to avoid conflicts with previous work you may have done.
 
-1. Enable Einstein in your org. Do this via **Setup**, then search for **Einstein Setup** in Quick Find. Click on that entry and turn on the **Einstein** toggle.
-
-2. Enable Agentforce in your org. In Quick Find search for **Agentforce**, click on **Agentforce Agents**, and turn on the **Agentforce** toggle.
-
 3. Clone this repository:
 
     ```bash
@@ -79,6 +93,8 @@ This includes non source-tracked orgs such as a free [Developer Edition Org](htt
 > [!TIP]
 > **Agentforce Studio** can be reached from the App Launcher. From there, click **View All** then select the **Agentforce Studio** app.
 
+**Post installation:** when working with the recipes, assign the **Agent Script Recipes Data** permission set to your agent user to avoid access issues.
+
 ## Installing the app using a Scratch Org
 
 1. Follow these steps if you haven't configured a Dev Hub org:
@@ -131,6 +147,8 @@ This includes non source-tracked orgs such as a free [Developer Edition Org](htt
 > [!TIP]
 > **Agentforce Studio** can be reached from the App Launcher. From there, click **View All** then select the **Agentforce Studio** app.
 
+**Post installation:** when working with the recipes, assign the **Agent Script Recipes Data** permission set to your agent user to avoid access issues.
+
 ## Optional Installation Instructions
 
 This repository contains several files that are relevant if you want to integrate modern web development tools into your Salesforce development processes or into your continuous integration/continuous deployment processes.

code-analyzer.yml

@@ -1,6 +1,12 @@
-engines:
+rules:
     flow:
-        disable_engine: true
+        # Disabled HardCodedId rule for flow as a temporary workaround for
+        # https://github.com/forcedotcom/code-analyzer/issues/1947
+        HardCodedId:
+            severity: Critical
+            tags: []
+
+engines:
     eslint:
         auto_discover_eslint_config: true
         disable_javascript_base_config: true

package-lock.json

@@ -10,6 +10,7 @@
         "url": "git+https://github.com/trailheadapps/agent-script-recipes"
     },
     "scripts": {
+        "code-analyzer": "sf code-analyzer run --workspace force-app/main --view detail --output-file \"sca-results.csv\" --config-file \"code-analyzer.yml\"",
         "lint": "eslint .",
         "test": "npm run test:unit",
         "test:unit": "sfdx-lwc-jest",
@@ -41,10 +42,10 @@
         "@salesforce/sfdx-lwc-jest": "^7.1.2",
         "eslint": "^9.39.1",
         "eslint-plugin-import": "^2.32.0",
-        "eslint-plugin-jest": "^29.0.1",
+        "eslint-plugin-jest": "^29.2.1",
         "husky": "^9.1.7",
         "lint-staged": "^16.2.6",
-        "prettier": "^3.6.2",
+        "prettier": "^3.7.4",
         "prettier-plugin-apex": "^2.2.6"
     },
     "volta": {