@salesforce/b2c-dx-mcp 3.2.1 → 3.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/run.js +5 -9
- package/content/guidance/b2c/b2c-hooks/references/ORDER-HOOK-LIFECYCLE.md +1 -1
- package/content/guidance/b2c/b2c-onboarding/SKILL.md +4 -4
- package/content/guidance/b2c/b2c-ordering/SKILL.md +2 -2
- package/content/guidance/b2c/b2c-querying-data/SKILL.md +2 -2
- package/content/guidance/b2c/b2c-scapi-admin/SKILL.md +3 -3
- package/content/guidance/b2c/b2c-scapi-admin/references/CLIENT-EXAMPLES.md +4 -4
- package/content/guidance/b2c/b2c-scapi-shopper/SKILL.md +6 -6
- package/content/guidance/b2c/b2c-scapi-shopper/references/CLIENT-EXAMPLES.md +8 -9
- package/content/guidance/b2c-cli/b2c-cip/SKILL.md +3 -3
- package/content/guidance/b2c-cli/b2c-cip/references/SALES_ANALYSIS.md +1 -1
- package/content/guidance/b2c-cli/b2c-config/SKILL.md +54 -25
- package/content/guidance/b2c-cli/b2c-content/SKILL.md +1 -1
- package/content/guidance/b2c-cli/b2c-debug/SKILL.md +1 -1
- package/content/guidance/b2c-cli/b2c-docs/SKILL.md +23 -2
- package/content/guidance/b2c-cli/b2c-ecdn/SKILL.md +2 -0
- package/content/guidance/b2c-cli/b2c-ecdn/references/ADVANCED.md +1 -1
- package/content/guidance/b2c-cli/b2c-job/SKILL.md +9 -3
- package/content/guidance/b2c-cli/b2c-job/references/IMPORT.md +1 -1
- package/content/guidance/b2c-cli/b2c-job/references/RUN-AND-MONITOR.md +35 -6
- package/content/guidance/b2c-cli/b2c-metrics/SKILL.md +1 -1
- package/content/guidance/b2c-cli/b2c-mrt/SKILL.md +3 -3
- package/content/guidance/b2c-cli/b2c-scapi-custom/SKILL.md +1 -1
- package/content/guidance/b2c-cli/b2c-scapi-schemas/SKILL.md +6 -2
- package/content/guidance/b2c-cli/b2c-site-import-export/SKILL.md +1 -1
- package/content/guidance/b2c-cli/b2c-sites/SKILL.md +1 -1
- package/content/guidance/b2c-cli/b2c-slas/SKILL.md +1 -1
- package/content/guidance/b2c-ops/b2c-checkout-triage/SKILL.md +2 -2
- package/content/guidance/b2c-ops/b2c-edge-traffic-triage/SKILL.md +69 -0
- package/content/guidance/b2c-ops/b2c-job-health/SKILL.md +13 -8
- package/content/guidance/b2c-ops/b2c-order-failure-triage/SKILL.md +1 -1
- package/content/guidance/b2c-ops/b2c-order-failure-triage/references/order-evidence.md +2 -2
- package/content/guidance/b2c-ops/b2c-production-triage/SKILL.md +5 -4
- package/content/guidance/index.json +981 -259
- package/content/guidance/mcp/{cip → b2c-mcp-cip}/SKILL.md +10 -8
- package/content/guidance/mcp/{b2c-config → b2c-mcp-config}/SKILL.md +10 -9
- package/content/guidance/mcp/{debugger → b2c-mcp-debugger}/SKILL.md +9 -8
- package/content/guidance/mcp/b2c-mcp-scapi/SKILL.md +98 -0
- package/content/guidance/mcp/b2c-mcp-scapi/references/authentication.md +34 -0
- package/content/guidance/mcp/b2c-mcp-scapi/references/compose-verify.md +25 -0
- package/content/guidance/mcp/b2c-mcp-scapi/references/confirmation.md +30 -0
- package/content/guidance/mcp/b2c-mcp-scapi/references/discover.md +94 -0
- package/content/guidance/mcp/b2c-mcp-scapi/references/jobs.md +72 -0
- package/content/guidance/mcp/b2c-mcp-scapi/references/workflows.md +28 -0
- package/content/guidance/mcp/{server → b2c-mcp-server}/SKILL.md +52 -25
- package/content/guidance/storefront-next/sfnext-accessibility/SKILL.md +103 -0
- package/content/guidance/storefront-next/sfnext-accessibility/references/checklist.md +64 -0
- package/content/guidance/storefront-next/sfnext-analytics-consent/SKILL.md +91 -0
- package/content/guidance/storefront-next/sfnext-analytics-consent/references/CUSTOM-ADAPTER.md +49 -0
- package/content/guidance/storefront-next/sfnext-authentication/SKILL.md +86 -79
- package/content/guidance/storefront-next/sfnext-authentication/references/COOKIES.md +39 -0
- package/content/guidance/storefront-next/sfnext-authentication/references/LOGIN-FLOWS.md +59 -0
- package/content/guidance/storefront-next/sfnext-commerce-features/SKILL.md +67 -0
- package/content/guidance/storefront-next/sfnext-commerce-features/references/FEATURE-PREREQUISITES.md +37 -0
- package/content/guidance/storefront-next/sfnext-components/SKILL.md +98 -136
- package/content/guidance/storefront-next/sfnext-components/references/COMPONENT-AUTHORING.md +118 -0
- package/content/guidance/storefront-next/sfnext-components/references/SHAPE-TOKENS.md +51 -0
- package/content/guidance/storefront-next/sfnext-components/references/STORYBOOK.md +54 -0
- package/content/guidance/storefront-next/sfnext-components/references/TOKEN-SYSTEM.md +53 -0
- package/content/guidance/storefront-next/sfnext-components/references/TROUBLESHOOTING.md +19 -0
- package/content/guidance/storefront-next/sfnext-configuration/SKILL.md +116 -113
- package/content/guidance/storefront-next/sfnext-configuration/references/ENV-VARIABLES.md +55 -0
- package/content/guidance/storefront-next/sfnext-configuration/references/MULTI-SITE-URLS.md +137 -0
- package/content/guidance/storefront-next/sfnext-data-fetching/SKILL.md +100 -150
- package/content/guidance/storefront-next/sfnext-data-fetching/references/ACTIONS.md +53 -0
- package/content/guidance/storefront-next/sfnext-data-fetching/references/API-CLIENTS.md +34 -0
- package/content/guidance/storefront-next/sfnext-data-fetching/references/LOADERS.md +73 -0
- package/content/guidance/storefront-next/sfnext-data-fetching/references/SCAPI-FETCHER.md +23 -77
- package/content/guidance/storefront-next/sfnext-deployment/SKILL.md +83 -97
- package/content/guidance/storefront-next/sfnext-deployment/references/MRT-DEPLOYMENT.md +37 -68
- package/content/guidance/storefront-next/sfnext-extensions/SKILL.md +73 -97
- package/content/guidance/storefront-next/sfnext-extensions/references/ACTION-HOOKS.md +57 -0
- package/content/guidance/storefront-next/sfnext-extensions/references/BASE-AUDIT.md +47 -44
- package/content/guidance/storefront-next/sfnext-extensions/references/CLI-AND-INSTALL.md +58 -0
- package/content/guidance/storefront-next/sfnext-extensions/references/EXTENSION-EXAMPLES.md +49 -86
- package/content/guidance/storefront-next/sfnext-hybrid-storefronts/SKILL.md +59 -114
- package/content/guidance/storefront-next/sfnext-hybrid-storefronts/references/HYBRID-PROXY-CONFIG.md +53 -90
- package/content/guidance/storefront-next/sfnext-i18n/SKILL.md +96 -131
- package/content/guidance/storefront-next/sfnext-i18n/references/locale-config.md +35 -0
- package/content/guidance/storefront-next/sfnext-overview/SKILL.md +101 -0
- package/content/guidance/storefront-next/sfnext-page-designer/SKILL.md +152 -131
- package/content/guidance/storefront-next/sfnext-page-designer/references/BUSINESS-MANAGER.md +46 -0
- package/content/guidance/storefront-next/sfnext-page-designer/references/COMPONENT-REGISTRY.md +86 -53
- package/content/guidance/storefront-next/sfnext-page-designer/references/DECORATOR-PATTERNS.md +119 -131
- package/content/guidance/storefront-next/sfnext-page-designer/references/REVIEW-CHECKLIST.md +83 -0
- package/content/guidance/storefront-next/sfnext-page-designer/references/TROUBLESHOOTING.md +35 -0
- package/content/guidance/storefront-next/sfnext-performance/SKILL.md +75 -105
- package/content/guidance/storefront-next/sfnext-performance/references/PERFORMANCE-REVIEW-CHECKLIST.md +85 -0
- package/content/guidance/storefront-next/sfnext-performance/references/SUSPENSE-AND-STREAMING.md +58 -0
- package/content/guidance/storefront-next/sfnext-project-setup/SKILL.md +103 -116
- package/content/guidance/storefront-next/sfnext-project-setup/references/PROJECT-STRUCTURE.md +61 -99
- package/content/guidance/storefront-next/sfnext-project-setup/references/SCRIPTS.md +47 -0
- package/content/guidance/storefront-next/sfnext-project-setup/references/SFNEXT-CLI.md +63 -0
- package/content/guidance/storefront-next/sfnext-quality-gates/SKILL.md +70 -0
- package/content/guidance/storefront-next/sfnext-quality-gates/references/lint-and-budgets.md +39 -0
- package/content/guidance/storefront-next/sfnext-revalidation/SKILL.md +121 -0
- package/content/guidance/storefront-next/sfnext-revalidation/references/POLICIES-AND-TAGS.md +55 -0
- package/content/guidance/storefront-next/sfnext-routing/SKILL.md +86 -143
- package/content/guidance/storefront-next/sfnext-routing/references/ROUTE-CONVENTIONS.md +51 -51
- package/content/guidance/storefront-next/sfnext-routing/references/URLS-AND-SEO-ROUTES.md +22 -0
- package/content/guidance/storefront-next/sfnext-scapi/SKILL.md +126 -0
- package/content/guidance/storefront-next/sfnext-scapi/references/WORKED-EXAMPLE.md +39 -0
- package/content/guidance/storefront-next/sfnext-security/SKILL.md +129 -0
- package/content/guidance/storefront-next/sfnext-security/references/COOKIE-DOMAIN.md +39 -0
- package/content/guidance/storefront-next/sfnext-security/references/TURNSTILE.md +43 -0
- package/content/guidance/storefront-next/sfnext-seo/SKILL.md +95 -0
- package/content/guidance/storefront-next/sfnext-seo/references/MULTI-DOMAIN-BASE-PATH.md +17 -0
- package/content/guidance/storefront-next/sfnext-seo/references/SEO-ROUTES.md +31 -0
- package/content/guidance/storefront-next/sfnext-state-management/SKILL.md +80 -89
- package/content/guidance/storefront-next/sfnext-state-management/references/PATTERNS.md +45 -0
- package/content/guidance/storefront-next/sfnext-testing/SKILL.md +105 -138
- package/content/guidance/storefront-next/sfnext-testing/references/E2E.md +38 -0
- package/content/guidance/storefront-next/sfnext-testing/references/STORYBOOK-PATTERNS.md +73 -94
- package/content/guidance/storefront-next/sfnext-testing/references/UNIT-AND-ROUTE-TESTS.md +60 -0
- package/content/guidance/storefront-next/sfnext-theming/SKILL.md +104 -0
- package/content/guidance/storefront-next/sfnext-theming/references/REBRAND-CHECKLIST.md +29 -0
- package/dist/commands/mcp.d.ts +8 -2
- package/dist/commands/mcp.js +54 -20
- package/dist/guidance.d.ts +4 -1
- package/dist/guidance.js +23 -5
- package/dist/registry.d.ts +2 -1
- package/dist/registry.js +3 -3
- package/dist/server.d.ts +10 -0
- package/dist/server.js +21 -0
- package/dist/skill-references.js +5 -5
- package/dist/tools/cartridges/index.js +1 -0
- package/dist/tools/cip/index.js +6 -3
- package/dist/tools/diagnostics/debug-capture-at-breakpoint.js +1 -1
- package/dist/tools/diagnostics/debug-set-breakpoints.js +1 -1
- package/dist/tools/diagnostics/debug-start-session.js +1 -1
- package/dist/tools/docs/docs-read.js +4 -2
- package/dist/tools/docs/docs-search.js +10 -8
- package/dist/tools/docs/topics.d.ts +5 -0
- package/dist/tools/docs/topics.js +5 -0
- package/dist/tools/scapi/index.d.ts +4 -1
- package/dist/tools/scapi/index.js +4 -2
- package/dist/tools/scapi/scapi-code.d.ts +2 -2
- package/dist/tools/scapi/scapi-code.js +106 -81
- package/dist/tools/scapi/scapi-schemas-list.js +93 -56
- package/dist/utils/types.d.ts +6 -0
- package/node_modules/@salesforce/b2c-agent-plugins/CHANGELOG.md +32 -0
- package/node_modules/@salesforce/b2c-agent-plugins/README.md +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/.codex-plugin/plugin.json +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/plugin.json +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-hooks/references/ORDER-HOOK-LIFECYCLE.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-onboarding/SKILL.md +4 -4
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-ordering/SKILL.md +2 -2
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-querying-data/SKILL.md +2 -2
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-scapi-admin/SKILL.md +3 -3
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-scapi-admin/references/CLIENT-EXAMPLES.md +4 -4
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-scapi-shopper/SKILL.md +6 -6
- package/node_modules/@salesforce/b2c-agent-plugins/b2c/skills/b2c-scapi-shopper/references/CLIENT-EXAMPLES.md +8 -9
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/.codex-plugin/plugin.json +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/plugin.json +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-cip/SKILL.md +3 -3
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-cip/references/SALES_ANALYSIS.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-config/SKILL.md +54 -25
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-content/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-debug/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-docs/SKILL.md +23 -2
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-ecdn/SKILL.md +2 -0
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-ecdn/references/ADVANCED.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-job/SKILL.md +9 -3
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-job/references/IMPORT.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-job/references/RUN-AND-MONITOR.md +35 -6
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-metrics/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-mrt/SKILL.md +3 -3
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-scapi-custom/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-scapi-schemas/SKILL.md +6 -2
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-site-import-export/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-sites/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-cli/skills/b2c-slas/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/.codex-plugin/plugin.json +4 -3
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/README.md +1 -0
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/plugin.json +4 -3
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/skills/b2c-checkout-triage/SKILL.md +2 -2
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/skills/b2c-edge-traffic-triage/SKILL.md +69 -0
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/skills/b2c-job-health/SKILL.md +13 -8
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/skills/b2c-order-failure-triage/SKILL.md +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/skills/b2c-order-failure-triage/references/order-evidence.md +2 -2
- package/node_modules/@salesforce/b2c-agent-plugins/b2c-ops/skills/b2c-production-triage/SKILL.md +5 -4
- package/node_modules/@salesforce/b2c-agent-plugins/figma-to-sfnext-pagedesigner/README.md +4 -4
- package/node_modules/@salesforce/b2c-agent-plugins/figma-to-sfnext-pagedesigner/skills/figma-to-sfnext-pagedesigner/SKILL.md +76 -73
- package/node_modules/@salesforce/b2c-agent-plugins/figma-to-sfnext-pagedesigner/skills/figma-to-sfnext-pagedesigner/evals/trigger-evals.json +12 -10
- package/node_modules/@salesforce/b2c-agent-plugins/figma-to-sfnext-pagedesigner/skills/figma-to-sfnext-pagedesigner/references/PAGE-DESIGNER-SFN.md +49 -74
- package/node_modules/@salesforce/b2c-agent-plugins/package.json +1 -1
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/.codex-plugin/plugin.json +9 -6
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/README.md +43 -22
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/plugin.json +9 -6
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-accessibility/SKILL.md +103 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-accessibility/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-accessibility/references/checklist.md +64 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-analytics-consent/SKILL.md +91 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-analytics-consent/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-analytics-consent/references/CUSTOM-ADAPTER.md +49 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-authentication/SKILL.md +86 -79
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-authentication/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-authentication/references/COOKIES.md +39 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-authentication/references/LOGIN-FLOWS.md +59 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-commerce-features/SKILL.md +67 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-commerce-features/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-commerce-features/references/FEATURE-PREREQUISITES.md +37 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-components/SKILL.md +98 -136
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-components/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-components/references/COMPONENT-AUTHORING.md +118 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-components/references/SHAPE-TOKENS.md +51 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-components/references/STORYBOOK.md +54 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-components/references/TOKEN-SYSTEM.md +53 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-components/references/TROUBLESHOOTING.md +19 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-configuration/SKILL.md +116 -113
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-configuration/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-configuration/references/ENV-VARIABLES.md +55 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-configuration/references/MULTI-SITE-URLS.md +137 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-data-fetching/SKILL.md +100 -150
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-data-fetching/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-data-fetching/references/ACTIONS.md +53 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-data-fetching/references/API-CLIENTS.md +34 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-data-fetching/references/LOADERS.md +73 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-data-fetching/references/SCAPI-FETCHER.md +23 -77
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-deployment/SKILL.md +83 -97
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-deployment/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-deployment/references/MRT-DEPLOYMENT.md +37 -68
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-extensions/SKILL.md +73 -97
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-extensions/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-extensions/references/ACTION-HOOKS.md +57 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-extensions/references/BASE-AUDIT.md +47 -44
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-extensions/references/CLI-AND-INSTALL.md +58 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-extensions/references/EXTENSION-EXAMPLES.md +49 -86
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-hybrid-storefronts/SKILL.md +59 -114
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-hybrid-storefronts/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-hybrid-storefronts/references/HYBRID-PROXY-CONFIG.md +53 -90
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-i18n/SKILL.md +96 -131
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-i18n/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-i18n/references/locale-config.md +35 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-overview/SKILL.md +101 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-overview/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-page-designer/SKILL.md +152 -131
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-page-designer/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-page-designer/references/BUSINESS-MANAGER.md +46 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-page-designer/references/COMPONENT-REGISTRY.md +86 -53
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-page-designer/references/DECORATOR-PATTERNS.md +119 -131
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-page-designer/references/REVIEW-CHECKLIST.md +83 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-page-designer/references/TROUBLESHOOTING.md +35 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-performance/SKILL.md +75 -105
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-performance/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-performance/references/PERFORMANCE-REVIEW-CHECKLIST.md +85 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-performance/references/SUSPENSE-AND-STREAMING.md +58 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-project-setup/SKILL.md +103 -116
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-project-setup/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-project-setup/references/PROJECT-STRUCTURE.md +61 -99
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-project-setup/references/SCRIPTS.md +47 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-project-setup/references/SFNEXT-CLI.md +63 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-quality-gates/SKILL.md +70 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-quality-gates/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-quality-gates/references/lint-and-budgets.md +39 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-revalidation/SKILL.md +121 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-revalidation/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-revalidation/references/POLICIES-AND-TAGS.md +55 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-routing/SKILL.md +86 -143
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-routing/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-routing/references/ROUTE-CONVENTIONS.md +51 -51
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-routing/references/URLS-AND-SEO-ROUTES.md +22 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-scapi/SKILL.md +126 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-scapi/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-scapi/references/WORKED-EXAMPLE.md +39 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-security/SKILL.md +129 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-security/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-security/references/COOKIE-DOMAIN.md +39 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-security/references/TURNSTILE.md +43 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-seo/SKILL.md +95 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-seo/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-seo/references/MULTI-DOMAIN-BASE-PATH.md +17 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-seo/references/SEO-ROUTES.md +31 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-state-management/SKILL.md +80 -89
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-state-management/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-state-management/references/PATTERNS.md +45 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-testing/SKILL.md +105 -138
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-testing/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-testing/references/E2E.md +38 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-testing/references/STORYBOOK-PATTERNS.md +73 -94
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-testing/references/UNIT-AND-ROUTE-TESTS.md +60 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-theming/SKILL.md +104 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-theming/evals/trigger-evals.json +5 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-theming/references/REBRAND-CHECKLIST.md +29 -0
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next-figma/skills/sfnext-create-figma-kit/SKILL.md +3 -3
- package/oclif.manifest.json +21 -4
- package/package.json +4 -4
- package/content/guidance/mcp/scapi/SKILL.md +0 -203
- package/content/guidance/mcp/scapi/references/jobs.md +0 -30
- package/content/guidance/storefront-next/sfnext-create-component/SKILL.md +0 -195
- package/content/guidance/storefront-next/sfnext-create-component/references/COMPONENT-AUTHORING.md +0 -206
- package/content/guidance/storefront-next/sfnext-create-component/references/PROJECT-STRUCTURE.md +0 -43
- package/content/guidance/storefront-next/sfnext-create-component/references/TOKEN-SYSTEM.md +0 -130
- package/content/guidance/storefront-next/sfnext-create-component/references/TROUBLESHOOTING.md +0 -34
- package/content/guidance/storefront-next/sfnext-create-vertical/SKILL.md +0 -135
- package/content/guidance/storefront-next/sfnext-create-vertical/references/COMPONENT-AUTHORING.md +0 -206
- package/content/guidance/storefront-next/sfnext-create-vertical/references/PROJECT-STRUCTURE.md +0 -43
- package/content/guidance/storefront-next/sfnext-create-vertical/references/TOKEN-SYSTEM.md +0 -130
- package/content/guidance/storefront-next/sfnext-create-vertical/references/TROUBLESHOOTING.md +0 -34
- package/content/guidance/storefront-next/sfnext-custom-apis/SKILL.md +0 -221
- package/content/guidance/storefront-next/sfnext-custom-apis/references/WORKFLOW-EXAMPLES.md +0 -294
- package/content/guidance/storefront-next/sfnext-data-fetching/references/LOADER-PATTERNS.md +0 -102
- package/content/guidance/storefront-next/sfnext-project-setup/references/ENV-VARIABLES.md +0 -82
- package/content/guidance/storefront-next/sfnext-scapi-management/SKILL.md +0 -203
- package/content/guidance/storefront-next/sfnext-scapi-management/references/CLI-COMMANDS.md +0 -122
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-component/SKILL.md +0 -195
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-component/evals/trigger-evals.json +0 -12
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-component/references/COMPONENT-AUTHORING.md +0 -206
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-component/references/PROJECT-STRUCTURE.md +0 -43
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-component/references/TOKEN-SYSTEM.md +0 -130
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-component/references/TROUBLESHOOTING.md +0 -34
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-vertical/SKILL.md +0 -135
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-vertical/evals/trigger-evals.json +0 -12
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-vertical/references/COMPONENT-AUTHORING.md +0 -206
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-vertical/references/PROJECT-STRUCTURE.md +0 -43
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-vertical/references/TOKEN-SYSTEM.md +0 -130
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-create-vertical/references/TROUBLESHOOTING.md +0 -34
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-custom-apis/SKILL.md +0 -221
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-custom-apis/evals/trigger-evals.json +0 -12
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-custom-apis/references/WORKFLOW-EXAMPLES.md +0 -294
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-data-fetching/references/LOADER-PATTERNS.md +0 -102
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-project-setup/references/ENV-VARIABLES.md +0 -82
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-scapi-management/SKILL.md +0 -203
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-scapi-management/evals/trigger-evals.json +0 -12
- package/node_modules/@salesforce/b2c-agent-plugins/storefront-next/skills/sfnext-scapi-management/references/CLI-COMMANDS.md +0 -122
- /package/content/guidance/mcp/{scapi → b2c-mcp-scapi}/references/custom-apis.md +0 -0
- /package/content/guidance/mcp/{scapi → b2c-mcp-scapi}/references/custom-properties.md +0 -0
- /package/content/guidance/mcp/{scapi → b2c-mcp-scapi}/references/products.md +0 -0
- /package/content/guidance/mcp/{scapi → b2c-mcp-scapi}/references/promotions.md +0 -0
- /package/content/guidance/mcp/{scapi → b2c-mcp-scapi}/references/saving.md +0 -0
- /package/content/guidance/mcp/{scapi → b2c-mcp-scapi}/references/snippets.md +0 -0
- /package/content/guidance/mcp/{scapi → b2c-mcp-scapi}/references/tokens.md +0 -0
- /package/content/guidance/mcp/{server → b2c-mcp-server}/references/files.md +0 -0
|
@@ -21,17 +21,46 @@ b2c job run my-custom-job --wait --show-log
|
|
|
21
21
|
|
|
22
22
|
### Run System Jobs with Custom Request Bodies
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
System jobs (`sfcc-*`) do **not** take the generic `parameters` array, so `-P` fails
|
|
25
|
+
for them (`unknown property 'parameters'`). Send the job's own document with `--body`
|
|
26
|
+
(`--body` and `-P` are mutually exclusive). The body is the same JSON on SCAPI and
|
|
27
|
+
OCAPI; field names are snake_case and `site_scope` is a plain array of site IDs.
|
|
25
28
|
|
|
26
29
|
```bash
|
|
27
|
-
#
|
|
28
|
-
b2c job run sfcc-search-index-product-full-update --wait --body '{"site_scope":
|
|
30
|
+
# rebuild the product search index for one site
|
|
31
|
+
b2c job run sfcc-search-index-product-full-update --wait --body '{"site_scope":["RefArch"]}'
|
|
29
32
|
|
|
30
|
-
#
|
|
31
|
-
b2c job run sfcc-search-index-product-full-update --wait --body '{"site_scope":
|
|
33
|
+
# several sites
|
|
34
|
+
b2c job run sfcc-search-index-product-full-update --wait --body '{"site_scope":["RefArch","SiteGenesis"]}'
|
|
32
35
|
```
|
|
33
36
|
|
|
34
|
-
|
|
37
|
+
| System job ID | Body |
|
|
38
|
+
| -------------------------------------------------- | --------------------------------------- |
|
|
39
|
+
| `sfcc-search-index-product-full-update` | `{"site_scope":["SiteId"]}` |
|
|
40
|
+
| `sfcc-search-index-product-incremental-update` | `{"site_scope":["SiteId"]}` |
|
|
41
|
+
| `sfcc-search-index-content-full-update` | `{"site_scope":["SiteId"]}` |
|
|
42
|
+
| `sfcc-search-index-content-incremental-update` | `{"site_scope":["SiteId"]}` |
|
|
43
|
+
| `sfcc-search-index-active-data-full-update` | `{"site_scope":["SiteId"]}` |
|
|
44
|
+
| `sfcc-search-index-active-data-incremental-update` | `{"site_scope":["SiteId"]}` |
|
|
45
|
+
| `sfcc-site-archive-import` / `-export` | use `b2c job import` / `b2c job export` |
|
|
46
|
+
|
|
47
|
+
Common mistakes (all wrong): `{"site_scope":{"named_sites":[...]}}` (object, rejected as
|
|
48
|
+
"expected START*ARRAY"), `siteScope`/camelCase, and `-P SiteScope=...`. The
|
|
49
|
+
`SiteScope={"named_sites":[...]}` value is a \_parameter* of custom/standard-step jobs
|
|
50
|
+
run with `-P`, not a system-job body. Source: OCAPI `SearchIndexUpdateConfiguration`
|
|
51
|
+
(`b2c docs read ocapi/searchindexupdateconfiguration`).
|
|
52
|
+
|
|
53
|
+
A `JobAlreadyRunningException` (400) means another index job of that kind is active for
|
|
54
|
+
a different site scope; wait for it rather than retrying.
|
|
55
|
+
|
|
56
|
+
A SCAPI 400 (for example a decode error naming the bad property) is a request error and is
|
|
57
|
+
reported as-is; `auto` does not retry it over OCAPI. Fallback happens only for
|
|
58
|
+
auth/capability rejections (invalid scope, 401/403/404/405/406/415); if OCAPI then also
|
|
59
|
+
fails, the error shows both, with "The SCAPI attempt was rejected first: ...". An OCAPI
|
|
60
|
+
"isn't allowed for the current client" means the client has no OCAPI job permission.
|
|
61
|
+
|
|
62
|
+
From MCP code mode, the same job is a SCAPI `createJobExecution` call; see
|
|
63
|
+
`skill://mcp/b2c-mcp-scapi/references/jobs.md` (section "Start a job").
|
|
35
64
|
|
|
36
65
|
### Standard (System) Job Steps
|
|
37
66
|
|
|
@@ -312,4 +312,4 @@ All operations accept `(client, tenantId, options?)` and return `Promise<Metrics
|
|
|
312
312
|
- **404/category not enabled**: the category may not be enabled for your organization (closed beta)
|
|
313
313
|
- **503/temporarily unavailable**: metrics service may be temporarily unavailable
|
|
314
314
|
|
|
315
|
-
For full command reference, use `b2c metrics --help` and see [CLI docs](/cli/metrics) and [Metrics Guide](/guide/metrics).
|
|
315
|
+
For full command reference, use `b2c metrics --help` and see [CLI docs](https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/metrics.md) (`b2c docs read cli-metrics`) and [Metrics Guide](https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/metrics.md) (`b2c docs read guide-metrics`).
|
|
@@ -19,8 +19,8 @@ Run `b2c setup inspect` to see the resolved configuration and which source provi
|
|
|
19
19
|
|
|
20
20
|
Most MRT commands run against the legacy MRT Cloud API (API key). Several commands can also run over the SCAPI MRT backend: `mrt bundle history`, `mrt bundle list`, `mrt bundle deploy` (both the local-build push and deploying an existing `<bundleId>`), and the `mrt env var` family (`list` / `set` / `push` / `delete`). Choose with `--mrt-backend` (`MRT_BACKEND` / `SFCC_MRT_BACKEND`, or `mrtBackend` in `dw.json`):
|
|
21
21
|
|
|
22
|
-
- `
|
|
23
|
-
- `
|
|
22
|
+
- `legacy` (default) — always the MRT Cloud API.
|
|
23
|
+
- `auto` — use SCAPI when it's configured (`--short-code` + `--tenant-id` + client-credentials or JWT Bearer auth), otherwise legacy. Falls back to legacy on safe pre-execution errors. Each command requests its own scopes: bundle commands use `sfcc.storefront.deployments[.rw]`; env var commands use `sfcc.storefront.environments[.rw]` (reads accept either tier, writes require `.rw`).
|
|
24
24
|
- `scapi` — always SCAPI, with no fallback; errors if prerequisites are missing. Also errors on unsupported commands (every MRT command except the bundle and env var commands above).
|
|
25
25
|
|
|
26
26
|
Notes:
|
|
@@ -183,7 +183,7 @@ Configure MRT settings in your project's `dw.json`:
|
|
|
183
183
|
export MRT_API_KEY=your-api-key
|
|
184
184
|
export MRT_PROJECT=my-storefront
|
|
185
185
|
export MRT_ENVIRONMENT=staging
|
|
186
|
-
export MRT_BACKEND=
|
|
186
|
+
export MRT_BACKEND=legacy # legacy (default) | auto | scapi
|
|
187
187
|
```
|
|
188
188
|
|
|
189
189
|
### ~/.mobify Config
|
|
@@ -9,7 +9,7 @@ Use the `b2c` CLI plugin to manage SCAPI Custom API endpoints and check their re
|
|
|
9
9
|
|
|
10
10
|
When B2C MCP is available, prefer `scapi_custom_apis_get_status` for registration
|
|
11
11
|
and `scapi_schemas_list` for live contracts. For Admin custom API execution, read
|
|
12
|
-
`skill://mcp/scapi/SKILL.md`; fetch the contract through `scapi.request` in the
|
|
12
|
+
`skill://mcp/b2c-mcp-scapi/SKILL.md`; fetch the contract through `scapi.request` in the
|
|
13
13
|
program before calling its endpoints. Schema reads need `sfcc.scapi-schemas`;
|
|
14
14
|
execution needs the declared `c_*` scope. Shopper execution is unsupported.
|
|
15
15
|
|
|
@@ -10,7 +10,7 @@ Browse standard or tenant-specific SCAPI OpenAPI contracts.
|
|
|
10
10
|
## Tool choice
|
|
11
11
|
|
|
12
12
|
When B2C MCP is available, prefer `scapi_search` for Admin and Shopper contracts.
|
|
13
|
-
Read `skill://mcp/scapi/SKILL.md` via resource or `skills_read` first; pass
|
|
13
|
+
Read `skill://mcp/b2c-mcp-scapi/SKILL.md` via resource or `skills_read` first; pass
|
|
14
14
|
`skillRead: true`. Discover method/path/operationId, then selected inputs and
|
|
15
15
|
fields. The default searches bundled standard contracts offline; `schemas: "live"`
|
|
16
16
|
searches the tenant's contracts (custom attributes, custom APIs, newer APIs) and
|
|
@@ -29,7 +29,11 @@ unsupported. Use docs tools for semantics
|
|
|
29
29
|
and limits rather than duplicating contract discovery.
|
|
30
30
|
|
|
31
31
|
For CLI work, use `b2c scapi schemas list` and
|
|
32
|
-
`b2c scapi schemas get <family> <name> <version>`; both use live access
|
|
32
|
+
`b2c scapi schemas get <family> <name> <version>`; both use live access and fall back to the
|
|
33
|
+
bundled standard contracts (with a warning and `source: "bundled"` in `--json`) when it fails.
|
|
34
|
+
The Schemas API returns operation summaries/descriptions and examples only when asked:
|
|
35
|
+
`--expand-paths`/`--expand-schemas` fetch the prose, `--expand-all` fetches everything, and
|
|
36
|
+
`--include summaries,descriptions,...` chooses sections directly.
|
|
33
37
|
CLI get expands custom properties by default; `--no-expand-custom-properties`
|
|
34
38
|
requests the standard contract. MCP also defaults to expansion; disable it with
|
|
35
39
|
`expandCustomProperties: false`. Known custom fields can be sent through standard
|
|
@@ -48,7 +48,7 @@ review and trim before committing, preserving XSD-required fields.
|
|
|
48
48
|
- Archive layout and XML workflows: [archive workflows](references/WORKFLOWS.md).
|
|
49
49
|
- Attribute/type XML patterns: [metadata XML](references/METADATA-XML.md).
|
|
50
50
|
- Remote imports, size splitting, and import-set options: [import options](references/IMPORT-OPTIONS.md).
|
|
51
|
-
- Export flags, data units, and compact JSON results:
|
|
51
|
+
- Export flags, data units, and compact JSON results: the export reference in the `b2c-job` skill.
|
|
52
52
|
- Ordered migrations, naming, history, and recovery: `b2c-cli:b2c-import-set-migrations`.
|
|
53
53
|
- Service configuration XML: `b2c:b2c-webservices`.
|
|
54
54
|
|
|
@@ -95,7 +95,7 @@ Site reads and cartridge-path writes run over SCAPI (the `site/sites` API) when
|
|
|
95
95
|
```bash
|
|
96
96
|
b2c sites list
|
|
97
97
|
# then use the ID in other commands
|
|
98
|
-
b2c
|
|
98
|
+
b2c job export --site RefArch --site-data content,site_preferences
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
**Checking site status:** The status column shows the storefront status (online/offline) for each site, useful for verifying deployment state.
|
|
@@ -7,7 +7,7 @@ description: Create, update, and manage SLAS (Shopper Login and API Access Servi
|
|
|
7
7
|
|
|
8
8
|
Use the `b2c` CLI plugin to manage SLAS (Shopper Login and API Access Service) API clients and credentials.
|
|
9
9
|
|
|
10
|
-
> **Important:** SLAS is for **shopper** (customer) authentication used by storefronts and headless commerce. For **admin** tokens (OCAPI, Admin APIs), use `b2c auth token` - see
|
|
10
|
+
> **Important:** SLAS is for **shopper** (customer) authentication used by storefronts and headless commerce. For **admin** tokens (OCAPI, Admin APIs), use `b2c auth token` - see the `b2c-config` skill.
|
|
11
11
|
|
|
12
12
|
> **Tip:** If `b2c` is not installed globally, use `npx @salesforce/b2c-cli` instead (e.g., `npx @salesforce/b2c-cli slas client list`).
|
|
13
13
|
|
|
@@ -29,9 +29,9 @@ update process for live customer impact; do not wait for exact counts to escalat
|
|
|
29
29
|
| Order records | Discover Admin Orders contracts via code mode | A response enum does not establish supported status filters. See [failed-order triage](skill://b2c-ops/b2c-order-failure-triage/SKILL.md) for the demonstrated OCAPI fallback. |
|
|
30
30
|
| Affected products/attributes | SCAPI Admin product reads; live schemas for tenant custom fields | Compare known IDs and selected fields. Shopper contracts are reference-only in this runtime. |
|
|
31
31
|
| Suspected import/integration | [b2c-job-health](skill://b2c-ops/b2c-job-health/SKILL.md) | Read the chosen job's log and check its actual data effects. |
|
|
32
|
-
| Traffic/latency context | Code mode Metrics where enabled; CLI `b2c metrics` | Feature access and scopes vary. CIP/CCAC trends: `cip_discover` / `cip_query` after [CIP guidance](skill://mcp/cip/SKILL.md), with freshness/coverage limits. CLI fallback: `b2c cip`. |
|
|
32
|
+
| Traffic/latency context | Code mode Metrics where enabled; CLI `b2c metrics` | Feature access and scopes vary. CIP/CCAC trends: `cip_discover` / `cip_query` after [CIP guidance](skill://mcp/b2c-mcp-cip/SKILL.md), with freshness/coverage limits. CLI fallback: `b2c cip`. |
|
|
33
33
|
|
|
34
|
-
Read `skill://mcp/scapi/SKILL.md` before code mode; prefer dedicated tools when
|
|
34
|
+
Read `skill://mcp/b2c-mcp-scapi/SKILL.md` before code mode; prefer dedicated tools when
|
|
35
35
|
available. Discover operations/required fields before requests, compose bounded
|
|
36
36
|
reads, and return selected evidence with errors and continuation. Read only the
|
|
37
37
|
conditional reference needed; native assistants can use installed skill names.
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: b2c-edge-traffic-triage
|
|
3
|
+
description: Investigate bot activity, scrapers, crawlers or abusive traffic hitting a B2C Commerce storefront through the eCDN (CDN edge). Review WAF, firewall and rate-limiting protections, correlate available traffic evidence, and propose narrowly scoped rule changes for approval.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Edge traffic and bot triage
|
|
7
|
+
|
|
8
|
+
Outcome: identify which automated traffic matters, whether current edge
|
|
9
|
+
protections cover it, and a proposed, approved next step. Inspection never
|
|
10
|
+
authorizes blocking, challenging, or changing zone settings.
|
|
11
|
+
|
|
12
|
+
## Scope and impact
|
|
13
|
+
|
|
14
|
+
Resolve the instance with `config_inspect` (CLI: `b2c setup inspect`). List the
|
|
15
|
+
tenant's zones first and focus on production storefront zones; ask when the
|
|
16
|
+
target zone is ambiguous. Use a fixed UTC window (propose the last 7 days if
|
|
17
|
+
none is given) and record the symptom: origin load or errors, scraping, login or
|
|
18
|
+
token abuse, basket/inventory abuse, or a routine review. Record impact and
|
|
19
|
+
owner; follow the team's incident process for live customer impact.
|
|
20
|
+
|
|
21
|
+
## Access and tools
|
|
22
|
+
|
|
23
|
+
| Evidence | Preferred MCP path | CLI fallback |
|
|
24
|
+
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
|
|
25
|
+
| Zones | Code mode `getZonesInfo` (`cdn/zones/v1`) | `b2c ecdn zones list` |
|
|
26
|
+
| Edge protections | Code mode reads of security settings, custom firewall rules, rate-limiting rules, managed WAF rulesets | `b2c ecdn security get`, `b2c ecdn firewall list`, `b2c ecdn rate-limit list`, `b2c ecdn waf ...` |
|
|
27
|
+
| Edge traffic attribution | Discover read operations for edge traffic or analytics with `scapi_search` (`api: "cdn/zones/v1"`, prefer `schemas: "live"`); use only what the contract offers | Logpush jobs (`listLogpushJob`; `b2c ecdn logpush jobs list`) show where raw edge logs already go |
|
|
28
|
+
| Edge volume and errors | `metrics_get` with `category: "ecdn"` where the Metrics API is enabled | `b2c metrics ecdn` |
|
|
29
|
+
| Origin impact | `logs_list_files` / `logs_get_recent` | `b2c logs get` |
|
|
30
|
+
|
|
31
|
+
Read `skill://mcp/b2c-mcp-scapi/SKILL.md` before code mode; the zone APIs need
|
|
32
|
+
`sfcc.cdn-zones` (writes `sfcc.cdn-zones.rw`). If no traffic operation is
|
|
33
|
+
available to this tenant or client, say that edge attribution is unavailable
|
|
34
|
+
through the toolkit and continue with protections, Logpush and origin evidence.
|
|
35
|
+
Never infer traffic volume from rule configuration alone.
|
|
36
|
+
|
|
37
|
+
## Checks and decisions
|
|
38
|
+
|
|
39
|
+
1. Keep executions small: one or two zones per `scapi_execute`, fixed `from`/`to`,
|
|
40
|
+
small result limits. Executions stop at 30 s; split work rather than retry a
|
|
41
|
+
timed-out batch whole.
|
|
42
|
+
2. Classify sources by user agent, ASN, IP, host, path, status and cache result:
|
|
43
|
+
verified crawlers and link previews, monitoring or integrations, unverified
|
|
44
|
+
automation (headless browsers, HTTP libraries, empty user agents), and
|
|
45
|
+
scanning or exploit probes. A user agent is self-reported; corroborate it.
|
|
46
|
+
3. Before proposing action on a high-volume source, ask who runs it. Synthetic
|
|
47
|
+
monitors, performance tests, feeds and Salesforce services often look like bots.
|
|
48
|
+
4. Prioritize traffic that reaches origin or sensitive paths (login, token,
|
|
49
|
+
basket, checkout, search). Mostly cached automation has lower origin cost.
|
|
50
|
+
5. Compare sources with protections: rules in a non-enforcing mode (monitor,
|
|
51
|
+
simulate, log), disabled managed rules, thresholds above observed rates,
|
|
52
|
+
and rules scoped to other hosts or paths. Report gaps, not only matches.
|
|
53
|
+
|
|
54
|
+
## Mitigation and recovery
|
|
55
|
+
|
|
56
|
+
Propose the narrowest change (host, path, ASN or verified-bot condition) and a
|
|
57
|
+
non-enforcing or challenge step before a block. Changes need explicit approval
|
|
58
|
+
and are subject to Safety Mode. After a change, re-check the same evidence over
|
|
59
|
+
a fresh equivalent window and keep a rollback (previous rule state). Rule
|
|
60
|
+
syntax and CLI options: native `b2c-ecdn`, MCP `skill://b2c-cli/b2c-ecdn/SKILL.md`
|
|
61
|
+
and its `references/SECURITY.md`.
|
|
62
|
+
|
|
63
|
+
## Escalation and handoff
|
|
64
|
+
|
|
65
|
+
Summarize zones, window, top sources with counts and share, the evidence source
|
|
66
|
+
and its limits, matching rules and gaps, proposed changes, and next owner.
|
|
67
|
+
Route suspected attacks with customer impact to the security owner and
|
|
68
|
+
Salesforce Support. Use native `b2c-production-triage` or the MCP
|
|
69
|
+
[case template](skill://b2c-ops/b2c-production-triage/references/escalation.md).
|
|
@@ -20,14 +20,14 @@ an incident. Do not invent impact from a red status alone.
|
|
|
20
20
|
|
|
21
21
|
## Access and tools
|
|
22
22
|
|
|
23
|
-
| Evidence | Preferred MCP path
|
|
24
|
-
| ---------------------------- |
|
|
25
|
-
| Execution history and steps | `builtin/job-execution-review` / `builtin/job-execution-inspect` in code mode
|
|
26
|
-
| Known execution log | `webdav_get` with the returned `logFilePath`
|
|
27
|
-
| Expected product/data change | Discover the relevant Admin operation and select affected fields
|
|
28
|
-
| Code-version clues | `builtin/code-version-inspect` in code mode
|
|
23
|
+
| Evidence | Preferred MCP path | CLI fallback |
|
|
24
|
+
| ---------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------ |
|
|
25
|
+
| Execution history and steps | `builtin/job-execution-review` / `builtin/job-execution-inspect` in code mode | `b2c job search`; check `--help` for filters |
|
|
26
|
+
| Known execution log | `webdav_get` with the returned `logFilePath` | `b2c job log JOB_ID EXECUTION_ID` |
|
|
27
|
+
| Expected product/data change | Discover the relevant Admin operation and select affected fields | Relevant CLI/data workflow if supported |
|
|
28
|
+
| Code-version clues | `builtin/code-version-inspect` in code mode | `b2c code list`; modification time is not activation history |
|
|
29
29
|
|
|
30
|
-
Read `skill://mcp/scapi/SKILL.md` before code mode. Use its search/discovery
|
|
30
|
+
Read `skill://mcp/b2c-mcp-scapi/SKILL.md` before code mode. Use its search/discovery
|
|
31
31
|
contract; project/instance context belongs on tool calls. Authentication is
|
|
32
32
|
managed. Do not export tokens or use ambient fetch inside code mode.
|
|
33
33
|
|
|
@@ -61,6 +61,11 @@ idempotency, duplicate exports/messages, and rollback limits. Inspect uncertain
|
|
|
61
61
|
outcomes before retrying; never replay a whole code-mode program after writes.
|
|
62
62
|
Verify business data as well as terminal job status after intervention.
|
|
63
63
|
|
|
64
|
+
To start a rerun (for example a search-index rebuild) from MCP, use code mode
|
|
65
|
+
`createJobExecution`; system jobs need their own body, not `parameters`:
|
|
66
|
+
`skill://mcp/b2c-mcp-scapi/references/jobs.md#start-a-job`. CLI:
|
|
67
|
+
`b2c job run ID --wait --body '{"site_scope":["Site"]}'` (see `b2c-cli:b2c-job`).
|
|
68
|
+
|
|
64
69
|
## Escalation and handoff
|
|
65
70
|
|
|
66
71
|
Summarize job/execution/step IDs, impact/window, status, affected inputs, log
|
|
@@ -72,4 +77,4 @@ No source access is required; case submission needs authorization.
|
|
|
72
77
|
|
|
73
78
|
CLI-specific detail when needed: native `b2c-job`, MCP
|
|
74
79
|
`skill://b2c-cli/b2c-job/SKILL.md`, or the
|
|
75
|
-
[Jobs reference](https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/jobs).
|
|
80
|
+
[Jobs reference](https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/jobs.md) (`b2c docs read cli-jobs`).
|
|
@@ -28,7 +28,7 @@ process. Counts describe indexed orders, not all checkout attempts or conversion
|
|
|
28
28
|
|
|
29
29
|
Read [order-search recipe](references/order-evidence.md) before counting: it
|
|
30
30
|
defines the site grant/index prerequisites, bounded request bodies, auth handling,
|
|
31
|
-
and fault interpretation. For code mode, first read `skill://mcp/scapi/SKILL.md`.
|
|
31
|
+
and fault interpretation. For code mode, first read `skill://mcp/b2c-mcp-scapi/SKILL.md`.
|
|
32
32
|
If external requests are unavailable, report that evidence gap and continue with
|
|
33
33
|
logs; do not deploy an OrderMgr endpoint to obtain access.
|
|
34
34
|
|
|
@@ -19,13 +19,13 @@ Custom API just to gain inspection access.
|
|
|
19
19
|
Use configured hostname, site ID, and client ID from `config_inspect` or
|
|
20
20
|
`b2c setup inspect`. Obtain an AM token through the CLI's `b2c auth token --json`
|
|
21
21
|
for an external request, keeping it in memory and out of output/files. If using
|
|
22
|
-
the MCP token helper, read `skill://mcp/scapi/references/tokens.md`; token export
|
|
22
|
+
the MCP token helper, read `skill://mcp/b2c-mcp-scapi/references/tokens.md`; token export
|
|
23
23
|
is only for the external client, never required for managed SCAPI calls.
|
|
24
24
|
MCP Safety Mode does not protect an independently executed HTTP request.
|
|
25
25
|
|
|
26
26
|
The OAuth client needs the site's OCAPI Shop resource grant for `POST /order_search`
|
|
27
27
|
and a usable order search index. Use the
|
|
28
|
-
[authentication guide](https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/authentication)
|
|
28
|
+
[authentication guide](https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/authentication.md) (`b2c docs read guide-authentication`)
|
|
29
29
|
and `docs_search` for current OCAPI Settings/order indexing instructions. Have
|
|
30
30
|
the user authorize any grant or index maintenance; do not perform it to satisfy
|
|
31
31
|
a read request.
|
|
@@ -25,12 +25,12 @@ every available signal.
|
|
|
25
25
|
## Access and tools
|
|
26
26
|
|
|
27
27
|
- Establish access: MCP, terminal/CLI, logs, data, source. Operator work does not
|
|
28
|
-
require a cartridge checkout. Credentials/setup issues: MCP `mcp/b2c-config`
|
|
28
|
+
require a cartridge checkout. Credentials/setup issues: MCP `mcp/b2c-mcp-config`
|
|
29
29
|
section `setup-and-access`; native `b2c-config`/`b2c-auth`, or the
|
|
30
|
-
[authentication guide](https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/authentication).
|
|
30
|
+
[authentication guide](https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/authentication.md) (`b2c docs read guide-authentication`).
|
|
31
31
|
|
|
32
32
|
Prefer dedicated MCP tools; discover available names once. Read
|
|
33
|
-
`skill://mcp/scapi/SKILL.md` before using `scapi_search`/`scapi_execute`, as those
|
|
33
|
+
`skill://mcp/b2c-mcp-scapi/SKILL.md` before using `scapi_search`/`scapi_execute`, as those
|
|
34
34
|
tools require. Read only the matching runbook/reference, not every linked skill.
|
|
35
35
|
Native assistants use the installed skill name; MCP can read these URIs or use
|
|
36
36
|
`skills_read` with `collection: "b2c-ops"` and a task query.
|
|
@@ -41,8 +41,9 @@ Native assistants use the installed skill name; MCP can read these URIs or use
|
|
|
41
41
|
| Failed job or stale data | Code mode `codemode.describe("builtin/failed-job-triage")`, then run with fixed `from`/`to` -> execution IDs and `logFilePath` -> log tools | [Job health](skill://b2c-ops/b2c-job-health/SKILL.md) covers continuation, step details, exact WebDAV logs, and green-but-incomplete runs. |
|
|
42
42
|
| Checkout failures or orders down | Custom logs -> determine whether failures produce order records -> relevant data/traffic evidence | [Checkout triage](skill://b2c-ops/b2c-checkout-triage/SKILL.md) distinguishes checkout symptoms from failed-order records. |
|
|
43
43
|
| Find/count FAILED orders or investigate affected products | Verify Admin filter support; otherwise external OCAPI Shop order search -> safe IDs -> logs and selected Admin product reads | [Failed-order triage](skill://b2c-ops/b2c-order-failure-triage/SKILL.md) owns enumeration, count/sample limits, and the workaround. No OCAPI helper exists inside code mode. |
|
|
44
|
+
| Bot, scraper or abusive traffic; edge 403/429 spikes | Zone protections and available edge traffic evidence via code mode `cdn/zones/v1` | [Edge traffic triage](skill://b2c-ops/b2c-edge-traffic-triage/SKILL.md) classifies sources, checks owners, and finds protection gaps before any rule change. |
|
|
44
45
|
| Suspected code change | Code mode `builtin/code-version-inspect`: active/rollback versions and activation/modification timestamps | Current metadata is not a complete activation history. Corroborate with release records. |
|
|
45
|
-
| Runtime-only defect | [MCP debugger](skill://mcp/debugger/SKILL.md) on an authorized reproduction target | Operator handoff is valid without source access. Do not halt production requests for routine triage. |
|
|
46
|
+
| Runtime-only defect | [MCP debugger](skill://mcp/b2c-mcp-debugger/SKILL.md) on an authorized reproduction target | Operator handoff is valid without source access. Do not halt production requests for routine triage. |
|
|
46
47
|
|
|
47
48
|
## Checks and decisions
|
|
48
49
|
|