Next Release: changelog and version packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and publish to npm yourself or setup this action to publish automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@salesforce/b2c-cli@2.4.0

Minor Changes

• #715 285bd55 - Detect AI coding agents (Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, OpenCode, and others). Under an agent, b2c --help adds guidance for finding commands and docs, and interactive confirmations fail fast with a hint to pass --force/--yes instead of waiting for input. The same fail-fast behavior applies whenever no interactive terminal is available, so confirmations can no longer be answered by piping input (use --force/--yes). Set SFCC_AGENT=0 to opt out of detection, or SFCC_AGENT=1 to opt in. (Thanks @clavery!)

• #715 285bd55 - Add b2c commands search <query> to find the CLI command for a task by keyword (for example b2c commands search "reset sandbox" --json). It complements b2c docs search, which searches documentation. The SDK exports CommandSearchIndex from @salesforce/b2c-tooling-sdk/cli. (Thanks @clavery!)

• #715 285bd55 - Add b2c docs skill to list, search, and read the agent skills bundled with the CLI, no plugin install required. Pass a skill, topic, or command (e.g. b2c docs skill code deploy); topic and command help now point to the covering skill. (Thanks @clavery!)

• #737 78df45a - Added --dotenv-file / SFCC_DOTENV_FILE to use another env file (such as .env.staging) instead of .env. An empty --dotenv-file "" or --config "" now means no env file or no dw.json. With --project-directory, the .env is now read from that directory instead of the current one. (Thanks @clavery!)

• #737 78df45a - Fixed an explicit --config / SFCC_CONFIG path (or MCP configPath) also pulling in instances from the global default dw.json; the explicit file is now used on its own, and a missing file is reported. If you relied on instances from the global file, remove the explicit path or add those instances to the explicit file. (Thanks @clavery!)

• #734 bea5bdc - The default --mrt-backend is now legacy (the MRT Cloud API) instead of auto. MRT commands no longer auto-detect and prefer the SCAPI backend unless you opt in. To restore the previous behavior — prefer SCAPI when short code, tenant ID, and client-credentials/JWT Bearer auth are configured, otherwise fall back to legacy — pass --mrt-backend auto (or set MRT_BACKEND=auto / mrtBackend in dw.json). Use --mrt-backend scapi to require SCAPI with no fallback. (Thanks @kieran-sf!)

Patch Changes

• #731 f692182 - Documentation search now includes the B2C Commerce Solutions guides (bot management, caching strategies, flash-sale traffic, and industry solutions) in a new commerce-solutions category. (Thanks @clavery!)

• #737 78df45a - Storefront Next variables (PUBLIC__app__*, COMMERCE_API_SLAS_SECRET) now only fill settings missing from the selected dw.json instance, so -i <instance> keeps that instance's tenant, short code, site, and SLAS client. A higher-priority source (such as an env file SFCC_SERVER or a config plugin) with a different hostname now skips lower-priority sources instead of mixing settings from both. SDK users reading Storefront Next variables through EnvSource should add StorefrontNextEnvSource after dw.json. (Thanks @clavery!)

• Updated dependencies [285bd55, 285bd55, 285bd55, f692182, 285bd55, 78df45a, 285bd55, 78df45a, f692182, 5220490, bea5bdc, 78df45a, 9cca45e, 78df45a]:

  • @salesforce/b2c-tooling-sdk@2.4.0

@salesforce/b2c-dx-mcp@3.3.0

Minor Changes

• #737 78df45a - Added --dotenv-file / SFCC_DOTENV_FILE to use another env file (such as .env.staging) instead of .env. An empty --dotenv-file "" or --config "" now means no env file or no dw.json. With --project-directory, the .env is now read from that directory instead of the current one. (Thanks @clavery!)

• #737 78df45a - Fixed an explicit --config / SFCC_CONFIG path (or MCP configPath) also pulling in instances from the global default dw.json; the explicit file is now used on its own, and a missing file is reported. If you relied on instances from the global file, remove the explicit path or add those instances to the explicit file. (Thanks @clavery!)

