addressing review comments

Author: charithaT07

.changeset/add-update-warning.md

@@ -0,0 +1,5 @@
+---
+'@salesforce/b2c-cli': patch
+---
+
+Add update notifications that warn users when a newer version of the CLI is available

.changeset/am-topic-users-roles-orgs.md

@@ -0,0 +1,6 @@
+---
+'@salesforce/b2c-cli': patch
+'@salesforce/b2c-tooling-sdk': patch
+---
+
+Account Manager (AM) topic with `users`, `roles`, and `orgs` subtopics. Use `b2c am users`, `b2c am roles`, and `b2c am orgs` for user, role, and organization management.

.changeset/code-bugfix.md

@@ -14,7 +14,7 @@
         "name": "Salesforce"
       },
       "license": "Apache-2.0",
-      "source": "./plugins/b2c-cli",
+      "source": "./skills/b2c-cli",
       "category": "productivity",
       "strict": false
     },
@@ -25,7 +25,7 @@
         "name": "Salesforce"
       },
       "license": "Apache-2.0",
-      "source": "./plugins/b2c",
+      "source": "./skills/b2c",
       "category": "productivity",
       "strict": false
     }

.changeset/doc-improvements.md

@@ -0,0 +1,40 @@
+# Update Script API Documentation
+
+Download the latest B2C Commerce Script API documentation from the configured sandbox and update the bundled docs in the SDK.
+
+## Steps
+
+1. Download Script API docs from the configured sandbox using `./cli docs download`
+2. Replace the markdown files in `packages/b2c-tooling-sdk/data/script-api/`
+3. Regenerate the search index with `pnpm --filter @salesforce/b2c-tooling-sdk run generate:docs-index`
+4. Show the version extracted from `index.md` header
+5. Show git status/diff summary of what changed
+
+## Commands to Run
+
+```bash
+# Download to temp directory
+./cli docs download /tmp/script-api-docs-update
+
+# Check version
+head -1 /tmp/script-api-docs-update/index.md
+
+# Replace existing files
+rm -f packages/b2c-tooling-sdk/data/script-api/*.md
+cp /tmp/script-api-docs-update/*.md packages/b2c-tooling-sdk/data/script-api/
+
+# Regenerate index
+pnpm --filter @salesforce/b2c-tooling-sdk run generate:docs-index
+
+# Show changes
+git status packages/b2c-tooling-sdk/data/script-api/ --short
+git diff packages/b2c-tooling-sdk/data/script-api/*.md --stat
+
+# Cleanup
+rm -rf /tmp/script-api-docs-update
+```
+
+After running, summarize:
+- The Script API version (from index.md header like "# B2C Commerce Script API 26.2")
+- Number of files updated
+- Key changes (new classes, deprecated methods, etc.)

.changeset/friendly-sandbox-id.md

@@ -1,6 +1,8 @@
 ---
 name: api-client-development
 description: Creating API clients with OpenAPI specs, authentication, and OAuth scopes for SCAPI and similar APIs
+metadata:
+  internal: true
 ---
 
 # API Client Development