@salesforce/afv-skills 1.61.0 → 1.62.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@salesforce/afv-skills",
-  "version": "1.61.0",
-  "description": "Salesforce skills for Agentforce Vibes",
-  "license": "CC-BY-NC-4.0",
+  "version": "1.62.0",
+  "description": "Salesforce's curated collection of agent skills for building applications. Optimized for Agentforce Vibes, compatible with all AI tools.",
+  "license": "Apache-2.0",
   "files": [
     "skills/"
   ],

package/skills/agentforce-architecture-analyze/README.md

@@ -22,7 +22,7 @@ Scaling note: large bots with many flows scale approximately linearly in flow co
 
 | Tool | Why |
 |---|---|
-| `sf` CLI (authenticated against the target org) | Shells `sf org display --target-org <alias> --json` for access token, and `sf sobject describe` for the 7-day channel probe |
+| `sf` CLI (authenticated against the target org) | Must provide `sf org auth show-access-token` (preflighted at startup). Shells `sf org display --target-org <alias> --json` for org metadata, `sf org auth show-access-token --target-org <alias> --json --no-prompt` for the access token, and `sf sobject describe` for the 7-day channel probe |
 | Python 3.10+ | `pathlib`, dataclasses, `\|` union types, `concurrent.futures` |
 
 ---
@@ -143,6 +143,7 @@ Per-branch ancestor-path cycle detection is the primary termination primitive: t
 
 | Symptom | Fix |
 |---|---|
+| `sf CLI is missing required command 'sf org auth show-access-token'` | Upgrade/reinstall Salesforce CLI, then rerun |
 | `sf org display failed` | Re-authenticate: `sf org login web --alias <alias>` |
 | `INVALID_FIELD` from a SOQL asset | Salesforce renamed / removed the field in a quarterly release. Run with `--reprobe` to refresh the 7-day channel cache and pick up the new schema |
 | `STATUS=PROBE_FAILED` on first run | Channel probe saw a mandatory field missing. Check `channels.json` under the probe cache dir for which sObject / field — may require org-side feature enablement |

package/skills/agentforce-d360-analyze/README.md

