a11y-devkit-deploy 0.9.2 → 0.9.4

package/README.md

@@ -64,7 +64,7 @@ All MCP servers are configured to run via `npx`, which means:
 
 This CLI automates the setup of accessibility tooling by:
 
-1. **Installing skills from npm** - Downloads and installs accessibility skill packages (configurable in `config/a11y.json`)
+1. **Installing skills from npm** - Downloads and installs accessibility skill packages (configurable in `config/settings.json`)
 2. **Configuring MCP servers** - Updates each IDE's MCP config to enable accessibility-focused MCP servers (also configurable)
 
 **Default configuration includes:**
@@ -80,7 +80,7 @@ This CLI automates the setup of accessibility tooling by:
 
 ## Why This Tool?
 
-**Zero Hardcoded Values** - Every aspect of the tool is driven by `config/a11y.json`:
+**Zero Hardcoded Values** - Every aspect of the tool is driven by `config/settings.json`:
 - IDE paths and configuration files
 - Skills to install
 - MCP servers to configure
@@ -104,7 +104,7 @@ This CLI automates the setup of accessibility tooling by:
 
 ### Skills Installed (Default)
 
-The following skill packages are installed from npm by default. **Add your own by editing `config/a11y.json`**:
+The following skill packages are installed from npm by default. **Add your own by editing `config/settings.json`**:
 
 | Skill | Package | Description |
 |-------|---------|-------------|
@@ -143,7 +143,7 @@ The generated MCP config looks like this:
 
 ## Configuration
 
-The entire tool is **fully config-driven**. Edit `config/a11y.json` to customize everything without touching code.
+The entire tool is **fully config-driven**. Edit `config/settings.json` to customize everything without touching code.
 
 ### Adding a New Skill
 
@@ -218,14 +218,21 @@ Add an object to the `hostApplications` array with the host application's config
 **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"`)
+- `mcpServerKey` - MCP config key name (`"servers"`, `"mcpServers"`, or `"mcp_servers"` for TOML)
 - `skillsFolder` - Path to skills directory (relative to home/project root)
-- `mcpConfigFile` - Path to MCP config file (relative to home/project root)
+- `mcpConfigFile` - Path to MCP config file (relative to home/project root). Supports both JSON (`.json`) and TOML (`.toml`) formats. TOML format is auto-detected by file extension (used by Codex).
 - `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`
 
+**Note:** Codex uses TOML format for its MCP configuration (`~/.codex/config.toml`), which requires the `mcpServerKey` to be `"mcp_servers"` and generates config entries like:
+```toml
+[mcp_servers.magentaa11y]
+command = "npx"
+args = ["-y", "magentaa11y-mcp"]
+```
+
 ### Config Structure
 
 - `skillsFolder` - Subfolder name to bundle skills under (e.g., "a11y")
@@ -255,7 +262,7 @@ your-project/
 │   ├── mcp.json            # Cursor MCP config
 │   └── skills/             # Cursor skills
 ├── .codex/
-│   ├── mcp.json            # Codex MCP config
+│   ├── config.toml         # Codex MCP config
 │   └── skills/             # Codex skills
 ├── .github/
 │   ├── mcp.json            # VSCode MCP config
@@ -277,7 +284,7 @@ your-project/
   ├── mcp.json              # Cursor global MCP config
   └── skills/               # Cursor global skills
 ~/.codex/
-  ├── mcp.json              # Codex global MCP config
+  ├── config.toml           # Codex global MCP config
   └── skills/               # Codex global skills
 ~/.github/
   └── skills/               # VSCode global skills
