cap skill improvements

Author: clavery

packages/b2c-vs-extension/src/cap/index.ts

@@ -17,7 +17,11 @@ const CAP_DIRECTORIES_CONTEXT_KEY = 'b2c-dx.capDirectories';
  * - Context key: tracks CAP directories so the context menu only appears on CAP folders
  * - Install command: right-click a CAP folder to install it
  */
-export function registerCap(context: vscode.ExtensionContext, configProvider: B2CExtensionConfig): void {
+export function registerCap(
+  context: vscode.ExtensionContext,
+  configProvider: B2CExtensionConfig,
+  log: vscode.OutputChannel,
+): void {
   // File decoration provider
   const decorator = new CapFileDecorationProvider();
   context.subscriptions.push(vscode.window.registerFileDecorationProvider(decorator));
@@ -33,14 +37,18 @@ export function registerCap(context: vscode.ExtensionContext, configProvider: B2
     for (const u of capUris) {
       obj[u] = true;
     }
+    log.appendLine(`CAP: setting context with ${capUris.size} directory(ies): ${[...capUris].join(', ')}`);
     vscode.commands.executeCommand('setContext', CAP_DIRECTORIES_CONTEXT_KEY, obj);
   }
 
   async function scanCapDirectories(): Promise<void> {
     capUris.clear();
+    log.appendLine('CAP: scanning workspace for commerce-app.json files...');
     const files = await vscode.workspace.findFiles('**/commerce-app.json');
+    log.appendLine(`CAP: found ${files.length} commerce-app.json file(s)`);
     for (const f of files) {
       const dirUri = vscode.Uri.file(path.dirname(f.fsPath));
+      log.appendLine(`CAP: registered directory ${dirUri.toString()}`);
       capUris.add(dirUri.toString());
     }
     updateCapContext();

packages/b2c-vs-extension/src/extension.ts

@@ -401,7 +401,7 @@ async function activateInner(context: vscode.ExtensionContext, log: vscode.Outpu
     registerApiBrowser(context, configProvider, log);
   }
   if (settings.get<boolean>('features.cap', true)) {
-    registerCap(context, configProvider);
+    registerCap(context, configProvider, log);
   }
 
   registerDebugger(context, configProvider);

skills/b2c-cli/skills/b2c-cap/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: b2c-cap
-description: Manage Commerce App Packages (CAPs) and commerce features using the b2c CLI. Use when validating, packaging, installing, uninstalling, listing, or pulling Commerce App Packages and commerce features on B2C Commerce instances, viewing configuration tasks, or pulling app sources for cartridge deployment or Storefront Next development.
+description: Manage Commerce App Packages (CAPs), also called commerce apps or apps, and commerce features using the b2c CLI. Use this skill whenever the user needs to validate, package, install, uninstall, list, or pull commerce apps on B2C Commerce instances, view configuration tasks, or pull app sources for cartridge deployment or Storefront Next development. Also use when checking which apps are installed on an instance, inspecting app details or versions, or managing app lifecycle — even if they just say "what apps do I have", "list my commerce apps", "which CAPs are installed", "install this app", "pull app sources", or "show installed apps".
 ---
 
 # B2C CAP Skill