@@ -25,7 +25,7 @@ Output: per-DMO JSON artifacts plus three derived files under `~/.vibe/data/agen
 
 | Tool | Why |
 |---|---|
-| `sf` CLI (authenticated against the target org) | Shells `sf org display --target-org <alias> --json` for the Data Cloud Query REST API access token |
+| `sf` CLI (authenticated against the target org) | Must provide `sf org auth show-access-token` (preflighted at startup). Shells `sf org display --target-org <alias> --json` for the instance URL and `sf org auth show-access-token --target-org <alias> --json --no-prompt` for the Data Cloud Query REST API access token |
 | Data Cloud enabled on the target org | Required — the STDM + GenAI DMOs must have materialized for the session |
 | Python 3.10+ | `pathlib`, dataclasses, `\|` union types |
 

package/skills/agentforce-generate/README.md

@@ -15,6 +15,7 @@ The skill routes agent work across the full lifecycle:
 | Diagnose Behavioral Issues | Trace-based debugging, routing/action analysis |
 | Deploy / Release | Draft iteration, deploy, explicit publish + activate |
 | Test an Agent | Coverage design, spec creation, run analysis |
+| Migrate a Legacy Agent | `GenAiPlannerBundle` → `AiAuthoringBundle` (Agent Script) conversion, then optimize |
 
 ## Skill Structure
 

package/skills/crm-analytics-wave-generate/SKILL.md

@@ -0,0 +1,212 @@
+---
+name: crm-analytics-wave-generate
+description: "Use to build a Wave Recipe, deploy a CRM Analytics dataset or dashboard, or author the full CRMA asset stack — apps, Wave Recipes (.wdpr), datasets, and dashboards — against a connected Salesforce org via REST and Metadata APIs, without CRM Analytics Studio or Dashboard Builder. TRIGGER when: user asks to build or create a Wave Recipe, generate a .wdpr or .wdpr-meta.xml, deploy a .wdash or .wapp, run a recipe or dataflowjob programmatically, upload CSV data via InsightsExternalData, validate a dataset schema with synthetic data, fetch dataset XMD, audit dashboard SAQL re-encoding, or find unused dataset fields. TRIGGER on keywords: Wave Recipe, CRMA, CRM Analytics, wdpr, wdash, wapp, WaveRecipe, Wave dataflow, dataflowjob, InsightsExternalData, SAQL, dataset XMD, Analytics Studio, R3 format, wave/recipes, wave/dashboards, or analytics on Salesforce objects (opportunities, leads, cases, accounts, sales). DO NOT TRIGGER for standard Salesforce reports or LWC components unrelated to CRM Analytics."
+metadata:
+  version: "1.0"
+  minApiVersion: "59.0"
+  cliTools:
+    - tool: ["curl"]
+      semver: ">=7.0.0"
+    - tool: ["node"]
+      semver: ">=18.0.0"
+    - tool: ["sf"]
+      semver: ">=2.0.0"
+---
+
+# Authoring CRM Analytics Assets
+
+End-to-end workflow for authoring the full CRM Analytics asset stack — application, Wave Recipe, dataset, and Wave Dashboard — against a Salesforce org from a local SFDX project, without the UI.
+
+## Scope
+
+- **In scope**: WaveApplication, WaveRecipe (R3 format), Wave datasets (recipe-driven + CSV upload via InsightsExternalData), Wave Dashboards (.wdash deploy + PATCH styling), SAQL step authoring, dataset XMD inspection, dashboard auditing.
+- **Out of scope**: Standard Salesforce reports/dashboards, LWC analytics bridge components, Tableau CRM managed packages, org provisioning.
+
+---
+
+## Decision Tree — Pick the Right Method
+
+Before acting, read `references/method-decision-tree.md` to select the correct API path for the user's goal. Wrong method choices (e.g. multipart upload instead of R3 JSON body) cause silent failures that are hard to diagnose.
+
+---
+
+## Required Inputs
+
+- Authenticated org alias (verify with `sf org display -o <alias> --json`)
+- Target CRMA app name (folder developer name)
+- Recipe or dashboard name and output dataset alias
+- Source sObjects to load (API names, e.g. `Opportunity`, `Account`)
+- Field list per sObject
+- Transformation intent: formula fields, aggregations, filter conditions
+
+Defaults:
+- Local Salesforce connector name: `SFDC_LOCAL` (verify via `GET /wave/dataConnectors`)
+- API version: use `result.apiVersion` from `sf org display`
+- Node.js binary: `/usr/local/lib/sf/bin/node` (bundled with sf CLI)
+
+---
+
+## Workflow
+
+### Phase Selection
+
+Before starting, identify the user's goal and determine which phases to run:
+
+| User goal | Phases to run |
+|-----------|--------------|
+| Build or update a recipe and dataset | 0 → 1 → 2 |
+| Validate recipe output schema after run | 0 → 1 → 2 → 3 |
+| Build or update a dashboard | 0 → 1 → 2 → 4 |
+| Full end-to-end: recipe + validation + dashboard | 0 → 1 → 2 → 3 → 4 |
+| Audit dataset for unused fields / stale SAQL | 0 → 1 → 5 |
+
+Execute only the phases in the selected path. Do not revisit this table mid-workflow.
+
+### Phase 0 — Bootstrap Scripts
+
+1. **Check for helper scripts** — before running any script referenced in this workflow, verify the `scripts/` directory exists in the skill root. All 11 scripts listed in `references/scripts-reference.md` are bundled with this skill. If a script is somehow missing, check that the skill was installed from the full repo (not a partial clone). Do not regenerate scripts from the descriptions — the implementations are authoritative.
+
+### Phase 1 — Setup
+
+2. **Verify org connection** — run `sf org display -o <alias> --json`. Capture `accessToken` and `instanceUrl`. If EPERM error, shell is sandboxed — re-run with full permissions.
+
+3. **Look up or create the CRMA app** — run `scripts/create_app.js <alias> <appName>`. The script lists existing folders and only creates if missing. Do NOT include `assetIcon`.
+
+### Phase 2 — Recipe Authoring
+
+4. **Read the R3 node schema** — load `references/r3-node-schema.md` before writing any recipe JSON. Every node shape, critical field rule, and formula gotcha is documented there.
+
+5. **Author the recipe JSON** — the `.wdpr` file contains only the `recipeDefinition` object (the `nodes` map, `runMode`, and `ui` section). Do NOT wrap it in an API envelope (`fileFormat`, `label`, `name`, `recipe: {}`) — the deploy script reads this file directly as the `recipeDefinition` body; wrapping it causes the wrong JSON structure to be POSTed at `?format=R3`, leaving `targetDataflowId` null. Save to `force-app/main/default/wave/<RecipeName>.wdpr`. Key rules:
+   - `runMode` must be `"full"` for generated recipes — NOT `"R3"` (which is only used as a query param on the API endpoint). Use `"incremental"` instead of `"full"` for large objects where reprocessing the entire source on every run is too slow; use `"streaming"` for near-real-time pipelines. `"full"` is the safe default for new recipes.
+   - Use `sources` (array), never `source` (singular)
+   - One field per formula node — chain them in sequence
+   - Use `expressionType: "SQL"` and `type: "NUMBER"` or `type: "TEXT"` on formula fields
+   - For text date dimensions use `date_format(field, 'yyyy')` or `date_format(field, 'MM/yyyy')`
+   - Formula node action is `"formula"` — NOT `"computeExpression"`, `"augmentColumns"`, or `"transform"`. Fields array key is `"fields"` (NOT `"columns"`). Expression key is `"formulaExpression"` (NOT `"expression"`). Do NOT use backtick quotes around field names in expressions.
+   - Insert an `EXTRACT0` (`extractGrains`) node between the last formula node and aggregate
+   - Use the Designer-native `ui` section format — read `references/ui-section-template.md`
+
+   **CRITICAL — top-level `.wdpr` file structure.** `nodes` is a ROOT-LEVEL object with UPPERCASE string keys. Do NOT put nodes inside `ui`. Do NOT use an array for `ui.nodes`. The file has exactly three top-level keys: `runMode`, `nodes`, `ui`. See `examples/wdpr-skeleton.wdpr` for a minimal 5-node skeleton (load → formula → extractGrains → aggregate → save).
+
+   See the wrong-variant reference table in `references/r3-node-schema.md → "Common wrong variants"` for the full list of correct vs incorrect field names per node type.
+
+6. **Write SFDX metadata wrappers** — every `.wdpr` file MUST be accompanied by a `.wdpr-meta.xml` in the same directory. These are always created as a pair — outputting the recipe JSON without its metadata wrapper is incomplete. Use the template at `assets/wdpr-meta-template.xml`. Required fields: `<application>`, `<masterLabel>`, `<targetDatasetAlias>`, `<dataflow>` (set to the same value as `<targetDatasetAlias>`). Do NOT add `<description>`, `<label>`, `<accessType>`, `<shareType>`, or `<format>` — each triggers a deploy failure. Similarly, every `.wapp` requires a `.wapp-meta.xml`.
+
+7. **Deploy recipe via REST** — run `scripts/deploy_and_run_recipe.js <alias> <recipeFile.wdpr> <appName> <recipeName>`. This script: looks up folder id → POSTs or PATCHes recipe at `?format=R3` → asserts `targetDataflowId` returned → POSTs to `/wave/dataflowjobs` → polls until terminal.
+
+8. **Verify recipe ran** — terminal statuses: `Success`, `Failure`, `Warning`, `Cancelled`. On `Failure`, run `scripts/check_connector_error.sh <alias> <connectorId>` — exits 0 for `System` errors (safe to retry), exits 1 for `User`/`Limit` errors (do not retry; fix config first). If retries persist on a `System` error, run `POST /wave/dataConnectors/{id}/ingest` to force a connector refresh.
+
+### Phase 3 — Dataset Validation
+
+9. **Upload synthetic data** — run `scripts/gen_synthetic_dataset.js` (schema-driven, reads live XMD) then `scripts/upload_dataset.js`. Read `references/external-data-upload.md` for InsightsExternalData rules.
+
+10. **Verify with SAQL** — run `scripts/verify_synthetic_dataset.js`. A 200 on `Action=Process` only means ingestion was queued — wait for `Status=Completed`, then verify with a count query.
+
+### Phase 4 — Dashboard Authoring
+
+11. **Read dashboard rules** — load `references/dashboard-authoring.md` before writing any `.wdash`. Covers the two-step deploy+PATCH workflow, accepted widget parameters per type, and the SAQL re-encoding trap.
+
+12. **Build minimal `.wdash`** — use `assets/dashboard-template.json` as the starting structure. Keep widget parameters minimal at deploy time (see `references/dashboard-authoring.md → "Deploy-time rules"`). Deploy with `sf project deploy start`. When a listselector must drive another step's SAQL (not a global facet), put a `{{column(step.selection, ["Field"]).asEquality("TargetField")}}` binding in that step's query and set `broadcastFacet`/`useGlobal` to `false` on both steps — see `references/dashboard-authoring.md → "Query bindings"`.
+
+13. **Apply styling via PATCH** — after deploy, `PATCH /wave/dashboards/{id}` with enriched state. **Always `decodeAll` every `state.steps[*].query` immediately after GET, before any mutation + PATCH.** This is the #1 silent failure mode: the API HTML-encodes SAQL on write (`"` → `&quot;`). GET → PATCH without decoding encodes again (`&amp;quot;`, then `&amp;amp;quot;`) and every widget renders Error 119. The helper is in `references/dashboard-authoring.md`. Use `scripts/patch_t_oppo_view.js` as the canonical GET → decodeAll → merge → PATCH template.
+
+14. **Verify all steps render** — before running, edit the `DASH_ID` and `DS` constants at the top of `scripts/verify_dashboard_steps.js` to the deployed dashboard's 18-char ID and the dataset's current ID/versionId. Then run `scripts/verify_dashboard_steps.js <alias>`. For each step: GET stored SAQL → decode → swap dataset name for `id/currentVersionId` → POST to `/wave/query`. Confirm 200 + rows. **Do not mark done until user confirms widgets render in the browser.**
+
+### Phase 5 — Dataset Hygiene
+
+15. **Find unused fields** — run `scripts/find_unused_dataset_fields.js <alias> <DatasetName>`. Read `references/dataset-hygiene.md` for caveats (aggregateflex steps, multi-dataset SAQL, archived apps).
+
+---
+
+## Rules / Constraints
+
+| Constraint | Rationale |
+|-----------|-----------|
+| Every `.wdpr` MUST be paired with a `.wdpr-meta.xml` in the same directory | Metadata wrapper is required for SFDX deploy; recipe JSON alone is an incomplete artifact |
+| Always POST recipes at `?format=R3` with `recipeDefinition` in JSON body | Multipart upload creates recipe but never compiles it — `targetDataflowId` stays null |
+| PATCH recipe with `?format=R3` JSON body only; never multipart PATCH | Multipart PATCH updates raw file but destroys compiled state → "tableModelInfo is null" |
+| On `tableModelInfo is null`: DELETE then re-POST | Only re-POST triggers server-side compilation |
+| Use `targetDataflowId` (02K...) on `/wave/dataflowjobs`, never recipe id (05v...) | `/wave/dataflowjobs` only accepts the dataflow id |
+| One field per formula node | REST API accepts multiple but Recipe Designer breaks with "Can't Load the Recipe" |
+| Use `column` not `col` in gridLayouts widget entries | `col` triggers `Unrecognized field "col"` on deploy |
+| `widgetStyle.borderRadius` must be integer (e.g. `8`), not CSS string | String value rejected at PATCH |
+| Use name-based dataset load in stored SAQL, not id/version | id/version load requires a `datasets` binding the PATCH input rep rejects |
+| Always decode SAQL before PATCH — use `decodeAll` | GET returns HTML-encoded SAQL; re-encoding on every PATCH accumulates → `&amp;amp;quot;` |
+| `valuestable` widget rejects all styling at PATCH — use `chart` with `visualizationType: "flatTable"` | chart widget accepts the full rich-styling param set |
+| `POST /wave/dashboards` only creates retired classic dashboards | Use Metadata API deploy for modern grid dashboards |
+| KPI total requires `group q by all` before `foreach` | Without it, `foreach` acts as a window function returning one row per source row |
+
+---
+
+## Gotchas
+
+| Issue | Resolution |
+|-------|------------|
+| Recipe sits in `New` status, `targetDataflowId` null | Re-create via `POST /wave/recipes?format=R3` with `recipeDefinition` in JSON body |
+| Formula type `"TEXT"` but expression returns number | Use `type: "NUMBER"` and `expressionType: "SQL"` — other type strings silently normalize to TEXT |
+| Aggregate fails: `Can't find field _Year / _Month` | Auto-derived date helpers don't exist mid-pipeline; derive explicitly via `date_format` formula node |
+| `400 errorCode 276` on POST recipe | Name already in use — PATCH the existing recipe instead |
+| All widgets show Error after PATCH | SAQL re-encoding — run `decodeAll` on every step query before PATCH |
+| `listselector` list text invisible on dark bg | Set `filterStyle.valueColor` — it defaults to dark; always set a contrasting color |
+| `date_format(CloseDate, 'MMM yyyy')` produces numeric month | Use `'MM/yyyy'` for text dimensions — `MMM` silently returns integer in recipe formula context |
+
+---
+
+## Output Expectations
+
+- `force-app/main/default/wave/<RecipeName>.wdpr` — Wave Recipe JSON (R3 format)
+- `force-app/main/default/wave/<AppName>.wapp-meta.xml` — app metadata wrapper
+- `force-app/main/default/wave/<RecipeName>.wdpr-meta.xml` — recipe metadata wrapper
+- `force-app/main/default/wave/<DashboardName>.wdash` — dashboard state JSON
+- `force-app/main/default/wave/<DashboardName>.wdash-meta.xml` — dashboard metadata wrapper
+
+---
+
+## Reusable Scripts
+
+All scripts accept org alias as first positional arg. Read `references/scripts-reference.md` for full descriptions and usage.
+
+| Script | Purpose |
+|--------|---------|
+| `scripts/create_app.js` | Idempotently create a CRMA app folder |
+| `scripts/deploy_and_run_recipe.js` | Create + compile + run recipe end-to-end |
+| `scripts/probe_recipe.js` | Fetch recipe compile status + `targetDataflowId` |
+| `scripts/fetch_dataset_xmd.js` | Dump dataset XMD (dimensions/measures/dates) |
+| `scripts/gen_synthetic_dataset.js` | Schema-driven synthetic data generator |
+| `scripts/upload_dataset.js` | Upload CSV via InsightsExternalData API |
+| `scripts/verify_synthetic_dataset.js` | Post-upload SAQL sanity checks |
+| `scripts/find_unused_dataset_fields.js` | List XMD fields not referenced in any dashboard SAQL |
+| `scripts/verify_dashboard_steps.js` | POST each step's SAQL to `/wave/query` and confirm rows |
+| `scripts/patch_t_oppo_view.js` | Full-cycle PATCH template with dark theme and `decodeAll` |
+| `scripts/check_connector_error.sh` | Check connector `errorCategory`; exits 0=System (retryable), 1=User/Limit (do not retry) |
+
+---
+
+## Cross-Skill Integration
+
+| Need | Delegate to |
+|------|-------------|
+| Deploying Wave metadata via SFDX project deploy | Use standard `sf project deploy` — no skill needed |
+| LWC components that consume Wave datasets | Use an appropriate LWC skill |
+
+---
+
+## Reference File Index
+
+| File | When to read |
+|------|-------------|
+| `references/method-decision-tree.md` | Phase 1 — before choosing API path |
+| `references/r3-node-schema.md` | Phase 2 — before writing any recipe node |
+| `references/ui-section-template.md` | Phase 2 — when building the Designer-native `ui` section |
+| `assets/wapp-meta-template.xml` | Phase 2 — when creating `.wapp-meta.xml` |
+| `assets/wdpr-meta-template.xml` | Phase 2 — when creating `.wdpr-meta.xml` |
+| `references/external-data-upload.md` | Phase 3 — InsightsExternalData rules and common errors |
+| `references/dashboard-authoring.md` | Phase 4 — full dashboard deploy+PATCH rules and re-encoding trap |
+| `assets/wdash-meta-template.xml` | Phase 4 — when creating `.wdash-meta.xml` |
+| `assets/dashboard-template.json` | Phase 4 — minimal deploy-valid `.wdash` starting structure |
+| `references/dataset-hygiene.md` | Phase 5 — unused field detection and SAQL re-encoding audit |
+| `references/scripts-reference.md` | Any phase — full script descriptions and usage |
+| `examples/wdpr-skeleton.wdpr` | Phase 2 — minimal 5-node skeleton (load → formula → extractGrains → aggregate → save) |
+| `examples/opportunity-revenue-recipe.wdpr` | Phase 2 — fully annotated example recipe with all node types |
+| `examples/pipeline-by-industry-quarter.wdpr` | Phase 2 — kitchen-sink join + formula chain + extractGrains + case/coalesce/quarter |
+| `examples/industry-binding-dashboard.wdash` | Phase 4 — listselector driving a SAQL filter via `column().asEquality()` |

