a11y-devkit-deploy 0.8.7 → 0.8.8

package/README.md

@@ -199,17 +199,31 @@ Add an object to the `hostApplications` array with the host application's config
       "mcpServerKey": "servers",
       "skillsFolder": ".codeium/windsurf/skills",
       "mcpConfigFile": ".codeium/windsurf/mcp_config.json"
+    },
+    {
+      "id": "vscode",
+      "displayName": "VSCode",
+      "mcpServerKey": "servers",
+      "skillsFolder": ".github/skills",
+      "mcpConfigFile": ".github/mcp.json",
+      "globalMcpConfigFile": "Code/User/mcp.json"
     }
   ]
 }
 ```
 
+**Note:** The `globalMcpConfigFile` property is optional. When specified, the global MCP config path is relative to the platform's app support directory (AppData on Windows, Application Support on macOS) instead of the home directory.
+
 **Host Application Configuration Properties:**
 - `id` - Unique identifier for the host application
 - `displayName` - Human-readable name shown in prompts
 - `mcpServerKey` - MCP config key name (`"servers"` or `"mcpServers"`)
 - `skillsFolder` - Path to skills directory (relative to home/project root)
 - `mcpConfigFile` - Path to MCP config file (relative to home/project root)
+- `globalMcpConfigFile` - (Optional) Path to global MCP config relative to AppData/Application Support instead of home directory. Used for hosts like VSCode that store configs in platform-specific app directories:
+  - Windows: `%APPDATA%` (e.g., `C:\Users\name\AppData\Roaming`)
+  - macOS: `~/Library/Application Support`
+  - Linux: `$XDG_CONFIG_HOME` or `~/.config`
 
 ### Config Structure
 
@@ -265,7 +279,6 @@ your-project/
   ├── mcp.json              # Codex global MCP config
   └── skills/               # Codex global skills
 ~/.github/
-  ├── mcp.json              # VSCode global MCP config
   └── skills/               # VSCode global skills
 ~/.codeium/windsurf/
   ├── mcp_config.json       # Windsurf global MCP config
@@ -273,6 +286,10 @@ your-project/
 ~/.factory/
   ├── mcp.json              # Factory global MCP config
   └── skills/               # Factory global skills
+
+# VSCode MCP config lives in AppData/Application Support:
+# Windows: %APPDATA%/Code/User/mcp.json
+# macOS:   ~/Library/Application Support/Code/User/mcp.json
 ```
 
 **Note:** Paths are fully customizable per IDE in `config/a11y.json`

package/config/a11y.json

@@ -72,7 +72,8 @@
       "displayName": "VSCode",
       "mcpServerKey": "servers",
       "skillsFolder": ".github/skills",
-      "mcpConfigFile": ".github/mcp.json"
+      "mcpConfigFile": ".github/mcp.json",
+      "globalMcpConfigFile": "Code/User/mcp.json"
     },
     {
       "id": "windsurf",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a11y-devkit-deploy",
-  "version": "0.8.7",
+  "version": "0.8.8",
   "description": "CLI to deploy a11y skills and MCP servers across IDEs",
   "license": "MIT",
   "type": "module",

package/src/paths.js

@@ -32,19 +32,32 @@ function getAppSupportDir(platformInfo = getPlatform()) {
 
 function getHostApplicationPaths(projectRoot, platformInfo = getPlatform(), hostConfigs = []) {
   const home = os.homedir();
+  const appSupport = getAppSupportDir(platformInfo);
   const paths = {};
 
   for (const host of hostConfigs) {
-    // Default paths for both local and global scope
+    // Default paths for local scope (relative to home or project)
     const skillsFolder = host.skillsFolder || `.${host.id}/skills`;
     const mcpConfigFile = host.mcpConfigFile || `.${host.id}/mcp.json`;
 
+    // MCP config: use AppData/Application Support if globalMcpConfigFile specified, otherwise home
+    // appSupport resolves to:
+    //   - Windows: %APPDATA% (e.g., C:\Users\name\AppData\Roaming)
+    //   - macOS: ~/Library/Application Support
+    //   - Linux: $XDG_CONFIG_HOME or ~/.config
+    const globalMcpConfig = host.globalMcpConfigFile
+      ? path.join(appSupport, host.globalMcpConfigFile)
+      : path.join(home, mcpConfigFile);
+
+    // Skills always use home directory (skills live at project level, not in AppData)
+    const globalSkillsDir = path.join(home, skillsFolder);
+
     paths[host.id] = {
       name: host.displayName,
-      mcpConfig: path.join(home, mcpConfigFile),
+      mcpConfig: globalMcpConfig,
       localMcpConfig: path.join(projectRoot, mcpConfigFile),
       mcpServerKey: host.mcpServerKey,
-      skillsDir: path.join(home, skillsFolder),
+      skillsDir: globalSkillsDir,
       localSkillsDir: path.join(projectRoot, skillsFolder)
     };
   }