@salesforce/b2c-dx-mcp 0.4.0 → 0.4.2

package/dist/commands/mcp.d.ts

@@ -46,13 +46,13 @@ export default class McpServerCommand extends BaseCommand<typeof McpServerComman
         lang: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'working-directory': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'project-directory': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'extra-query': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'extra-body': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'extra-headers': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'cloud-origin': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'credentials-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
@@ -78,7 +78,7 @@ export default class McpServerCommand extends BaseCommand<typeof McpServerComman
      * Priority (highest to lowest):
      * 1. CLI flags (--server, --username, --api-key, etc.)
      * 2. Environment variables (SFCC_SERVER, SFCC_USERNAME, SFCC_MRT_API_KEY, etc.)
-     * 3. dw.json file (via --config flag or auto-discovered from --working-directory)
+     * 3. dw.json file (via --config flag or auto-discovered from --project-directory)
      * 4. ~/.mobify file (for MRT API key)
      */
     protected loadConfiguration(): ResolvedB2CConfig;

package/dist/commands/mcp.js

@@ -47,7 +47,7 @@
  * ### Global Flags (inherited from BaseCommand)
  * | Flag | Env Variable | Description |
  * |------|--------------|-------------|
- * | `--working-directory` | `SFCC_WORKING_DIRECTORY` | Project working directory (see note below) |
+ * | `--project-directory` | `SFCC_PROJECT_DIRECTORY` | Project directory (see note below) |
  * | `--config` | `SFCC_CONFIG` | Path to dw.json config file (auto-discovered if not provided) |
  * | `--instance` | `SFCC_INSTANCE` | Instance name from configuration file |
  * | `--log-level` | `SFCC_LOG_LEVEL` | Set logging verbosity (trace, debug, info, warn, error, silent) |
@@ -55,13 +55,13 @@
  * | `--json` | - | Output logs as JSON lines |
  * | `--lang` | - | Language for messages |
  *
- * **Note on `--working-directory`**: Many MCP clients (Cursor, Claude Desktop) spawn servers from the
+ * **Note on `--project-directory`**: Many MCP clients (Cursor, Claude Desktop) spawn servers from the
  * user's home directory (`~`) rather than the project directory. This flag is used for:
  * - Auto-discovery (detecting project type when no `--toolsets` or `--tools` are provided)
  * - Scaffolding tools (creating files in the correct project location)
  * - Any tool that needs to operate on the project directory
  *
- * Use `--working-directory` or `SFCC_WORKING_DIRECTORY` env var to specify the actual project path.
+ * Use `--project-directory` or `SFCC_PROJECT_DIRECTORY` env var to specify the actual project path.
  *
  * ## Configuration
  *