package/skills/crm-analytics-wave-generate/assets/dashboard-template.json

@@ -0,0 +1,66 @@
+{
+    "dataSourceLinksInfo": {},
+    "gridLayouts": [{
+        "name": "default",
+        "numColumns": 24,
+        "pages": [{
+            "label": "Page 1",
+            "name": "Page_1",
+            "navigationHidden": false,
+            "widgets": [
+                { "name": "wgt_kpi",    "row": 0,  "column": 6,  "colspan": 18, "rowspan": 4 },
+                { "name": "wgt_filter", "row": 0,  "column": 0,  "colspan": 6,  "rowspan": 4 },
+                { "name": "wgt_chart",  "row": 4,  "column": 0,  "colspan": 24, "rowspan": 9 },
+                { "name": "wgt_table",  "row": 13, "column": 0,  "colspan": 24, "rowspan": 9 }
+            ]
+        }]
+    }],
+    "widgets": {
+        "wgt_filter": { "type": "listselector", "parameters": { "step": "step_filter" } },
+        "wgt_kpi":    { "type": "number",       "parameters": { "step": "step_kpi", "measureField": "{MEASURE_FIELD}" } },
+        "wgt_chart":  { "type": "chart",        "parameters": { "step": "step_chart", "visualizationType": "hbar" } },
+        "wgt_table":  { "type": "chart",        "parameters": { "step": "step_table", "visualizationType": "flatTable" } }
+    },
+    "steps": {
+        "step_filter": {
+            "type": "saql",
+            "query": "q = load \"{DATASET_NAME}\"; q = foreach q generate '{FILTER_FIELD}' as '{FILTER_FIELD}'; q = limit q 1000;",
+            "broadcastFacet": true,
+            "useGlobal": true,
+            "selectMode": "multi",
+            "groups": [],
+            "numbers": [],
+            "strings": []
+        },
+        "step_kpi": {
+            "type": "saql",
+            "query": "q = load \"{DATASET_NAME}\"; q = group q by all; q = foreach q generate sum('{MEASURE_FIELD}') as '{MEASURE_FIELD}';",
+            "broadcastFacet": true,
+            "useGlobal": true,
+            "selectMode": "single",
+            "groups": [],
+            "numbers": [],
+            "strings": []
+        },
+        "step_chart": {
+            "type": "saql",
+            "query": "q = load \"{DATASET_NAME}\"; q = group q by '{DIMENSION_FIELD}'; q = foreach q generate '{DIMENSION_FIELD}' as '{DIMENSION_FIELD}', sum('{MEASURE_FIELD}') as '{MEASURE_FIELD}'; q = order q by '{MEASURE_FIELD}' desc; q = limit q 20;",
+            "broadcastFacet": true,
+            "useGlobal": true,
+            "selectMode": "single",
+            "groups": [],
+            "numbers": [],
+            "strings": []
+        },
+        "step_table": {
+            "type": "saql",
+            "query": "q = load \"{DATASET_NAME}\"; q = group q by '{DIMENSION_FIELD}'; q = foreach q generate '{DIMENSION_FIELD}' as '{DIMENSION_FIELD}', sum('{MEASURE_FIELD}') as '{MEASURE_FIELD}'; q = order q by '{MEASURE_FIELD}' desc; q = limit q 100;",
+            "broadcastFacet": true,
+            "useGlobal": true,
+            "selectMode": "single",
+            "groups": [],
+            "numbers": [],
+            "strings": []
+        }
+    }
+}

