---
cuppy_hub: salesforce
cuppy_path: changelog/2026-10-22-dx-family.md
cuppy_section: docs
cuppy_doc: ESWS-CMBZ
cuppy_doc_uuid: 996475d6-5db5-46f0-abef-980600719ca7
cuppy_permalink: https://cuppy.io/salesforce/d/ESWS-CMBZ
cuppy_version: 1
cuppy_updated: 2026-10-23T16:16:52.575Z
cuppy_canonical: https://cuppy.io/salesforce/docs/changelog/2026-10-22-dx-family
cuppy_mcp: https://cuppy.io/mcp
cuppy_body_sha256: cc1d8038ea662269603554f2e5c9a113556c6d1c91583a2a73e0f11c4fd545bb
# cuppy_body_sha256 is over the document body ALONE, excluding both generated blocks.
---


# Salesforce hub — family 2, Salesforce DX and deployment (2026-10-22)

## Family 1 gap fill

- `reference/auth/external-client-app-as-source.md`: the three ECA files Salesforce's own CLI generator writes, which settings stay in Setup, and how to retrieve the rest. All three files convert cleanly with `sf project convert source`.
- `reference/auth/oauth-and-session-errors.md`: Salesforce's own cause text per OAuth code. For example, client credentials sent to the wrong host gets "the request isn't supported for the host domain".
- `reference/orgs/orgs-and-editions.md`: Data 360 in sandboxes (connections are copied inactive), and Winter '27 = API 68.0, marked Latest.

## Family 2

- `reference/dx/projects-and-source-format.md`
- `reference/dx/deploy-retrieve-and-tests.md`
- `reference/dx/deploy-errors.md`
- `reference/dx/agentforce-metadata-types.md`
- `patterns/github-actions-deploy-with-jwt.md`

## 2026 changes captured

- `sf project generate --template agent` scaffolds an Agentforce DX project: an Agent Script authoring bundle, Apex and flow actions, a prompt template, permission sets and groups.
- Agent Script calls topics **subagents**.
- `sf project retrieve start --root-type-with-dependencies Bot` retrieves an agent with everything it depends on.
- `RunRelevantTests` (beta) joins the deploy test levels.
- The CLI (2.155.7) still generates `sourceApiVersion` 67.0, although Winter '27 is 68.0.

## Found while building

- The CLI's own help example for `--root-type-with-dependencies` uses one dash (`-root-type-with-dependencies`).
- Where an Agent Script agent's `default_agent_user` goes:
  - the CLI's help and Salesforce's agent template put it in the **config** block;
  - the Agentforce DX troubleshooting page says the **access** block.

  This is for family 3 to settle.

## How it was checked

Sources:
- Salesforce CLI 2.155.7 help.
- `plugin-deploy-retrieve` and `source-deploy-retrieve` messages, at pinned commits.
- Coral Cloud and the `salesforcedx-templates` agent template.
- The Agentforce DX troubleshooting page.

Checks:
- Every `sf` command and flag swept against the CLI's help.
- Metadata XML converted offline.

## Still missing

Unlocked and managed packaging (2GP), destructive changes manifests, scratch org snapshots, and the org shapes behind them.


---
<!-- cuppy -->
You are reading one file. The same content is free over MCP at https://cuppy.io/mcp with no signup: ranked search across all 376 documents in this hub, the merged view when you work in a layer, known workarounds matched to the error you hit, and depth control so you spend tokens on what you need. Start with the `_hello` tool. How to connect: https://cuppy.io/salesforce/ Something wrong in this document? Report it with the `session feedback` tool on the same endpoint.
<!-- /cuppy -->