• #733 5220490 - Add --scapi-schemas (SFCC_SCAPI_SCHEMAS) so SCAPI code mode can use local OpenAPI contracts for beta and pre-release APIs. A local contract replaces the bundled or live contract for the same API, or adds a new one. (Thanks @clavery!)

• #731 f692182 - Assistants that support the MCP Skills extension can now list and load the server's skills directly. MCP skills are renamed with a b2c-mcp- prefix (for example skill://mcp/b2c-mcp-scapi/SKILL.md), and the server skill now opens with an index of which skill covers each task. (Thanks @clavery!)

Patch Changes

• #731 f692182 - Documentation search now includes the B2C Commerce Solutions guides (bot management, caching strategies, flash-sale traffic, and industry solutions) in a new commerce-solutions category. (Thanks @clavery!)

• #730 9cca45e - Agents asking what's needed before a first cartridge deploy are now pointed to the configuration and authentication guidance, instead of answering from general knowledge. (Thanks @clavery!)

• #730 9cca45e - Agents now read the SCAPI and CIP skills before calling scapi_search, scapi_execute or cip_query, instead of being rejected and retrying. skillRead is now a required argument, and the SCAPI tool descriptions are shorter, with code-mode details moved into the SCAPI skill. (Thanks @clavery!)

• Updated dependencies [285bd55, 285bd55, 78df45a, 86d42bc, 285bd55, f692182, 285bd55, 78df45a, 285bd55, 78df45a, f692182, 5220490, bea5bdc, 78df45a, 9cca45e, f692182, 78df45a, 1c73738]:

  • @salesforce/b2c-tooling-sdk@2.4.0
  • @salesforce/b2c-agent-plugins@1.11.0

@salesforce/b2c-tooling-sdk@2.4.0

Minor Changes

• #715 285bd55 - Detect AI coding agents (Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, OpenCode, and others). Under an agent, b2c --help adds guidance for finding commands and docs, and interactive confirmations fail fast with a hint to pass --force/--yes instead of waiting for input. The same fail-fast behavior applies whenever no interactive terminal is available, so confirmations can no longer be answered by piping input (use --force/--yes). Set SFCC_AGENT=0 to opt out of detection, or SFCC_AGENT=1 to opt in. (Thanks @clavery!)

• #715 285bd55 - Anonymous usage telemetry and the HTTP User-Agent now identify the detected AI agent, so agent-driven usage can be measured. Agent session IDs are never sent; only a one-way hash groups commands from the same session. (Thanks @clavery!)

• #715 285bd55 - Add b2c commands search <query> to find the CLI command for a task by keyword (for example b2c commands search "reset sandbox" --json). It complements b2c docs search, which searches documentation. The SDK exports CommandSearchIndex from @salesforce/b2c-tooling-sdk/cli. (Thanks @clavery!)

• #731 f692182 - Documentation search now includes the B2C Commerce Solutions guides (bot management, caching strategies, flash-sale traffic, and industry solutions) in a new commerce-solutions category. (Thanks @clavery!)

• #715 285bd55 - Add b2c docs skill to list, search, and read the agent skills bundled with the CLI, no plugin install required. Pass a skill, topic, or command (e.g. b2c docs skill code deploy); topic and command help now point to the covering skill. (Thanks @clavery!)

• #737 78df45a - Added --dotenv-file / SFCC_DOTENV_FILE to use another env file (such as .env.staging) instead of .env. An empty --dotenv-file "" or --config "" now means no env file or no dw.json. With --project-directory, the .env is now read from that directory instead of the current one. (Thanks @clavery!)

• #715 285bd55 - Publish a JSON Schema for dw.json, which gives editors completion, hover descriptions, and validation. The VS Code extension applies it to every dw.json. In other editors, reference https://salesforcecommercecloud.github.io/b2c-developer-tooling/schemas/dw.schema.json as "$schema". The schema also ships with the SDK as @salesforce/b2c-tooling-sdk/schemas/dw.schema.json. (Thanks @clavery!)