package/skills/crm-analytics-wave-generate/assets/wapp-meta-template.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<WaveApplication xmlns="http://soap.sforce.com/2006/04/metadata">
+    <folder>{FOLDER_DEVELOPER_NAME}</folder>
+    <masterLabel>{DISPLAY_LABEL}</masterLabel>
+    <shares>
+        <accessLevel>Manage</accessLevel>
+        <sharedTo>{USER_EMAIL}</sharedTo>
+        <sharedToType>User</sharedToType>
+    </shares>
+</WaveApplication>

package/skills/crm-analytics-wave-generate/assets/wdash-meta-template.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<WaveDashboard xmlns="http://soap.sforce.com/2006/04/metadata">
+    <application>{FOLDER_DEVELOPER_NAME}</application>
+    <masterLabel>{DASHBOARD_DISPLAY_LABEL}</masterLabel>
+    <description>{OPTIONAL_DESCRIPTION}</description>
+</WaveDashboard>

package/skills/crm-analytics-wave-generate/assets/wdpr-meta-template.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<WaveRecipe xmlns="http://soap.sforce.com/2006/04/metadata">
+    <application>{FOLDER_DEVELOPER_NAME}</application>
+    <masterLabel>{RECIPE_DISPLAY_LABEL}</masterLabel>
+    <targetDatasetAlias>{OUTPUT_DATASET_NAME}</targetDatasetAlias>
+    <dataflow>{OUTPUT_DATASET_NAME}</dataflow>
+</WaveRecipe>
+
+<!-- DO NOT add: <description>, <label>, <accessType>, <shareType>, <format> -->
+<!-- Each of these triggers a deploy failure -->
+<!-- <dataflow> IS required — set it to the same value as <targetDatasetAlias> -->

