Add docs command topic for Script API documentation and XSD schemas

New CLI commands:
- `b2c docs search <query>` - Fuzzy search bundled Script API documentation
- `b2c docs read <query>` - Read documentation with terminal markdown rendering
- `b2c docs schema <query>` - Read XSD schema files with fuzzy matching
- `b2c docs download <output>` - Download docs from B2C instance

SDK changes:
- Add operations/docs module with search, read, and download functions
- Bundle 519 Script API markdown files and 54 XSD schemas in data/
- Use createRequire for robust path resolution to bundled data
- Export docs operations from main SDK entry point

Also adds b2c-docs skill for agent usage examples.

Author: clavery

AGENTS.md

@@ -37,6 +37,20 @@ pnpm run -r format
 pnpm run -r lint
 ```
 
+## Copyright Header
+
+All TypeScript source files must include this exact copyright header block:
+
+```typescript
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+```
+
+The header is enforced by eslint via `eslint-plugin-header`. The canonical definition is in `eslint.config.mjs` (root) as `copyrightHeader`.
+
 ## Setup/Packaging
 
 - use `pnpm` over `npm` for package management

packages/b2c-cli/package.json

@@ -15,7 +15,9 @@
     "@oclif/plugin-plugins": "^5",
     "@oclif/plugin-version": "^2",
     "@salesforce/b2c-tooling-sdk": "workspace:*",
-    "cliui": "^9.0.1"
+    "cliui": "^9.0.1",
+    "marked": "^15.0.0",
+    "marked-terminal": "^7.3.0"
   },
   "bundleDependencies": [
     "@oclif/core",
@@ -25,7 +27,9 @@
     "@oclif/plugin-plugins",
     "@oclif/plugin-version",
     "@salesforce/b2c-tooling-sdk",
-    "cliui"
+    "cliui",
+    "marked",
+    "marked-terminal"
   ],
   "devDependencies": {
     "@eslint/compat": "^1",
@@ -88,6 +92,9 @@
       "code": {
         "description": "Deploy and manage code versions on instances"
       },
+      "docs": {
+        "description": "Search and read Script API documentation"
+      },
       "job": {
         "description": "Run jobs and import/export site archives"
       },

packages/b2c-cli/src/commands/docs/download.ts

@@ -0,0 +1,79 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import {Args, Flags} from '@oclif/core';
+import {InstanceCommand} from '@salesforce/b2c-tooling-sdk/cli';
+import {downloadDocs, type DownloadDocsResult} from '@salesforce/b2c-tooling-sdk/operations/docs';
+import {t} from '../../i18n/index.js';
+
+export default class DocsDownload extends InstanceCommand<typeof DocsDownload> {
+  static args = {
+    output: Args.string({
+      description: 'Output directory for extracted documentation',
+      required: true,
+    }),
+  };
+
+  static description = t(
+    'commands.docs.download.description',
+    'Download Script API documentation from a B2C Commerce instance',
+  );
+
+  static enableJsonFlag = true;
+
+  static examples = [
+    '<%= config.bin %> <%= command.id %> ./docs',
+    '<%= config.bin %> <%= command.id %> ./docs --keep-archive',
+    '<%= config.bin %> <%= command.id %> --server sandbox.demandware.net ./my-docs',
+  ];
+
+  static flags = {
+    ...InstanceCommand.baseFlags,
+    'keep-archive': Flags.boolean({
+      description: 'Keep the downloaded archive file',
+      default: false,
+    }),
+  };
+
+  async run(): Promise<DownloadDocsResult> {
+    this.requireServer();
+    this.requireWebDavCredentials();
+
+    const outputDir = this.args.output;
+    const keepArchive = this.flags['keep-archive'];
+
+    this.log(
+      t('commands.docs.download.downloading', 'Downloading documentation from {{hostname}}...', {
+        hostname: this.resolvedConfig.hostname,
+      }),
+    );
+
+    const result = await downloadDocs(this.instance, {
+      outputDir,
+      keepArchive,
+    });
+
+    if (this.jsonEnabled()) {
+      return result;
+    }
+
+    this.log(
+      t('commands.docs.download.success', 'Downloaded {{count}} documentation files to {{path}}', {
+        count: result.fileCount,
+        path: result.outputPath,
+      }),
+    );
+
+    if (result.archivePath) {
+      this.log(
+        t('commands.docs.download.archiveKept', 'Archive saved to: {{path}}', {
+          path: result.archivePath,
+        }),
+      );
+    }
+
+    return result;
+  }
+}

packages/b2c-cli/src/commands/docs/read.ts

@@ -0,0 +1,88 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import {Args, Flags} from '@oclif/core';
+import {marked} from 'marked';
+// eslint-disable-next-line import/namespace -- marked-terminal CJS module causes parser issues
+import {markedTerminal} from 'marked-terminal';
+import {BaseCommand} from '@salesforce/b2c-tooling-sdk/cli';
+import {readDocByQuery, type DocEntry} from '@salesforce/b2c-tooling-sdk/operations/docs';
+import {t} from '../../i18n/index.js';
+
+interface ReadDocsResult {
+  entry: DocEntry;
+  content: string;
+}
+
+// Configure marked with terminal renderer
+marked.use(
+  markedTerminal({
+    width: 80,
+    reflowText: true,
+    tableOptions: {
+      wordWrap: true,
+      colWidths: [35, 45],
+    },
+  }),
+);
+
+export default class DocsRead extends BaseCommand<typeof DocsRead> {
+  static args = {
+    query: Args.string({
+      description: 'Search query for documentation (class name, module path, or partial match)',
+      required: true,
+    }),
+  };
+
+  static description = t('commands.docs.read.description', 'Read Script API documentation for a class or module');
+
+  static enableJsonFlag = true;
+
+  static examples = [
+    '<%= config.bin %> <%= command.id %> ProductMgr',
+    '<%= config.bin %> <%= command.id %> dw.catalog.ProductMgr',
+    '<%= config.bin %> <%= command.id %> "dw system Status"',
+    '<%= config.bin %> <%= command.id %> ProductMgr --raw',
+    '<%= config.bin %> <%= command.id %> ProductMgr --json',
+  ];
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    raw: Flags.boolean({
+      char: 'r',
+      description: 'Output raw markdown without terminal formatting',
+      default: false,
+    }),
+  };
+
+  async run(): Promise<ReadDocsResult> {
+    const {query} = this.args;
+    const {raw} = this.flags;
+
+    const result = readDocByQuery(query);
+
+    if (!result) {
+      this.error(t('commands.docs.read.notFound', 'No documentation found matching: {{query}}', {query}), {
+        suggestions: ['Try a broader search term', 'Use "b2c docs search <query>" to see available matches'],
+      });
+    }
+
+    if (this.jsonEnabled()) {
+      return result;
+    }
+
+    // Determine if we should render markdown for terminal
+    const useRaw = raw || !process.stdout.isTTY;
+
+    if (useRaw) {
+      process.stdout.write(result.content);
+    } else {
+      const rendered = marked.parse(result.content);
+      process.stdout.write(rendered as string);
+    }
+
+    return result;
+  }
+}

packages/b2c-cli/src/commands/docs/schema.ts

@@ -0,0 +1,92 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import {Args, Flags} from '@oclif/core';
+import {BaseCommand} from '@salesforce/b2c-tooling-sdk/cli';
+import {readSchemaByQuery, listSchemas, type SchemaEntry} from '@salesforce/b2c-tooling-sdk/operations/docs';
+import {t} from '../../i18n/index.js';
+
+interface SchemaResult {
+  entry: SchemaEntry;
+  content: string;
+}
+
+interface ListResult {
+  entries: SchemaEntry[];
+}
+
+export default class DocsSchema extends BaseCommand<typeof DocsSchema> {
+  static args = {
+    query: Args.string({
+      description: 'Schema name or partial match (e.g., "catalog", "order")',
+      required: false,
+    }),
+  };
+
+  static description = t('commands.docs.schema.description', 'Read an XSD schema file');
+
+  static enableJsonFlag = true;
+
+  static examples = [
+    '<%= config.bin %> <%= command.id %> catalog',
+    '<%= config.bin %> <%= command.id %> order',
+    '<%= config.bin %> <%= command.id %> --list',
+    '<%= config.bin %> <%= command.id %> catalog --json',
+  ];
+
+  static flags = {
+    ...BaseCommand.baseFlags,
+    list: Flags.boolean({
+      char: 'l',
+      description: 'List all available schemas',
+      default: false,
+    }),
+  };
+
+  async run(): Promise<ListResult | SchemaResult> {
+    const {query} = this.args;
+    const {list} = this.flags;
+
+    // List mode
+    if (list) {
+      const entries = listSchemas();
+
+      if (this.jsonEnabled()) {
+        return {entries};
+      }
+
+      this.log(t('commands.docs.schema.available', 'Available schemas:'));
+      for (const entry of entries) {
+        this.log(`  ${entry.id}`);
+      }
+      this.log('');
+      this.log(t('commands.docs.schema.count', '{{count}} schemas available', {count: entries.length}));
+
+      return {entries};
+    }
+
+    // Read mode requires query
+    if (!query) {
+      this.error(t('commands.docs.schema.queryRequired', 'Schema name is required. Use --list to see all schemas.'));
+    }
+
+    const result = readSchemaByQuery(query);
+
+    if (!result) {
+      this.error(t('commands.docs.schema.notFound', 'No schema found matching: {{query}}', {query}), {
+        suggestions: ['Try a broader search term', 'Use "b2c docs schema --list" to see available schemas'],
+      });
+    }
+
+    if (this.jsonEnabled()) {
+      return result;
+    }
+
+    // Output the schema content
+    process.stdout.write(result.content);
+
+    return result;
+  }
+}