Merge origin/main into feature/cip

Author: clavery

.changeset/prophet-ide-integration.md

@@ -0,0 +1,5 @@
+---
+'@salesforce/b2c-cli': minor
+---
+
+Add `b2c setup ide prophet` to generate a Prophet-compatible `dw.js` script from resolved CLI configuration (including plugin-resolved values), plus new IDE integration docs and setup command reference.

.github/CODEOWNERS

@@ -1,3 +1,5 @@
 #GUSINFO:CC Cosmos,B2C CLI and Developer Tools
 *       @clavery
-/packages/b2c-dx-mcp/       @yhsieh1 @patricksullivansf
+/packages/b2c-dx-mcp/       @yhsieh1 @patricksullivansf @wei-liu-sf
+/packages/b2c-vs-extension/    @wei-liu-sf
+

.gitignore

@@ -26,8 +26,7 @@ docs/.vitepress/cache
 # TypeDoc generated API docs (regenerated on build)
 docs/api/
 
-dw.json
-dw.json*
+*dw.json*
 .env
 .config/wt.toml
 .b2c/

docs/.vitepress/config.mts

@@ -50,6 +50,7 @@ const guideSidebar = [
       {text: 'Authentication Setup', link: '/guide/authentication'},
       {text: 'Account Manager', link: '/guide/account-manager'},
       {text: 'Analytics Reports (CIP/CCAC)', link: '/guide/analytics-reports-cip-ccac'},
+      {text: 'IDE Integration', link: '/guide/ide-integration'},
       {text: 'Scaffolding', link: '/guide/scaffolding'},
       {text: 'Security', link: '/guide/security'},
       {text: 'Storefront Next', link: '/guide/storefront-next'},
@@ -81,6 +82,7 @@ const guideSidebar = [
       {text: 'SCAPI Schemas', link: '/cli/scapi-schemas'},
       {text: 'Setup Commands', link: '/cli/setup'},
       {text: 'Scaffold Commands', link: '/cli/scaffold'},
+      {text: 'Docs Commands', link: '/cli/docs'},
       {text: 'Auth Commands', link: '/cli/auth'},
       {text: 'Account Manager Commands', link: '/cli/account-manager'},
       {text: 'Logging', link: '/cli/logging'},

docs/cli/docs.md

@@ -0,0 +1,205 @@
+---
+description: Search, read, and download B2C Commerce Script API documentation and bundled XSD schemas.
+---
+
+# Docs Commands
+
+Commands for searching and reading Script API documentation (`dw.*` classes/modules), reading bundled XSD schemas, and downloading fresh documentation from an instance.
+
+## Authentication
+
+| Operation       | Auth Required                     |
+| --------------- | --------------------------------- |
+| `docs search`   | None (uses local bundled docs)    |
+| `docs read`     | None (uses local bundled docs)    |
+| `docs schema`   | None (uses local bundled schemas) |
+| `docs download` | Instance + WebDAV credentials     |
+
+For `b2c docs download`, configure instance and WebDAV access:
+
+```bash
+export SFCC_SERVER=my-sandbox.demandware.net
+export SFCC_USERNAME=your-username
+export SFCC_PASSWORD=your-password
+```
+
+In addition to these topic-specific options, all commands also support [global flags](./index#global-flags).
+
+---
+
+## b2c docs search
+
+Search bundled Script API documentation using fuzzy matching.
+
+### Usage
+
+```bash
+b2c docs search [query]
+```
+
+### Arguments
+
+| Argument | Description                                             | Required                              |
+| -------- | ------------------------------------------------------- | ------------------------------------- |
+| `query`  | Search query (class name, module path, or partial text) | No (required unless `--list` is used) |
+
+### Flags
+
+| Flag            | Description                              | Default |
+| --------------- | ---------------------------------------- | ------- |
+| `--limit`, `-l` | Maximum number of results to display     | `20`    |
+| `--list`        | List all available documentation entries | `false` |
+
+### Examples
+
+```bash
+# Search by class name
+b2c docs search ProductMgr
+
+# Search with multiple terms
+b2c docs search "catalog product"
+
+# Limit result count
+b2c docs search status --limit 5
+
+# List all available entries
+b2c docs search --list
+```
+
+### Output
+
+Default output is a table with `ID`, `Title`, and `Match` score. With `--list`, output shows all entries (`ID` and `Title`) plus a total count.
+
+---
+
+## b2c docs read
+
+Read Script API documentation for a specific class or module.
+
+### Usage
+
+```bash
+b2c docs read <query>
+```
+
+### Arguments
+
+| Argument | Description                        | Required |
+| -------- | ---------------------------------- | -------- |
+| `query`  | Class/module name or partial match | Yes      |
+
+### Flags
+
+| Flag          | Description                                 | Default |
+| ------------- | ------------------------------------------- | ------- |
+| `--raw`, `-r` | Output raw markdown (no terminal rendering) | `false` |
+
+### Examples
+
+```bash
+# Read a class doc
+b2c docs read ProductMgr
+
+# Read by fully qualified name
+b2c docs read dw.catalog.ProductMgr
+
+# Output raw markdown for piping
+b2c docs read ProductMgr --raw
+
+# JSON output with selected entry + content
+b2c docs read ProductMgr --json
+```
+
+### Output
+
+By default, markdown is rendered for terminal display. Raw markdown is emitted when using `--raw` (or when output is not a TTY).
+
+---
+
+## b2c docs schema
+
+Read bundled XSD schemas (import/export data format definitions).
+
+### Usage
+
+```bash
+b2c docs schema [query]
+```
+
+### Arguments
+
+| Argument | Description                                                   | Required                              |
+| -------- | ------------------------------------------------------------- | ------------------------------------- |
+| `query`  | Schema name or partial match (for example `catalog`, `order`) | No (required unless `--list` is used) |
+
+### Flags
+
+| Flag           | Description                | Default |
+| -------------- | -------------------------- | ------- |
+| `--list`, `-l` | List all available schemas | `false` |
+
+### Examples
+
+```bash
+# Read a specific schema
+b2c docs schema catalog
+
+# Fuzzy match by schema name
+b2c docs schema order
+
+# List available schemas
+b2c docs schema --list
+
+# JSON output
+b2c docs schema catalog --json
+```
+
+### Output
+
+Without `--json`, the command writes schema XML directly to stdout. With `--list`, it prints available schema IDs and a total count.
+
+---
+
+## b2c docs download
+
+Download Script API documentation from a B2C Commerce instance to a local directory.
+
+### Usage
+
+```bash
+b2c docs download <output>
+```
+
+### Arguments
+
+| Argument | Description                               | Required |
+| -------- | ----------------------------------------- | -------- |
+| `output` | Local output directory for extracted docs | Yes      |
+
+### Flags
+
+| Flag             | Description                                       | Default |
+| ---------------- | ------------------------------------------------- | ------- |
+| `--keep-archive` | Keep the downloaded archive file after extraction | `false` |
+
+In addition to [global flags](./index#global-flags), this command supports [instance flags](./index#instance-flags) and authentication flags for WebDAV access.
+
+### Examples
+
+```bash
+# Download docs to a local directory
+b2c docs download ./docs
+
+# Keep the downloaded archive
+b2c docs download ./docs --keep-archive
+
+# Specify instance hostname directly
+b2c docs download ./my-docs --server sandbox.demandware.net
+
+# JSON output
+b2c docs download ./docs --json
+```
+
+### Output
+
+The command reports the number of extracted files and output path. If `--keep-archive` is set, it also prints the saved archive location.

docs/cli/index.md

@@ -67,6 +67,7 @@ All Account Manager commands are under the `am` topic:
 
 ### Utilities
 
+- [Docs Commands](./docs) - Search/read Script API docs and XSD schemas, and download docs from an instance
 - [Auth Commands](./auth) - Authentication and token management
 - [Logging](./logging) - Log levels, output formats, and environment variables