package/skills/crm-analytics-wave-generate/examples/industry-binding-dashboard.wdash

@@ -0,0 +1,67 @@
+{
+    "dataSourceLinksInfo": {},
+    "gridLayouts": [
+        {
+            "name": "default",
+            "numColumns": 24,
+            "pages": [
+                {
+                    "label": "Page 1",
+                    "name": "Page_1",
+                    "navigationHidden": false,
+                    "widgets": [
+                        { "name": "wgt_industry_filter", "row": 0, "column": 0, "colspan": 6, "rowspan": 4 },
+                        { "name": "wgt_kpi", "row": 0, "column": 6, "colspan": 18, "rowspan": 4 },
+                        { "name": "wgt_accounts", "row": 4, "column": 0, "colspan": 24, "rowspan": 9 }
+                    ]
+                }
+            ]
+        }
+    ],
+    "widgets": {
+        "wgt_industry_filter": {
+            "type": "listselector",
+            "parameters": { "step": "step_industry_sel" }
+        },
+        "wgt_kpi": {
+            "type": "number",
+            "parameters": { "step": "step_kpi", "measureField": "TotalRevenue" }
+        },
+        "wgt_accounts": {
+            "type": "chart",
+            "parameters": { "step": "step_accounts", "visualizationType": "hbar" }
+        }
+    },
+    "steps": {
+        "step_industry_sel": {
+            "type": "saql",
+            "query": "q = load \"DTS_PipelineByIndustry\"; q = group q by 'Account.Industry'; q = foreach q generate 'Account.Industry' as 'Industry'; q = order q by 'Industry' asc;",
+            "broadcastFacet": false,
+            "useGlobal": false,
+            "selectMode": "single",
+            "groups": [],
+            "numbers": [],
+            "strings": []
+        },
+        "step_kpi": {
+            "type": "saql",
+            "query": "q = load \"DTS_PipelineByIndustry\"; q = filter q by {{column(step_industry_sel.selection, [\"Industry\"]).asEquality(\"Account.Industry\")}}; q = group q by all; q = foreach q generate sum('TotalRevenue') as 'TotalRevenue';",
+            "broadcastFacet": false,
+            "useGlobal": false,
+            "selectMode": "single",
+            "groups": [],
+            "numbers": [],
+            "strings": []
+        },
+        "step_accounts": {
+            "type": "saql",
+            "query": "q = load \"DTS_PipelineByIndustry\"; q = filter q by {{column(step_industry_sel.selection, [\"Industry\"]).asEquality(\"Account.Industry\")}}; q = group q by 'Account.Name'; q = foreach q generate 'Account.Name' as 'AccountName', sum('TotalRevenue') as 'TotalRevenue'; q = order q by 'TotalRevenue' desc; q = limit q 10;",
+            "broadcastFacet": false,
+            "useGlobal": false,
+            "selectMode": "single",
+            "groups": [],
+            "numbers": [],
+            "strings": []
+        }
+    }
+}

