a11y-devkit-deploy 0.7.0 → 0.7.1

package/config/a11y.json

@@ -31,18 +31,50 @@
       "description": "Orchestrate accessibility audits"
     }
   ],
-  "ideSkillsPaths": {
-    "claude": ".claude/skills",
-    "cursor": ".cursor/skills",
-    "codex": ".codex/skills",
-    "vscode": ".github/skills"
-  },
-  "ideMcpPaths": {
-    "claude": ".claude/mcp.json",
-    "cursor": ".cursor/mcp.json",
-    "codex": ".codex/mcp.json",
-    "vscode": ".github/mcp.json"
-  },
+  "ides": [
+    {
+      "id": "claude",
+      "displayName": "Claude Code",
+      "mcpServerKey": "servers",
+      "skillsFolder": ".claude/skills",
+      "mcpConfigFile": ".claude/mcp.json"
+    },
+    {
+      "id": "cursor",
+      "displayName": "Cursor",
+      "mcpServerKey": "mcpServers",
+      "skillsFolder": ".cursor/skills",
+      "mcpConfigFile": ".cursor/mcp.json"
+    },
+    {
+      "id": "codex",
+      "displayName": "Codex",
+      "mcpServerKey": "servers",
+      "skillsFolder": ".codex/skills",
+      "mcpConfigFile": ".codex/mcp.json"
+    },
+    {
+      "id": "vscode",
+      "displayName": "VSCode",
+      "mcpServerKey": "servers",
+      "skillsFolder": ".github/skills",
+      "mcpConfigFile": ".github/mcp.json"
+    },
+    {
+      "id": "windsurf",
+      "displayName": "Windsurf",
+      "mcpServerKey": "servers",
+      "skillsFolder": ".codeium/windsurf/skills",
+      "mcpConfigFile": ".codeium/windsurf/mcp_config.json"
+    },
+    {
+      "id": "factory",
+      "displayName": "Factory",
+      "mcpServerKey": "mcpServers",
+      "skillsFolder": ".factory/skills",
+      "mcpConfigFile": ".factory/mcp.json"
+    }
+  ],
   "mcpServers": [
     {
       "name": "wcag",

package/package.json

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

package/src/cli.js

@@ -27,7 +27,11 @@ function parseArgs(argv) {
   const args = new Set(argv.slice(2));
   return {
     autoYes: args.has("--yes") || args.has("-y"),
-    scope: args.has("--global") ? "global" : args.has("--local") ? "local" : null
+    scope: args.has("--global")
+      ? "global"
+      : args.has("--local")
+        ? "local"
+        : null,
   };
 }
 
@@ -43,17 +47,23 @@ async function run() {
   const platformInfo = getPlatform();
   const config = await loadConfig();
   const pkg = await loadPackageJson();
-  const idePaths = getIdePaths(projectRoot, platformInfo, config.ideSkillsPaths, config.ideMcpPaths);
+  const idePaths = getIdePaths(projectRoot, platformInfo, config.ides);
   const args = parseArgs(process.argv);
 
-  header(`A11y Devkit Deploy v${pkg.version}`, "Install skills + MCP servers across IDEs");
+  header(
+    `A11y Devkit Deploy v${pkg.version}`,
+    "Install skills + MCP servers across IDEs",
+  );
   info(`Detected OS: ${formatOs(platformInfo)}`);
 
   console.log("\nSkills to install:");
   config.skills.forEach((skill) => {
     const name = typeof skill === "string" ? skill : skill.name;
-    const description = typeof skill === "string" ? "No description" : (skill.description || "No description");
-    console.log(`${name} - ${description}`);
+    const description =
+      typeof skill === "string"
+        ? "No description"
+        : skill.description || "No description";
+    console.log(`- ${name}: ${description}`);
   });
 
   console.log("\nMCP Servers to install:");
@@ -63,16 +73,14 @@ async function run() {
   });
   console.log("");
 
-  const ideChoices = [
-    { title: "Claude Code", value: "claude" },
-    { title: "Cursor", value: "cursor" },
-    { title: "Codex", value: "codex" },
-    { title: "VSCode", value: "vscode" }
-  ];
+  const ideChoices = config.ides.map((ide) => ({
+    title: ide.displayName,
+    value: ide.id,
+  }));
 
   let scope = args.scope;
   let mcpScope = null;
-  let ideSelection = ["claude", "cursor", "codex", "vscode"];
+  let ideSelection = config.ides.map((ide) => ide.id);
   let installSkills = true;
 
   if (!args.autoYes) {
@@ -83,10 +91,13 @@ async function run() {
           name: "scope",
           message: "Install skills + repo locally or globally?",
           choices: [
-            { title: `Local to this project (${formatPath(projectRoot)})`, value: "local" },
-            { title: "Global for this user", value: "global" }
+            {
+              title: `Local to this project (${formatPath(projectRoot)})`,
+              value: "local",
+            },
+            { title: "Global for this user", value: "global" },
           ],
-          initial: 0
+          initial: 0,
         },
         {
           type: "select",
@@ -96,22 +107,23 @@ async function run() {
             {
               title: `Local to this project (${formatPath(projectRoot)})`,
               value: "local",
-              description: "Write to project-level IDE config folders (version-controllable)"
+              description:
+                "Write to project-level IDE config folders (version-controllable)",
             },
             {
               title: "Global for this user",
               value: "global",
-              description: "Write to user-level IDE config folders"
-            }
+              description: "Write to user-level IDE config folders",
+            },
           ],
-          initial: 0
+          initial: 0,
         },
         {
           type: "multiselect",
           name: "ides",
           message: "Configure MCP for which IDEs?",
           choices: ideChoices,
-          initial: ideChoices.map((_, index) => index)
+          initial: ideChoices.map((_, index) => index),
         },
         {
           type: "toggle",
@@ -119,15 +131,15 @@ async function run() {
           message: "Install skills into IDE skills folders?",
           active: "yes",
           inactive: "no",
-          initial: true
-        }
+          initial: true,
+        },
       ],
       {
         onCancel: () => {
           warn("Setup cancelled.");
           process.exit(0);
-        }
-      }
+        },
+      },
     );
 
     scope = scope || response.scope;