• #737 78df45a - Fixed an explicit --config / SFCC_CONFIG path (or MCP configPath) also pulling in instances from the global default dw.json; the explicit file is now used on its own, and a missing file is reported. If you relied on instances from the global file, remove the explicit path or add those instances to the explicit file. (Thanks @clavery!)

• #731 f692182 - The guidance catalog exposes skill metadata (verbatim frontmatter and per-file digests) through new skills() and skill(uri) methods. (Thanks @clavery!)

• #733 5220490 - Add --scapi-schemas (SFCC_SCAPI_SCHEMAS) so SCAPI code mode can use local OpenAPI contracts for beta and pre-release APIs. A local contract replaces the bundled or live contract for the same API, or adds a new one. (Thanks @clavery!)

• #734 bea5bdc - The default --mrt-backend is now legacy (the MRT Cloud API) instead of auto. MRT commands no longer auto-detect and prefer the SCAPI backend unless you opt in. To restore the previous behavior — prefer SCAPI when short code, tenant ID, and client-credentials/JWT Bearer auth are configured, otherwise fall back to legacy — pass --mrt-backend auto (or set MRT_BACKEND=auto / mrtBackend in dw.json). Use --mrt-backend scapi to require SCAPI with no fallback. (Thanks @kieran-sf!)

Patch Changes

• #737 78df45a - Tenant/organization IDs are now automatically derived from sandbox patterns (abcd-001.dx.commercecloud.salesforce.com → abcd_001) when not configured, with a warning when a configured tenant ID doesn't match. Conversely, a sandbox tenant ID with no hostname now derives the hostname, so a Storefront Next project targeting a sandbox works without SFCC_SERVER. Sandboxes configured with only a short code can now use SCAPI when apiBackend is auto. normalizeTenantId() now only extracts tenants from sandbox hostnames and returns other dotted values unchanged. (Thanks @clavery!)

• #730 9cca45e - SCAPI code mode now accepts code that ends with a semicolon or a trailing line comment, instead of failing with a syntax error. (Thanks @clavery!)

• #737 78df45a - Storefront Next variables (PUBLIC__app__*, COMMERCE_API_SLAS_SECRET) now only fill settings missing from the selected dw.json instance, so -i <instance> keeps that instance's tenant, short code, site, and SLAS client. A higher-priority source (such as an env file SFCC_SERVER or a config plugin) with a different hostname now skips lower-priority sources instead of mixing settings from both. SDK users reading Storefront Next variables through EnvSource should add StorefrontNextEnvSource after dw.json. (Thanks @clavery!)

b2c-vs-extension@1.4.0

Minor Changes

• #715 285bd55 - Publish a JSON Schema for dw.json, which gives editors completion, hover descriptions, and validation. The VS Code extension applies it to every dw.json. In other editors, reference https://salesforcecommercecloud.github.io/b2c-developer-tooling/schemas/dw.schema.json as "$schema". The schema also ships with the SDK as @salesforce/b2c-tooling-sdk/schemas/dw.schema.json. (Thanks @clavery!)

• #737 78df45a - The status bar now shows the instance actually in use and warns when env variables override it. The instance picker adds None, unnamed dw.json entries, an Env File section for choosing .env or a .env.* file, and Inspect Resolved Config at the top. A workspace instance selected from a file that is no longer the global default is now dropped, and the workspace follows the default again. (Thanks @clavery!)

• #737 78df45a - B2C DX: Inspect Resolved Config now shows the extension's own resolved configuration, including the selected instance and env file, where each value comes from, and which values were not used and why. It no longer requires the CLI or the onboarding feature flag. (Thanks @clavery!)

Patch Changes

• #737 78df45a - Storefront Next variables (PUBLIC__app__*, COMMERCE_API_SLAS_SECRET) now only fill settings missing from the selected dw.json instance, so -i <instance> keeps that instance's tenant, short code, site, and SLAS client. A higher-priority source (such as an env file SFCC_SERVER or a config plugin) with a different hostname now skips lower-priority sources instead of mixing settings from both. SDK users reading Storefront Next variables through EnvSource should add StorefrontNextEnvSource after dw.json. (Thanks @clavery!)

