@salesforce/b2c-dx-mcp 1.7.0 → 1.8.0

package/dist/commands/mcp.js

@@ -195,7 +195,8 @@ export default class McpServerCommand extends BaseCommand {
         }),
         'docs-topics': Flags.string({
             description: 'Limit the documentation exposed by the docs tools to these categories (comma-separated allowlist). ' +
-                'Options: script-api, job-step, commerce-api, pwa-kit-managed-runtime, sfnext, sfra, b2c-commerce, tooling. ' +
+                'Options: script-api, job-step, commerce-api, pwa-kit-managed-runtime, sfnext, sfra, b2c-commerce, tooling, ' +
+                'help-admin, help-merchant. ' +
                 'Bounds the whole docs corpus; per-call category/storefront narrow within it. Unknown names are ignored.',
             env: 'SFCC_DOCS_TOPICS',
         }),
@@ -308,8 +309,10 @@ export default class McpServerCommand extends BaseCommand {
             configPath: this.flags.config,
             // Project directory for auto-discovery. oclif handles flag with env fallback.
             projectDirectory: this.flags['project-directory'],
-            // Docs topic allowlist (bounds the docs corpus at startup).
-            docsTopics: this.flags['docs-topics'],
+            // Docs topic allowlist (bounds the docs corpus at startup). Flag first
+            // (--docs-topics / SFCC_DOCS_TOPICS), else config `docsCategories`
+            // (dw.json `docs-categories`, SFCC_DOCS_CATEGORIES, package.json).
+            docsTopics: this.flags['docs-topics'] ?? this.resolvedConfig?.values.docsCategories?.join(','),
         };
         // Add toolsets to telemetry attributes
         if (this.telemetry && startupFlags.toolsets) {

package/dist/tools/docs/docs-read.d.ts

@@ -1,4 +1,5 @@
 import { type DocCategory } from '@salesforce/b2c-tooling-sdk/docs';
+import type { ProjectType } from '@salesforce/b2c-tooling-sdk/discovery';
 import type { McpTool } from '../../utils/index.js';
 import type { Services } from '../../services.js';
-export declare function createDocsReadTool(loadServices: () => Promise<Services> | Services, enabledCategories?: readonly DocCategory[]): McpTool;
+export declare function createDocsReadTool(loadServices: () => Promise<Services> | Services, enabledCategories?: readonly DocCategory[], detectedWorkspaces?: readonly ProjectType[]): McpTool;

package/dist/tools/docs/docs-read.js

@@ -9,14 +9,15 @@ import { createToolAdapter, errorResult, jsonResult } from '../adapter.js';
 import { enabledCategoriesNote } from './topics.js';
 /** Default maximum characters of content returned per read call, to bound the inline payload. */
 const DEFAULT_MAX_LENGTH = 12_000;
-export function createDocsReadTool(loadServices, enabledCategories) {
+export function createDocsReadTool(loadServices, enabledCategories, detectedWorkspaces = []) {
     return createToolAdapter({
         name: 'docs_read',
-        description: 'Read B2C Commerce documentation (markdown) for a class, module, job step, or guide. ' +
+        description: 'Read B2C Commerce documentation (markdown) for a class, module, job step, guide, or Help article. ' +
             'Accepts an exact id (e.g. "dw.catalog.ProductMgr", "sfnext/sfnext-get-started") or a fuzzy ' +
-            'query — best match wins. Script API / job-step content is bundled; Developer Center guide ' +
-            'content is fetched from its published URL on demand (with a summary/headings fallback if the ' +
-            'network is unavailable). If you do not know the id, call docs_search first. Long docs are ' +
+            'query — best match wins (a fuzzy query favors the detected workspace, matching docs_search). ' +
+            'Job-step content is bundled; Script API, Developer Center guide, and Salesforce Help content is ' +
+            'fetched from its published URL on demand and cached locally (with a summary/headings fallback if ' +
+            'the network is unavailable). If you do not know the id, call docs_search first. Long docs are ' +
             'truncated to maxLength chars; page with offset when truncated=true. The returned entry ' +
             'includes the canonical url for citation.' +
             enabledCategoriesNote(enabledCategories),
@@ -40,7 +41,12 @@ export function createDocsReadTool(loadServices, enabledCategories) {
                 .describe(`Maximum characters of content to return. Defaults to ${DEFAULT_MAX_LENGTH}.`),
         },
         async execute(args) {
-            const found = await readDocByQuery(args.query, { enabledCategories });
+            // Favor the detected workspace when resolving a fuzzy query so a read
+            // picks the same top hit docs_search ranks first. Exact id matches
+            // short-circuit inside readDocByQuery before searching, so the boost
+            // only affects fuzzy resolution.
+            const workspace = detectedWorkspaces.length > 0 ? [...detectedWorkspaces] : undefined;
+            const found = await readDocByQuery(args.query, { enabledCategories, workspace });
             if (!found)
                 return null;
             const totalLength = found.content.length;

package/dist/tools/docs/index.js

@@ -16,7 +16,7 @@ export function createDocsTools(loadServices, context = {}) {
     const { detectedWorkspaces = [], enabledCategories } = context;
     return [
         createDocsSearchTool(loadServices, detectedWorkspaces, enabledCategories),
-        createDocsReadTool(loadServices, enabledCategories),
+        createDocsReadTool(loadServices, enabledCategories, detectedWorkspaces),
         createDocsListTool(loadServices, detectedWorkspaces, enabledCategories),
         createDocsSchemaSearchTool(loadServices),
         createDocsSchemaReadTool(loadServices),

package/oclif.manifest.json

@@ -403,7 +403,7 @@
           "type": "option"
         },
         "docs-topics": {
-          "description": "Limit the documentation exposed by the docs tools to these categories (comma-separated allowlist). Options: script-api, job-step, commerce-api, pwa-kit-managed-runtime, sfnext, sfra, b2c-commerce, tooling. Bounds the whole docs corpus; per-call category/storefront narrow within it. Unknown names are ignored.",
+          "description": "Limit the documentation exposed by the docs tools to these categories (comma-separated allowlist). Options: script-api, job-step, commerce-api, pwa-kit-managed-runtime, sfnext, sfra, b2c-commerce, tooling, help-admin, help-merchant. Bounds the whole docs corpus; per-call category/storefront narrow within it. Unknown names are ignored.",
           "env": "SFCC_DOCS_TOPICS",
           "name": "docs-topics",
           "hasDynamicHelp": false,
@@ -428,5 +428,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "1.7.0"
+  "version": "1.8.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-dx-mcp",
   "description": "MCP server for B2C Commerce developer experience tools",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "author": "Salesforce",
   "license": "Apache-2.0",
   "repository": "SalesforceCommerceCloud/b2c-developer-tooling",
@@ -80,7 +80,7 @@
     "yaml": "2.9.0",
     "postcss": "8.5.15",
     "zod": "3.25.76",
-    "@salesforce/b2c-tooling-sdk": "1.19.1"
+    "@salesforce/b2c-tooling-sdk": "1.20.0"
   },
   "devDependencies": {
     "@eslint/compat": "^1",