detect pwa kit extensible project

Author: yhsieh1

packages/b2c-dx-mcp/README.md

@@ -68,7 +68,7 @@ When neither `--toolsets` nor `--tools` are provided, the MCP server automatical
 
 | Project Type | Detection | Toolsets Enabled |
 |--------------|-----------|------------------|
-| **PWA Kit v3** | `@salesforce/pwa-kit-*` packages in package.json | PWAV3, MRT, SCAPI |
+| **PWA Kit v3** | `@salesforce/pwa-kit-*`, `@salesforce/retail-react-app`, or `ccExtensibility` | PWAV3, MRT, SCAPI |
 | **Storefront Next** | `@salesforce/storefront-next-*` packages in package.json | STOREFRONTNEXT, MRT, SCAPI |
 | **SFRA** | `cartridges/` folder with controllers or templates | CARTRIDGES, SCAPI |
 | **Custom API** | `rest-apis/*/api.json` or `rest-apis/*/schema.yaml` files | CARTRIDGES, SCAPI |

packages/b2c-dx-mcp/src/registry.ts

@@ -37,7 +37,7 @@ function getToolsetsForProjectType(projectType: ProjectType): Toolset[] {
       return ['STOREFRONTNEXT', 'MRT', 'SCAPI'];
     }
     default: {
-      // Fallback: provide basic SCAPI tools for unknown projects
+      // Fallback: provide basic SCAPI tools
       return ['SCAPI'];
     }
   }

packages/b2c-tooling-sdk/src/discovery/detector.ts

@@ -8,7 +8,7 @@
  *
  * @module discovery/detector
  */
-import type {DetectionResult, DetectionPattern, DetectOptions, ProjectType, ConfigFileInfo} from './types.js';
+import type {DetectionResult, DetectionPattern, DetectOptions, ProjectType} from './types.js';
 import {DEFAULT_PATTERNS} from './patterns/index.js';
 
 /**
@@ -63,7 +63,6 @@ export class WorkspaceTypeDetector {
   async detect(): Promise<DetectionResult> {
     const matchedPatterns: string[] = [];
     const projectTypes: ProjectType[] = [];
-    const configFiles: ConfigFileInfo[] = [];
 
     for (const pattern of this.patterns) {
       try {
@@ -83,7 +82,6 @@ export class WorkspaceTypeDetector {
       projectTypes,
       matchedPatterns,
       autoDiscovered: true,
-      configFiles,
     };
   }
 

packages/b2c-tooling-sdk/src/discovery/index.ts

@@ -25,12 +25,11 @@
  *
  * The detector recognizes the following project types:
  *
- * - `pwa-kit-v3` - PWA Kit v3 storefront (has @salesforce/pwa-kit-* dependencies)
+ * - `pwa-kit-v3` - PWA Kit v3 storefront (template copy or extensible flavor)
  * - `storefront-next` - Storefront Next/Odyssey project
  * - `sfra` - SFRA/cartridge-based storefront (has cartridges/ directory)
  * - `custom-api` - Custom SCAPI project (has api.json files)
  * - `headless` - Generic headless project (has dw.json but no specific framework)
- * - `unknown` - Could not determine project type
  *
  * ## Custom Patterns
  *
@@ -42,7 +41,6 @@
  * const myPattern: DetectionPattern = {
  *   name: 'my-framework',
  *   projectType: 'custom-api',
- *   priority: 100,
  *   detect: async (path) => {
  *     // Custom detection logic
  *     return false;
@@ -63,7 +61,7 @@
 export {WorkspaceTypeDetector, detectWorkspaceType} from './detector.js';
 
 // Types
-export type {ProjectType, DetectionPattern, DetectionResult, DetectOptions, ConfigFileInfo} from './types.js';
+export type {ProjectType, DetectionPattern, DetectionResult, DetectOptions} from './types.js';
 
 // Patterns (for customization)
 export {

packages/b2c-tooling-sdk/src/discovery/patterns/pwa-kit.ts

@@ -15,7 +15,9 @@ import {readPackageJson} from '../utils.js';
  * Detection pattern for PWA Kit v3 storefronts.
  *
  * Detects projects that have PWA Kit v3 SDK dependencies in package.json.
- * Matches packages starting with @salesforce/pwa-kit (v3+).
+ * Supports two flavors:
+ * - Template copy: Has @salesforce/pwa-kit-* packages
+ * - Extensible: Has @salesforce/retail-react-app or ccExtensibility field
  */
 export const pwaKitV3Pattern: DetectionPattern = {
   name: 'pwa-kit-v3',
@@ -24,7 +26,15 @@ export const pwaKitV3Pattern: DetectionPattern = {
     const pkg = await readPackageJson(workspacePath);
     if (!pkg) return false;
 
+    // Check for ccExtensibility field (extensible flavor marker)
+    if (pkg.ccExtensibility) return true;
+
     const deps = Object.keys({...pkg.dependencies, ...pkg.devDependencies});
-    return deps.some((dep) => dep.startsWith('@salesforce/pwa-kit'));
+
+    // Template copy flavor: @salesforce/pwa-kit-* packages
+    // Extensible flavor: @salesforce/retail-react-app package
+    return deps.some(
+      (dep) => dep.startsWith('@salesforce/pwa-kit') || dep === '@salesforce/retail-react-app'
+    );
   },
 };