• #737 78df45a - Code Sync no longer retries failed uploads every 5 seconds forever. Authentication failures (401/403) pause sync with a single warning until the next save or Retry, other failures back off up to 5 minutes, and failed deletes are no longer dropped. After a configuration change (such as fixing credentials in .env), changes that failed are retried with the new configuration. (Thanks @clavery!)

• Updated dependencies [285bd55, 285bd55, 285bd55, f692182, 285bd55, 78df45a, 285bd55, 78df45a, f692182, 5220490, bea5bdc, 78df45a, 9cca45e, 78df45a]:

  • @salesforce/b2c-tooling-sdk@2.4.0

@salesforce/b2c-agent-plugins@1.11.0

Minor Changes

• #738 1c73738 - The storefront-next and figma-to-sfnext-pagedesigner skills are updated for the October 2026 Storefront Next template. Code examples, commands, and project paths are corrected, and new skills cover security, SEO, analytics and consent, accessibility, quality gates, revalidation, and commerce features (24 skills). Skills were renamed or merged: sfnext-create-vertical → sfnext-theming, sfnext-create-component → sfnext-components, and sfnext-scapi-management + sfnext-custom-apis → sfnext-scapi. (Thanks @clavery!)

Patch Changes

• #737 78df45a - Updated the b2c-config skill for env file selection and Storefront Next fallback precedence. (Thanks @clavery!)

• #739 86d42bc - The b2c-content skill now points to b2c-cli:b2c-config for authentication setup instead of a skill that doesn't exist. (Thanks @clavery!)

• #731 f692182 - Documentation search now includes the B2C Commerce Solutions guides (bot management, caching strategies, flash-sale traffic, and industry solutions) in a new commerce-solutions category. (Thanks @clavery!)

• #715 285bd55 - Add b2c docs skill to list, search, and read the agent skills bundled with the CLI, no plugin install required. Pass a skill, topic, or command (e.g. b2c docs skill code deploy); topic and command help now point to the covering skill. (Thanks @clavery!)

• #734 bea5bdc - The default --mrt-backend is now legacy (the MRT Cloud API) instead of auto. MRT commands no longer auto-detect and prefer the SCAPI backend unless you opt in. To restore the previous behavior — prefer SCAPI when short code, tenant ID, and client-credentials/JWT Bearer auth are configured, otherwise fall back to legacy — pass --mrt-backend auto (or set MRT_BACKEND=auto / mrtBackend in dw.json). Use --mrt-backend scapi to require SCAPI with no fallback. (Thanks @kieran-sf!)

• #731 f692182 - Skills now refer to each other by name instead of relative paths, so links work wherever a skill is installed. Documentation links point to Markdown pages and include the b2c docs read ID for offline reading. (Thanks @clavery!)

@salesforce/b2c-dx-docs@0.4.5

Patch Changes

• #715 285bd55 - Publish a JSON Schema for dw.json, which gives editors completion, hover descriptions, and validation. The VS Code extension applies it to every dw.json. In other editors, reference https://salesforcecommercecloud.github.io/b2c-developer-tooling/schemas/dw.schema.json as "$schema". The schema also ships with the SDK as @salesforce/b2c-tooling-sdk/schemas/dw.schema.json. (Thanks @clavery!)

• #738 1c73738 - The storefront-next and figma-to-sfnext-pagedesigner skills are updated for the October 2026 Storefront Next template. Code examples, commands, and project paths are corrected, and new skills cover security, SEO, analytics and consent, accessibility, quality gates, revalidation, and commerce features (24 skills). Skills were renamed or merged: sfnext-create-vertical → sfnext-theming, sfnext-create-component → sfnext-components, and sfnext-scapi-management + sfnext-custom-apis → sfnext-scapi. (Thanks @clavery!)

[github-actions]

📘 Docs preview

🧹 The preview for this PR has been removed (PR closed).