package/skills/crm-analytics-wave-generate/examples/opportunity-revenue-recipe.wdpr

@@ -0,0 +1,132 @@
+{
+    "runMode": "full",
+    "nodes": {
+        "LOAD_OPPORTUNITY": {
+            "action": "load",
+            "sources": [],
+            "parameters": {
+                "dataset": {
+                    "type": "connectedDataset",
+                    "label": "Opportunity",
+                    "connectionName": "SFDC_LOCAL",
+                    "sourceObjectName": "Opportunity"
+                },
+                "fields": ["Id", "AccountId", "StageName", "CloseDate", "Amount"],
+                "mode": "SYNCED",
+                "preserveCurrencyFields": [],
+                "sampleDetails": { "type": "TopN", "sortBy": [] }
+            }
+        },
+        "LOAD_ACCOUNT": {
+            "action": "load",
+            "sources": [],
+            "parameters": {
+                "dataset": {
+                    "type": "connectedDataset",
+                    "label": "Account",
+                    "connectionName": "SFDC_LOCAL",
+                    "sourceObjectName": "Account"
+                },
+                "fields": ["Id", "Name", "Industry"],
+                "mode": "SYNCED",
+                "preserveCurrencyFields": [],
+                "sampleDetails": { "type": "TopN", "sortBy": [] }
+            }
+        },
+        "FILTER_CLOSED_WON": {
+            "action": "filter",
+            "sources": ["LOAD_OPPORTUNITY"],
+            "parameters": {
+                "filterExpressions": [
+                    { "field": "StageName", "operator": "EQUAL", "operands": ["Closed Won"], "type": "TEXT" }
+                ]
+            }
+        },
+        "JOIN_ACCOUNT": {
+            "action": "join",
+            "sources": ["FILTER_CLOSED_WON", "LOAD_ACCOUNT"],
+            "parameters": {
+                "joinType": "LOOKUP",
+                "leftKeys": ["AccountId"],
+                "rightKeys": ["Id"],
+                "rightQualifier": "Account"
+            }
+        },
+        "COMPUTE_CLOSE_YEAR": {
+            "action": "formula",
+            "sources": ["JOIN_ACCOUNT"],
+            "parameters": {
+                "expressionType": "SQL",
+                "fields": [{ "name": "CloseYear", "label": "Close Year", "type": "TEXT", "formulaExpression": "date_format(CloseDate, 'yyyy')" }]
+            }
+        },
+        "COMPUTE_CLOSE_MONTH": {
+            "action": "formula",
+            "sources": ["COMPUTE_CLOSE_YEAR"],
+            "parameters": {
+                "expressionType": "SQL",
+                "fields": [{ "name": "CloseMonth", "label": "Close Month", "type": "TEXT", "formulaExpression": "date_format(CloseDate, 'MM/yyyy')" }]
+            }
+        },
+        "EXTRACT0": {
+            "action": "extractGrains",
+            "sources": ["COMPUTE_CLOSE_MONTH"],
+            "parameters": { "grainExtractions": [] }
+        },
+        "AGGREGATE_BY_ACCOUNT_MONTH": {
+            "action": "aggregate",
+            "sources": ["EXTRACT0"],
+            "parameters": {
+                "aggregations": [{ "name": "TotalRevenue", "label": "Total Revenue", "action": "SUM", "source": "Amount" }],
+                "groupings": ["AccountId", "Account.Name", "Account.Industry", "CloseYear", "CloseMonth"],
+                "nodeType": "STANDARD",
+                "pivots": []
+            }
+        },
+        "OUTPUT_DTS_OPW": {
+            "action": "save",
+            "sources": ["AGGREGATE_BY_ACCOUNT_MONTH"],
+            "parameters": {
+                "dataset": {
+                    "type": "analyticsDataset",
+                    "label": "DTS_OpportunityRev",
+                    "name": "DTS_OpportunityRev",
+                    "folderName": "OpportunityInsights"
+                },
+                "fields": [],
+                "measuresToCurrencies": []
+            }
+        }
+    },
+    "ui": {
+        "nodes": {
+            "LOAD_OPPORTUNITY": { "label": "Opportunity", "type": "LOAD_DATASET", "top": 112, "left": 112, "parameters": { "sampleSize": 2000 } },
+            "LOAD_ACCOUNT":     { "label": "Account",     "type": "LOAD_DATASET", "top": 252, "left": 252, "parameters": { "sampleSize": 2000 } },
+            "FILTER_CLOSED_WON": { "label": "FILTER_CLOSED_WON", "type": "FILTER", "top": 112, "left": 252 },
+            "JOIN_ACCOUNT":      { "label": "JOIN_ACCOUNT",      "type": "JOIN",   "top": 112, "left": 392 },
+            "TRANSFORM0": {
+                "label": "TRANSFORM0", "type": "TRANSFORM", "top": 112, "left": 532,
+                "graph": {
+                    "COMPUTE_CLOSE_YEAR":  { "parameters": { "type": "BASE_FORMULA_UI" } },
+                    "COMPUTE_CLOSE_MONTH": { "parameters": { "type": "BASE_FORMULA_UI" } }
+                },
+                "connectors": [{ "source": "COMPUTE_CLOSE_YEAR", "target": "COMPUTE_CLOSE_MONTH" }]
+            },
+            "AGGREGATE0": {
+                "label": "AGGREGATE0", "type": "AGGREGATE", "top": 112, "left": 672,
+                "graph": { "EXTRACT0": null, "AGGREGATE_BY_ACCOUNT_MONTH": null },
+                "connectors": [{ "source": "EXTRACT0", "target": "AGGREGATE_BY_ACCOUNT_MONTH" }]
+            },
+            "OUTPUT_DTS_OPW": { "label": "OUTPUT_DTS_OPW", "type": "OUTPUT", "top": 112, "left": 812 }
+        },
+        "connectors": [
+            { "source": "LOAD_OPPORTUNITY",  "target": "FILTER_CLOSED_WON" },
+            { "source": "FILTER_CLOSED_WON", "target": "JOIN_ACCOUNT" },
+            { "source": "LOAD_ACCOUNT",      "target": "JOIN_ACCOUNT" },
+            { "source": "JOIN_ACCOUNT",      "target": "TRANSFORM0" },
+            { "source": "TRANSFORM0",        "target": "AGGREGATE0" },
+            { "source": "AGGREGATE0",        "target": "OUTPUT_DTS_OPW" }
+        ],
+        "hiddenColumns": []
+    }
+}