@@ -158,13 +170,24 @@ async function run() {
     const skillsSpinner = startSpinner("Installing skills from npm...");
 
     try {
-      const skillTargets = scope === "local"
-        ? ideSelection.map((ide) => idePaths[ide].localSkillsDir)
-        : ideSelection.map((ide) => idePaths[ide].skillsDir);
-
-      const skillNames = config.skills.map((skill) => typeof skill === "string" ? skill : skill.name);
-      const result = await installSkillsFromNpm(skillNames, skillTargets, tempDir, config.skillsFolder, config.readmeTemplate);
-      skillsSpinner.succeed(`${result.installed} skills installed to ${skillTargets.length} IDE location(s).`);
+      const skillTargets =
+        scope === "local"
+          ? ideSelection.map((ide) => idePaths[ide].localSkillsDir)
+          : ideSelection.map((ide) => idePaths[ide].skillsDir);
+
+      const skillNames = config.skills.map((skill) =>
+        typeof skill === "string" ? skill : skill.name,
+      );
+      const result = await installSkillsFromNpm(
+        skillNames,
+        skillTargets,
+        tempDir,
+        config.skillsFolder,
+        config.readmeTemplate,
+      );
+      skillsSpinner.succeed(
+        `${result.installed} skills installed to ${skillTargets.length} IDE location(s).`,
+      );
     } catch (error) {
       skillsSpinner.fail(`Failed to install skills: ${error.message}`);
     }
@@ -174,19 +197,22 @@ async function run() {
 
   // Configure MCP servers using npx (no local installation needed!)
   const mcpSpinner = startSpinner("Updating MCP configurations...");
-  const mcpConfigPaths = mcpScope === "local"
-    ? ideSelection.map((ide) => idePaths[ide].localMcpConfig)
-    : ideSelection.map((ide) => idePaths[ide].mcpConfig);
+  const mcpConfigPaths =
+    mcpScope === "local"
+      ? ideSelection.map((ide) => idePaths[ide].localMcpConfig)
+      : ideSelection.map((ide) => idePaths[ide].mcpConfig);
 
   for (let i = 0; i < ideSelection.length; i++) {
     const ide = ideSelection[i];
     await installMcpConfig(
       mcpConfigPaths[i],
       config.mcpServers,
-      idePaths[ide].mcpServerKey
+      idePaths[ide].mcpServerKey,
     );
   }
-  mcpSpinner.succeed(`MCP configs updated for ${ideSelection.length} IDE(s) (${mcpScope} scope).`);
+  mcpSpinner.succeed(
+    `MCP configs updated for ${ideSelection.length} IDE(s) (${mcpScope} scope).`,
+  );
 
   // Clean up temporary directory
   const cleanupSpinner = startSpinner("Cleaning up temporary files...");
@@ -199,17 +225,18 @@ async function run() {
   console.log("");
   success("Next Steps:");
   const skillsFolderPath = config.skillsFolder ? `${config.skillsFolder}/` : "";
-  const skillsPath = scope === "local"
-    ? `.claude/skills/${skillsFolderPath}README.md (or your IDE's equivalent)`
-    : `~/.claude/skills/${skillsFolderPath}README.md (or your IDE's global skills directory)`;
+  const skillsPath =
+    scope === "local"
+      ? `.claude/skills/${skillsFolderPath}README.md (or your IDE's equivalent)`
+      : `~/.claude/skills/${skillsFolderPath}README.md (or your IDE's global skills directory)`;
   info(`📖 Check ${skillsPath} for comprehensive usage guide`);
   info("✨ Includes 70+ example prompts for all skills and MCP servers");
-  info("🚀 Start with the 'Getting Started' section for your first accessibility check");
+  info(
+    "🚀 Start with the 'Getting Started' section for your first accessibility check",
+  );
   console.log("");
   info("You can re-run this CLI any time to update skills and configs.");
   info("Documentation: https://github.com/joe-watkins/a11y-devkit#readme");
 }
 
-export {
-  run
-};
+export { run };

package/src/paths.js

@@ -30,60 +30,26 @@ function getAppSupportDir(platformInfo = getPlatform()) {
   return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
 }
 
-function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths = null, ideMcpPaths = null) {
-  const appSupport = getAppSupportDir(platformInfo);
+function getIdePaths(projectRoot, platformInfo = getPlatform(), ideConfigs = []) {
   const home = os.homedir();
+  const paths = {};
+
+  for (const ide of ideConfigs) {
+    // Use custom paths from config, or fall back to default pattern: ~/.{id}/
+    const skillsFolder = ide.skillsFolder || `.${ide.id}/skills`;
+    const mcpConfigFile = ide.mcpConfigFile || `.${ide.id}/mcp.json`;
+
+    paths[ide.id] = {
+      name: ide.displayName,
+      mcpConfig: path.join(home, mcpConfigFile),
+      localMcpConfig: path.join(projectRoot, mcpConfigFile),
+      mcpServerKey: ide.mcpServerKey,
+      skillsDir: path.join(home, skillsFolder),
+      localSkillsDir: path.join(projectRoot, skillsFolder)
+    };
+  }
 
-  // Default paths if not provided via config
-  const skillsPaths = ideSkillsPaths || {
-    claude: ".claude/skills",
-    cursor: ".cursor/skills",
-    codex: ".codex/skills",
-    vscode: ".vscode/skills",
-    local: ".github/skills"
-  };
-
-  const mcpPaths = ideMcpPaths || {
-    claude: ".claude/mcp.json",
-    cursor: ".cursor/mcp.json",
-    codex: ".codex/mcp.json",
-    vscode: ".vscode/mcp.json"
-  };
-
-  return {
-    claude: {
-      name: "Claude Code",
-      mcpConfig: path.join(appSupport, "Claude", "mcp.json"),
-      localMcpConfig: path.join(projectRoot, mcpPaths.claude),
-      mcpServerKey: "servers",
-      skillsDir: path.join(home, skillsPaths.claude),
-      localSkillsDir: path.join(projectRoot, skillsPaths.claude)
-    },
-    cursor: {
-      name: "Cursor",
-      mcpConfig: path.join(appSupport, "Cursor", "mcp.json"),
-      localMcpConfig: path.join(projectRoot, mcpPaths.cursor),
-      mcpServerKey: "mcpServers",
-      skillsDir: path.join(home, skillsPaths.cursor),
-      localSkillsDir: path.join(projectRoot, skillsPaths.cursor)
-    },
-    codex: {
-      name: "Codex",
-      mcpConfig: path.join(home, ".codex", "mcp.json"),
-      localMcpConfig: path.join(projectRoot, mcpPaths.codex),
-      mcpServerKey: "servers",
-      skillsDir: path.join(home, skillsPaths.codex),
-      localSkillsDir: path.join(projectRoot, skillsPaths.codex)
-    },
-    vscode: {
-      name: "VSCode",
-      mcpConfig: path.join(appSupport, "Code", "User", "mcp.json"),
-      localMcpConfig: path.join(projectRoot, mcpPaths.vscode),
-      mcpServerKey: "servers",
-      skillsDir: path.join(home, skillsPaths.vscode),
-      localSkillsDir: path.join(projectRoot, skillsPaths.vscode)
-    }
-  };
+  return paths;
 }
 
 export {