packages/b2c-tooling-sdk/src/discovery/types.ts

@@ -13,12 +13,11 @@
  * Identifies the type of B2C Commerce project.
  */
 export type ProjectType =
-  | 'pwa-kit-v3' // PWA Kit v3 storefront (@salesforce/pwa-kit-* packages)
+  | 'pwa-kit-v3' // PWA Kit v3 storefront (template copy or extensible flavor)
   | 'storefront-next' // Storefront Next (Odyssey)
   | 'sfra' // SFRA/cartridge-based storefront
   | 'custom-api' // Custom SCAPI project
-  | 'headless' // Generic headless (uses SCAPI/dw.json but no specific framework)
-  | 'unknown'; // Could not determine
+  | 'headless'; // Generic headless (uses SCAPI/dw.json but no specific framework)
 
 /**
  * Detection pattern definition.
@@ -32,18 +31,6 @@ export interface DetectionPattern {
   detect: (workspacePath: string) => Promise<boolean>;
 }
 
-/**
- * Information about detected config files.
- */
-export interface ConfigFileInfo {
-  /** Type of configuration file */
-  type: 'dw.json' | 'package.json' | 'mobify.json' | 'api.json';
-  /** Path to the file */
-  path: string;
-  /** Relevant extracted info */
-  metadata?: Record<string, unknown>;
-}
-
 /**
  * Result of workspace detection.
  */
@@ -54,8 +41,6 @@ export interface DetectionResult {
   matchedPatterns: string[];
   /** Whether auto-discovery was performed */
   autoDiscovered: boolean;
-  /** Detected configuration files */
-  configFiles: ConfigFileInfo[];
 }
 
 /**

packages/b2c-tooling-sdk/test/discovery/detector.test.ts

@@ -166,7 +166,6 @@ describe('discovery/detector', () => {
       expect(result.projectTypes).to.deep.equal(['pwa-kit']);
       expect(result.matchedPatterns).to.deep.equal(['test']);
       expect(result.autoDiscovered).to.equal(true);
-      expect(result.configFiles).to.deep.equal([]);
     });
 
     it('works without options', async () => {

packages/b2c-tooling-sdk/test/discovery/patterns/pwa-kit.test.ts

@@ -53,6 +53,27 @@ describe('discovery/patterns/pwa-kit', () => {
       expect(result).to.be.false;
     });
 
+    it('detects @salesforce/retail-react-app dependency (extensible flavor)', async () => {
+      const pkg = {devDependencies: {'@salesforce/retail-react-app': '^8.0.0'}};
+      await fs.writeFile(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+
+      const result = await pwaKitV3Pattern.detect(tempDir);
+
+      expect(result).to.be.true;
+    });
+
+    it('detects ccExtensibility field (extensible flavor)', async () => {
+      const pkg = {
+        ccExtensibility: {extends: '@salesforce/retail-react-app', overridesDir: 'overrides'},
+        devDependencies: {},
+      };
+      await fs.writeFile(path.join(tempDir, 'package.json'), JSON.stringify(pkg));
+
+      const result = await pwaKitV3Pattern.detect(tempDir);
+
+      expect(result).to.be.true;
+    });
+
     it('returns false without PWA Kit dependencies', async () => {
       const pkg = {dependencies: {react: '^18.0.0'}};
       await fs.writeFile(path.join(tempDir, 'package.json'), JSON.stringify(pkg));