a11y-devkit-deploy 0.6.1 → 0.6.3

package/package.json

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

package/src/cli.js

@@ -17,6 +17,30 @@ async function loadConfig() {
   return JSON.parse(raw);
 }
 
+async function loadPackageJson() {
+  const pkgPath = path.join(__dirname, "..", "package.json");
+  const raw = await fs.readFile(pkgPath, "utf8");
+  return JSON.parse(raw);
+}
+
+const skillDescriptions = {
+  "a11y-base-web-skill": "Core accessibility testing utilities",
+  "a11y-issue-writer-skill": "Document accessibility issues",
+  "a11y-tester-skill": "Run accessibility tests",
+  "a11y-remediator-skill": "Fix accessibility issues",
+  "a11y-validator-skill": "Validate accessibility compliance",
+  "web-standards-skill": "Web standards reference",
+  "a11y-audit-fix-agent-orchestrator-skill": "Orchestrate accessibility audits"
+};
+
+const mcpDescriptions = {
+  "wcag": "WCAG guidelines reference",
+  "aria": "ARIA specification reference",
+  "magentaa11y": "MagentaA11y accessibility acceptance criteria tool",
+  "a11y-personas": "Accessibility personas and user scenarios",
+  "arc-issues": "Pre-formatted a11y issue templates"
+};
+
 function parseArgs(argv) {
   const args = new Set(argv.slice(2));
   return {
@@ -36,12 +60,26 @@ async function run() {
   const projectRoot = process.cwd();
   const platformInfo = getPlatform();
   const config = await loadConfig();
+  const pkg = await loadPackageJson();
   const idePaths = getIdePaths(projectRoot, platformInfo, config.ideSkillsPaths);
   const args = parseArgs(process.argv);
 
-  header("A11y Devkit Deploy", "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 description = skillDescriptions[skill] || "No description";
+    console.log(`${skill} - ${description}`);
+  });
+
+  console.log("\nMCP Servers to install:");
+  config.mcpServers.forEach((server) => {
+    const description = mcpDescriptions[server.name] || "No description";
+    console.log(`${server.name} - ${description}`);
+  });
+  console.log("");
+
   const ideChoices = [
     { title: "Claude Code", value: "claude" },
     { title: "Cursor", value: "cursor" },
@@ -50,6 +88,7 @@ async function run() {
   ];
 
   let scope = args.scope;
+  let mcpScope = null;
   let ideSelection = ["claude", "cursor", "codex", "vscode"];
   let installSkills = true;
 
@@ -61,11 +100,29 @@ async function run() {
           name: "scope",
           message: "Install skills + repo locally or globally?",
           choices: [
-            { title: "Local to this project", value: "local" },
+            { title: `Local to this project (${formatPath(projectRoot)})`, value: "local" },
             { title: "Global for this user", value: "global" }
           ],
           initial: 0
         },
+        {
+          type: "select",
+          name: "mcpScope",
+          message: "Install MCP configs locally or globally?",
+          choices: [
+            {
+              title: `Local to this project (${formatPath(projectRoot)})`,
+              value: "local",
+              description: "Write to .claude/mcp.json, .cursor/mcp.json, etc. (version-controllable)"
+            },
+            {
+              title: "Global for this user",
+              value: "global",
+              description: "Write to ~/Library/Application Support/{IDE}/mcp.json"
+            }
+          ],
+          initial: 0
+        },
         {
           type: "multiselect",
           name: "ides",
@@ -91,6 +148,7 @@ async function run() {
     );
 
     scope = scope || response.scope;
+    mcpScope = response.mcpScope || "local";
     ideSelection = response.ides || ideSelection;
     installSkills = response.installSkills;
   }
@@ -98,13 +156,17 @@ async function run() {
   if (!scope) {
     scope = "local";
   }
+  if (!mcpScope) {
+    mcpScope = "local";
+  }
 
   if (!ideSelection.length) {
     warn("No IDEs selected. MCP installation requires at least one IDE.");
     process.exit(1);
   }
 
-  info(`Install scope: ${scope === "local" ? "Local" : "Global"}`);
+  info(`Skills scope: ${scope === "local" ? "Local" : "Global"}`);
+  info(`MCP scope: ${mcpScope === "local" ? "Local" : "Global"}`);
 
   // Create temp directory for npm install
   const tempDir = path.join(getTempDir(), `.a11y-devkit-${Date.now()}`);
@@ -128,10 +190,19 @@ async function run() {
 
   // Configure MCP servers using npx (no local installation needed!)
   const mcpSpinner = startSpinner("Updating MCP configurations...");
-  for (const ide of ideSelection) {
-    await installMcpConfig(idePaths[ide].mcpConfig, config.mcpServers, idePaths[ide].mcpServerKey);
+  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
+    );
   }
-  mcpSpinner.succeed(`MCP configs updated for ${ideSelection.length} IDE(s).`);
+  mcpSpinner.succeed(`MCP configs updated for ${ideSelection.length} IDE(s) (${mcpScope} scope).`);
 
   // Clean up temporary directory
   const cleanupSpinner = startSpinner("Cleaning up temporary files...");

package/src/paths.js

@@ -47,6 +47,7 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     claude: {
       name: "Claude Code",
       mcpConfig: path.join(appSupport, "Claude", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, ".claude", "mcp.json"),
       mcpServerKey: "servers",
       skillsDir: path.join(home, skillsPaths.claude),
       localSkillsDir: path.join(projectRoot, skillsPaths.claude)
@@ -54,6 +55,7 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     cursor: {
       name: "Cursor",
       mcpConfig: path.join(appSupport, "Cursor", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, ".cursor", "mcp.json"),
       mcpServerKey: "mcpServers",
       skillsDir: path.join(home, skillsPaths.cursor),
       localSkillsDir: path.join(projectRoot, skillsPaths.cursor)
@@ -61,6 +63,7 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     codex: {
       name: "Codex",
       mcpConfig: path.join(home, ".codex", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, ".codex", "mcp.json"),
       mcpServerKey: "servers",
       skillsDir: path.join(home, skillsPaths.codex),
       localSkillsDir: path.join(projectRoot, skillsPaths.codex)
@@ -68,6 +71,7 @@ function getIdePaths(projectRoot, platformInfo = getPlatform(), ideSkillsPaths =
     vscode: {
       name: "VSCode",
       mcpConfig: path.join(appSupport, "Code", "User", "mcp.json"),
+      localMcpConfig: path.join(projectRoot, ".vscode", "mcp.json"),
       mcpServerKey: "servers",
       skillsDir: path.join(home, skillsPaths.vscode),
       localSkillsDir: path.join(projectRoot, skillsPaths.vscode)