@salesforce/ui-bundle-template-base-sfdx-project 11.4.5 → 11.4.6

package/AGENT.md

@@ -146,16 +146,18 @@ Do not consider a task complete until all three steps have been run successfully
 
 ### Data access (Salesforce)
 
-**Before writing any code that connects to Salesforce, you MUST invoke the `using-ui-bundle-salesforce-data` skill. Do not write any data access code without consulting it first.**
+**Before writing any code that connects to Salesforce, you MUST invoke the `experience-ui-bundle-salesforce-data-access` skill. Do not write any data access code without consulting it first.**
 
 This applies to: GraphQL queries/mutations, REST calls, SDK initialization, custom hooks that fetch data, or any code that imports from `@salesforce/platform-sdk`.
 
+**The skill is the authoritative source for how to ground (verify entities/fields against the org) and author queries/mutations.** The bullets below are project orientation only — they do **not** substitute for the skill's workflow. Where this file and the skill differ, follow the skill.
+
 - **All data access uses the Data SDK** (`@salesforce/platform-sdk`) via `createDataSDK()`.
 - **Never** use `fetch()` or `axios` directly for Salesforce data.
 - **GraphQL is preferred** for record operations (`sdk.graphql`). Use `sdk.fetch` only when GraphQL cannot cover the case (UI API REST, Apex REST, Connect REST, Einstein LLM).
 - Use optional chaining: `sdk.graphql?.()`, `sdk.fetch?.()`.
 - Apply the `@optional` directive to all record fields for field-level security resilience.
-- Verify field and object names via `scripts/graphql-search.sh` before writing queries.
+- Verify every entity and field against the org **before** writing queries, following the grounding workflow in the `experience-ui-bundle-salesforce-data-access` skill (it grounds against the **live org**, so a missing local `schema.graphql` is never a reason to guess field names or proceed un-grounded). Never guess; never stub or hand-edit generated types to make a build pass.
 - Use `__SF_API_VERSION__` global for API version in REST calls.
 - **Blocked APIs:** Enterprise REST query endpoint (`/query` with SOQL), `@AuraEnabled` Apex, Chatter API.
 
@@ -173,7 +175,9 @@ Any endpoint not listed above is not permitted.
 
 #### GraphQL non-negotiable rules
 
-1. **Schema is the single source of truth** — every entity and field name must be confirmed via the schema search script before use. Never guess.
+These mirror the `experience-ui-bundle-salesforce-data-access` skill; the **skill is authoritative** and covers them in full (plus grounding, `value`/`displayValue` wrappers, and the primed-vs-degraded behavior). If anything here conflicts with the skill, follow the skill.
+
+1. **Schema is the single source of truth** — every entity and field name must be confirmed against the org (per the skill's grounding workflow) before use. Never guess.
 2. **`@optional` on all record fields** — FLS causes entire queries to fail if any field is inaccessible. Apply to every scalar, parent, and child relationship field.
 3. **Correct mutation syntax** — mutations wrap under `uiapi(input: { allOrNone: true/false })`, not bare `uiapi { ... }`.
 4. **Explicit `first:` in every query** — omitting it silently defaults to 10 records. Always include `pageInfo { hasNextPage endCursor }` for paginated queries.
@@ -186,14 +190,17 @@ Must use the `gql` template tag from `@salesforce/platform-sdk` — plain templa
 #### Current user info
 Use GraphQL (`uiapi { currentUser { Id Name { value } } }`), not Chatter (`/chatter/users/me`).
 
-#### Schema file (`schema.graphql`)
+#### Grounding & the schema file (`schema.graphql`)
+
+Ground entity/field names by following the **`experience-ui-bundle-salesforce-data-access` skill** — it queries the **live org** directly, so you do not need a local `schema.graphql` present to verify a name. A missing `schema.graphql` is **not** a blocker and **never** a reason to guess fields, stub types, or proceed un-grounded.
+
+`schema.graphql`, when present, is a 265K+ line generated mirror — **never open, parse, or edit it directly**, and never hand-edit the codegen output (`graphql-operations-types.ts`). It is regenerated, not authored.
 
-The `schema.graphql` file at the SFDX project root is the source of truth for all entity and field name lookups. It is 265K+ lines — never open or parse it directly. Use the schema search script instead.
+**When `graphql:codegen` or `@graphql-eslint` errors with `Cannot query field/type X` and the message points at `schema.graphql`, the *operation* is wrong or the type isn't accessible — never edit `schema.graphql` to make the validator pass.** Hand-adding a missing type grants no org access; it only hides the failure until runtime. Re-ground the field and fix the operation, or — if the type genuinely belongs in the org — deploy the metadata + assign perms, then regenerate with `npm run graphql:schema`.   
 
-- **Generate/refresh:** Run `npm run graphql:schema` from the UI bundle directory
-- **When to regenerate:** After any metadata deployment that changes objects, fields, or permission sets
-- **Custom objects** only appear in the schema after metadata deployment AND permission set assignment
-- **After regenerating:** Always re-run `npm run graphql:codegen` and `npm run build` (schema changes may affect generated types)
+- **`npm run graphql:schema` / `npm run graphql:codegen`** to fetch the schema / generate types, but they are **not** the grounding step and are not a prerequisite for verifying names.
+- **Custom objects** only appear after metadata deployment AND permission set assignment.
+- **After a deploy that changes objects/fields/permissions:** re-fetch, re-run codegen, and `npm run build`.
 
 ### CSP trusted sites
 

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [11.4.6](https://github.com/salesforce-experience-platform-emu/webapps/compare/v11.4.5...v11.4.6) (2026-07-01)
+
+
+### Bug Fixes
+
+* **sfdx:** point agents to the 'experience-ui-bundle-salesforce-data-access' skill ([#664](https://github.com/salesforce-experience-platform-emu/webapps/issues/664)) ([a344d0f](https://github.com/salesforce-experience-platform-emu/webapps/commit/a344d0f6042602cc0732ca49adb2e04b19118540))
+
+
+
 ## [11.4.5](https://github.com/salesforce-experience-platform-emu/webapps/compare/v11.4.4...v11.4.5) (2026-07-01)
 
 **Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "11.4.5",
+  "version": "11.4.6",
   "description": "Base SFDX project template",
   "license": "SEE LICENSE IN LICENSE.txt",
   "publishConfig": {