@@ -293,11 +300,11 @@ your-project/
 # macOS:   ~/Library/Application Support/Code/User/mcp.json
 ```
 
-**Note:** Paths are fully customizable per IDE in `config/a11y.json`
+**Note:** Paths are fully customizable per IDE in `config/settings.json`
 
 ## MCP Servers Included (Default)
 
-**Add your own by editing `config/a11y.json`**:
+**Add your own by editing `config/settings.json`**:
 
 | Server | Package | Description |
 |--------|---------|-------------|
@@ -309,7 +316,7 @@ your-project/
 
 ## Complete Config Example
 
-Here's what a complete `config/a11y.json` looks like:
+Here's what a complete `config/settings.json` looks like:
 
 ```json
 {
@@ -366,3 +373,4 @@ Here's what a complete `config/a11y.json` looks like:
 ```
 
 Everything is customizable - add, remove, or modify any section to match your needs.
+

package/config/{a11y.json → settings.json}

@@ -63,9 +63,9 @@
     {
       "id": "codex",
       "displayName": "Codex",
-      "mcpServerKey": "servers",
+      "mcpServerKey": "mcp_servers",
       "skillsFolder": ".codex/skills",
-      "mcpConfigFile": ".codex/mcp.json"
+      "mcpConfigFile": ".codex/config.toml"
     },
     {
       "id": "vscode",

package/package.json

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

package/src/cli.js

@@ -34,7 +34,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 async function loadConfig() {
-  const configPath = path.join(__dirname, "..", "config", "a11y.json");
+  const configPath = path.join(__dirname, "..", "config", "settings.json");
   const raw = await fs.readFile(configPath, "utf8");
   return JSON.parse(raw);
 }
@@ -733,3 +733,4 @@ async function runGitMcpInstallation(projectRoot, platformInfo, config, hostPath
 }
 
 export { run };
+

package/src/installers/mcp.js

@@ -10,6 +10,10 @@ async function pathExists(target) {
   }
 }
 
+function isTomlFile(filePath) {
+  return filePath.endsWith('.toml');
+}
+
 async function loadJson(filePath) {
   if (!(await pathExists(filePath))) {
     return {};
@@ -25,6 +29,120 @@ async function loadJson(filePath) {
   }
 }
 
+// Simple TOML parser for MCP server configs
+function parseSimpleToml(content) {
+  const result = {};
+  const lines = content.split('\n');
+  let currentSection = null;
+  let currentTable = null;
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+
+    // Skip empty lines and comments
+    if (!trimmed || trimmed.startsWith('#')) continue;
+
+    // Parse table headers like [mcp_servers.name]
+    const tableMatch = trimmed.match(/^\[([^\]]+)\]$/);
+    if (tableMatch) {
+      const parts = tableMatch[1].split('.');
+      if (parts.length === 2) {
+        const [section, table] = parts;
+        if (!result[section]) result[section] = {};
+        if (!result[section][table]) result[section][table] = {};
+        currentSection = section;
+        currentTable = table;
+      }
+      continue;
+    }
+
+    // Parse key-value pairs
+    const kvMatch = trimmed.match(/^(\w+)\s*=\s*(.+)$/);
+    if (kvMatch && currentSection && currentTable) {
+      const [, key, value] = kvMatch;
+
+      // Parse arrays like ["a", "b"]
+      if (value.startsWith('[')) {
+        const arrayMatch = value.match(/\[(.*)\]/);
+        if (arrayMatch) {
+          const items = arrayMatch[1].split(',').map(item => {
+            const trimmedItem = item.trim();
+            // Remove quotes
+            if (trimmedItem.startsWith('"') && trimmedItem.endsWith('"')) {
+              return trimmedItem.slice(1, -1);
+            }
+            return trimmedItem;
+          });
+          result[currentSection][currentTable][key] = items;
+        }
+      }
+      // Parse strings
+      else if (value.startsWith('"') && value.endsWith('"')) {
+        result[currentSection][currentTable][key] = value.slice(1, -1);
+      }
+      // Parse other values
+      else {
+        result[currentSection][currentTable][key] = value;
+      }
+    }
+  }
+
+  return result;
+}
+
+// Simple TOML stringifier for MCP server configs
+function stringifySimpleToml(obj) {
+  const lines = [];
+
+  for (const [section, tables] of Object.entries(obj)) {
+    if (typeof tables !== 'object' || tables === null) continue;
+
+    for (const [tableName, config] of Object.entries(tables)) {
+      if (typeof config !== 'object' || config === null) continue;
+
+      // Write table header [section.tableName]
+      lines.push(`[${section}.${tableName}]`);
+
+      // Write key-value pairs
+      for (const [key, value] of Object.entries(config)) {
+        if (Array.isArray(value)) {
+          // Format arrays
+          const arrayStr = value.map(v => `"${v}"`).join(', ');
+          lines.push(`${key} = [${arrayStr}]`);
+        } else if (typeof value === 'string') {
+          lines.push(`${key} = "${value}"`);
+        } else {
+          lines.push(`${key} = ${value}`);
+        }
+      }
+
+      // Add blank line between tables
+      lines.push('');
+    }
+  }
+
+  return lines.join('\n');
+}
+
+async function loadToml(filePath) {
+  if (!(await pathExists(filePath))) {
+    return {};
+  }
+
+  try {
+    const raw = await fs.readFile(filePath, "utf8");
+    return raw.trim() ? parseSimpleToml(raw) : {};
+  } catch (error) {
+    const backupPath = `${filePath}.bak`;
+    await fs.copyFile(filePath, backupPath);
+    return {};
+  }
+}
+
+async function loadConfig(filePath) {
+  return isTomlFile(filePath) ? loadToml(filePath) : loadJson(filePath);
+}
+
 function mergeServers(existing, incoming, serverKey = "servers") {
   const existingServers = existing[serverKey] && typeof existing[serverKey] === "object"
     ? existing[serverKey]
@@ -84,9 +202,14 @@ function removeServers(existing, removeNames, serverKey = "servers") {
 
 async function installMcpConfig(configPath, servers, serverKey = "servers") {
   await fs.mkdir(path.dirname(configPath), { recursive: true });
-  const existing = await loadJson(configPath);
+  const existing = await loadConfig(configPath);
   const updated = mergeServers(existing, servers, serverKey);
-  await fs.writeFile(configPath, `${JSON.stringify(updated, null, 2)}\n`, "utf8");
+
+  if (isTomlFile(configPath)) {
+    await fs.writeFile(configPath, stringifySimpleToml(updated), "utf8");
+  } else {
+    await fs.writeFile(configPath, `${JSON.stringify(updated, null, 2)}\n`, "utf8");
+  }
 }
 
 async function removeMcpConfig(configPath, serverNames, serverKey = "servers") {
@@ -94,14 +217,18 @@ async function removeMcpConfig(configPath, serverNames, serverKey = "servers") {
     return { removed: 0, changed: false };
   }
 
-  const existing = await loadJson(configPath);
+  const existing = await loadConfig(configPath);
   const { updated, removed } = removeServers(existing, serverNames, serverKey);
 
   if (removed === 0) {
     return { removed: 0, changed: false };
   }
 
-  await fs.writeFile(configPath, `${JSON.stringify(updated, null, 2)}\n`, "utf8");
+  if (isTomlFile(configPath)) {
+    await fs.writeFile(configPath, stringifySimpleToml(updated), "utf8");
+  } else {
+    await fs.writeFile(configPath, `${JSON.stringify(updated, null, 2)}\n`, "utf8");
+  }
   return { removed, changed: true };
 }