@@ -233,7 +233,7 @@ export default class McpServerCommand extends BaseCommand {
      * Priority (highest to lowest):
      * 1. CLI flags (--server, --username, --api-key, etc.)
      * 2. Environment variables (SFCC_SERVER, SFCC_USERNAME, SFCC_MRT_API_KEY, etc.)
-     * 3. dw.json file (via --config flag or auto-discovered from --working-directory)
+     * 3. dw.json file (via --config flag or auto-discovered from --project-directory)
      * 4. ~/.mobify file (for MRT API key)
      */
     loadConfiguration() {
@@ -298,7 +298,7 @@ export default class McpServerCommand extends BaseCommand {
             allowNonGaTools: this.flags['allow-non-ga-tools'],
             configPath: this.flags.config,
             // Working directory for auto-discovery. oclif handles flag with env fallback.
-            workingDirectory: this.flags['working-directory'],
+            workingDirectory: this.flags['project-directory'],
         };
         // Add toolsets to telemetry attributes
         if (this.telemetry && startupFlags.toolsets) {

package/dist/registry.js

@@ -95,13 +95,13 @@ export function createToolRegistry(loadServices) {
  */
 async function performAutoDiscovery(flags, reason) {
     const logger = getLogger();
-    // Working directory from --working-directory flag or SFCC_WORKING_DIRECTORY env var
+    // Working directory from --project-directory flag or SFCC_PROJECT_DIRECTORY env var
     const workingDirectory = flags.workingDirectory ?? process.cwd();
     // Warn if working directory wasn't explicitly configured
     if (!flags.workingDirectory) {
-        logger.warn({ cwd: workingDirectory }, 'No --working-directory flag or SFCC_WORKING_DIRECTORY env var provided. ' +
+        logger.warn({ cwd: workingDirectory }, 'No --project-directory flag or SFCC_PROJECT_DIRECTORY env var provided. ' +
             'MCP clients like Cursor and Claude Desktop often spawn servers from ~ instead of the project directory. ' +
-            'Set --working-directory or SFCC_WORKING_DIRECTORY for reliable auto-discovery.');
+            'Set --project-directory or SFCC_PROJECT_DIRECTORY for reliable auto-discovery.');
     }
     const detectionResult = await detectWorkspaceType(workingDirectory);
     // Map all detected project types to MCP toolsets (union)

package/dist/tools/storefrontnext/index.js

@@ -23,7 +23,7 @@
 import { z } from 'zod';
 import { createToolAdapter, jsonResult } from '../adapter.js';
 import { createDeveloperGuidelinesTool } from './developer-guidelines.js';
-import { createPageDesignerDecoratorTool } from '../page-designer-decorator/index.js';
+import { createPageDesignerDecoratorTool } from './page-designer-decorator/index.js';
 /**
  * Creates a placeholder tool for Storefront Next development.
  *

package/dist/tools/{page-designer-decorator → storefrontnext/page-designer-decorator}/analyzer.js

@@ -506,7 +506,7 @@ export function resolveComponent(input, workspaceRoot, searchPaths) {
             `Full path checked: ${fullPath}\n\n` +
             `Tips:\n` +
             `  1. Use component name instead (e.g., "ProductCard") for automatic discovery\n` +
-            `  2. If components are in a different repo, set --working-directory flag or SFCC_WORKING_DIRECTORY env var`);
+            `  2. If components are in a different repo, set --project-directory flag or SFCC_PROJECT_DIRECTORY env var`);
     }
     // Treat as component name - search for it
     const found = findComponentByName(input, workspaceRoot, searchPaths);
@@ -528,7 +528,7 @@ export function resolveComponent(input, workspaceRoot, searchPaths) {
             `  1. Provide full path: component: "src/components/ProductCard.tsx"\n` +
             `  2. Add custom search: searchPaths: ["packages/retail/src"]\n` +
             `  3. Check component name spelling and casing\n` +
-            `  4. If components are in a different repo, set --working-directory flag or SFCC_WORKING_DIRECTORY env var`);
+            `  4. If components are in a different repo, set --project-directory flag or SFCC_PROJECT_DIRECTORY env var`);
     }
     return found;
 }

package/dist/tools/{page-designer-decorator → storefrontnext/page-designer-decorator}/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import type { McpTool } from '../../utils/index.js';
-import type { Services } from '../../services.js';
+import type { McpTool } from '../../../utils/index.js';
+import type { Services } from '../../../services.js';
 export declare const pageDesignerDecoratorSchema: z.ZodObject<{
     component: z.ZodString;
     searchPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;

package/dist/tools/{page-designer-decorator → storefrontnext/page-designer-decorator}/index.js

@@ -303,8 +303,49 @@ function handleConfigureRegionsStep(args, workspaceRoot) {
         ],
     };
 }
+function hasNonEmptyConfig(config) {
+    return config !== null && config !== undefined && Object.keys(config).length > 0;
+}
+function buildAttributesFromProps(selectedProps, props, attributeConfig) {
+    return selectedProps.flatMap((propName) => {
+        const prop = props.find((p) => p.name === propName);
+        if (!prop)
+            return [];
+        const config = attributeConfig[propName];
+        return [
+            {
+                name: propName,
+                tsType: prop.type,
+                optional: prop.optional,
+                hasConfig: hasNonEmptyConfig(config),
+                config,
+            },
+        ];
+    });
+}
+function buildAttributesFromNewAttrs(newAttributes, attributeConfig) {
+    return newAttributes.map((attr) => {
+        const config = attributeConfig[attr.name];
+        return {
+            name: attr.name,
+            tsType: 'string',
+            optional: !attr.required,
+            hasConfig: hasNonEmptyConfig(config),
+            config,
+        };
+    });
+}
+function resolveRegions(conversationContext) {
+    const regionConfig = conversationContext?.regionConfig;
+    const enabled = Boolean(regionConfig?.enabled && regionConfig.regions?.length);
+    return {
+        hasRegions: enabled,
+        regions: enabled ? regionConfig.regions : [],
+        regionCount: enabled ? regionConfig.regions.length : 0,
+    };
+}
 function handleConfirmGenerationStep(args, workspaceRoot) {
-    const { componentMetadata, selectedProps = [], newAttributes = [], attributeConfig = {}, } = args.conversationContext || {};
+    const { componentMetadata, selectedProps = [], newAttributes = [], attributeConfig = {}, } = args.conversationContext ?? {};
     if (!componentMetadata) {
         return {
             content: [
@@ -318,45 +359,23 @@ function handleConfirmGenerationStep(args, workspaceRoot) {
     }
     const fullPath = resolveComponent(args.component, workspaceRoot, args.searchPaths);
     const componentInfo = componentAnalyzer.analyzeComponent(fullPath);
-    const attributes = [];
-    for (const propName of selectedProps) {
-        const prop = componentInfo.props.find((p) => p.name === propName);
-        if (!prop)
-            continue;
-        const config = attributeConfig[propName];
-        const hasConfig = config && Object.keys(config).length > 0;
-        attributes.push({
-            name: propName,
-            tsType: prop.type,
-            optional: prop.optional,
-            hasConfig,
-            config,
-        });
-    }
-    for (const attr of newAttributes) {
-        const config = attributeConfig[attr.name];
-        const hasConfig = config && Object.keys(config).length > 0;
-        attributes.push({
-            name: attr.name,
-            tsType: 'string',
-            optional: !attr.required,
-            hasConfig,
-            config,
-        });
-    }
-    const regionConfig = args.conversationContext?.regionConfig;
-    const hasRegions = regionConfig?.enabled && regionConfig.regions && regionConfig.regions.length > 0;
+    const attributes = [
+        ...buildAttributesFromProps(selectedProps, componentInfo.props, attributeConfig),
+        ...buildAttributesFromNewAttrs(newAttributes, attributeConfig),
+    ];
+    const { hasRegions, regions, regionCount } = resolveRegions(args.conversationContext);
+    const componentGroup = componentMetadata.group ?? 'odyssey_base';
     const context = {
         needsImports: true,
         componentId: componentMetadata.id,
         componentName: componentMetadata.name,
         componentDescription: componentMetadata.description,
-        componentGroup: componentMetadata.group || 'odyssey_base',
+        componentGroup,
         metadataClassName: `${componentInfo.componentName}Metadata`,
         hasAttributes: attributes.length > 0,
-        hasRegions: hasRegions || false,
+        hasRegions,
         hasLoader: false,
-        regions: hasRegions ? regionConfig.regions || [] : [],
+        regions,
         attributes,
     };
     const decoratorCode = generateDecoratorCode(context);
@@ -364,11 +383,11 @@ function handleConfirmGenerationStep(args, workspaceRoot) {
         decoratorCode,
         componentName: componentInfo.componentName,
         componentId: componentMetadata.id,
-        componentGroup: componentMetadata.group || 'odyssey_base',
+        componentGroup,
         file: args.component,
         attributeCount: attributes.length,
-        hasRegions: hasRegions || false,
-        regionCount: hasRegions && regionConfig.regions ? regionConfig.regions.length : 0,
+        hasRegions,
+        regionCount,
     });
     return {
         content: [

package/oclif.manifest.json

@@ -99,11 +99,14 @@
           "multiple": false,
           "type": "option"
         },
-        "working-directory": {
-          "description": "Project working directory",
-          "env": "SFCC_WORKING_DIRECTORY",
+        "project-directory": {
+          "aliases": [
+            "working-directory"
+          ],
+          "description": "Project directory",
+          "env": "SFCC_PROJECT_DIRECTORY",
           "helpGroup": "GLOBAL",
-          "name": "working-directory",
+          "name": "project-directory",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -384,5 +387,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "0.4.0"
+  "version": "0.4.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/b2c-dx-mcp",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "MCP server for B2C Commerce Cloud developer experience tools",
   "author": "Salesforce",
   "license": "MIT",
@@ -79,7 +79,7 @@
     "ts-morph": "^27.0.0",
     "yaml": "2.8.1",
     "zod": "3.25.76",
-    "@salesforce/b2c-tooling-sdk": "0.5.0"
+    "@salesforce/b2c-tooling-sdk": "0.5.2"
   },
   "devDependencies": {
     "@eslint/compat": "^1",