aicm 0.10.0 → 0.11.0

package/README.md

@@ -2,13 +2,14 @@
 
 > Agentic IDE Configuration Manager
 
-A CLI tool for syncing and managing Agentic IDE rules across projects
+A CLI tool for managing Agentic IDE configurations across projects
 
-## Why
+https://github.com/user-attachments/assets/e80dedbc-89c4-4747-9acf-b7ecb7493fcc
 
-With the rise of Agentic IDEs like cursor and windsurf, we have an opportunity to enforce best practices through rules. However, these rules are typically isolated within individual developers or projects.
+## Why
 
-**aicm** is a CLI tool for distributing Agentic IDE configurations, rules, and MCPs across projects. It leverages package managers to copy configurations from node_modules to the correct locations in your file system.
+With the rise of Agentic IDEs, we have an opportunity to enforce best practices through rules. However, these rules are typically isolated within individual projects.
+**aicm** is a CLI tool for distributing Agentic IDE configurations, rules, and MCPs across projects. It leverages node package managers, copy configurations from node_modules to the correct locations in your file system.
 
 ## Getting Started
 
@@ -33,6 +34,11 @@ In your project's `aicm.json`, reference the package and the specific rule:
   "rules": {
     "typescript": "@myteam/ai-tools/rules/typescript.mdc",
     "react": "@myteam/ai-tools/rules/react.mdc"
+  },
+  "mcpServers": {
+    "my-mcp": {
+      "url": "https://example.com/sse"
+    }
   }
 }
 ```
@@ -47,7 +53,7 @@ In your project's `aicm.json`, reference the package and the specific rule:
 }
 ```
 
-Now the rules will be linked to `.cursor/rules/aicm/` when you run `npm install`.
+Now, when you run `npm install`, the rules will be added to `.cursor/rules/aicm/` and the mcps to `.cursor/mcp.json`.
 
 ### Using Presets
 

package/dist/commands/install.js

@@ -10,11 +10,10 @@ const config_1 = require("../utils/config");
 const rule_detector_1 = require("../utils/rule-detector");
 const rule_collector_1 = require("../utils/rule-collector");
 const rule_writer_1 = require("../utils/rule-writer");
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const node_path_1 = __importDefault(require("node:path"));
 const ci_info_1 = require("ci-info");
 const discovery_1 = require("./workspaces/discovery");
 const workspaces_install_1 = require("./workspaces/workspaces-install");
+const mcp_writer_1 = require("../utils/mcp-writer");
 /**
  * Helper function to execute a function within a specific working directory
  * and ensure the original directory is always restored
@@ -33,27 +32,6 @@ async function withWorkingDirectory(targetDir, fn) {
         }
     }
 }
-/**
- * Write MCP servers configuration to IDE targets
- * @param mcpServers The MCP servers configuration
- * @param ides The IDEs to write to
- * @param cwd The current working directory
- */
-function writeMcpServersToTargets(mcpServers, ides, cwd) {
-    if (!mcpServers)
-        return;
-    for (const ide of ides) {
-        let mcpPath = null;
-        if (ide === "cursor") {
-            mcpPath = node_path_1.default.join(cwd, ".cursor", "mcp.json");
-            fs_extra_1.default.ensureDirSync(node_path_1.default.dirname(mcpPath));
-        }
-        // Windsurf does not support project mcpServers, so skip
-        if (mcpPath) {
-            fs_extra_1.default.writeJsonSync(mcpPath, { mcpServers }, { spaces: 2 });
-        }
-    }
-}
 /**
  * Checks if the current environment is a CI environment
  * This function respects any explicit settings in process.env.CI
@@ -223,7 +201,7 @@ async function install(options = {}) {
         if (config.mcpServers) {
             // Filter out canceled servers
             const filteredMcpServers = Object.fromEntries(Object.entries(config.mcpServers).filter(([, v]) => v !== false));
-            writeMcpServersToTargets(filteredMcpServers, config.ides, cwd);
+            (0, mcp_writer_1.writeMcpServersToTargets)(filteredMcpServers, config.ides, cwd);
         }
         return {
             success: true,

package/dist/utils/mcp-writer.d.ts

@@ -0,0 +1,14 @@
+import { Config } from "../types";
+/**
+ * Write MCP servers configuration to IDE targets
+ * @param mcpServers The MCP servers configuration
+ * @param ides The IDEs to write to
+ * @param cwd The current working directory
+ */
+export declare function writeMcpServersToTargets(mcpServers: Config["mcpServers"], ides: string[], cwd: string): void;
+/**
+ * Write MCP servers configuration to a specific file
+ * @param mcpServers The MCP servers configuration
+ * @param mcpPath The path to the mcp.json file
+ */
+export declare function writeMcpServersToFile(mcpServers: Config["mcpServers"], mcpPath: string): void;

package/dist/utils/mcp-writer.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeMcpServersToTargets = writeMcpServersToTargets;
+exports.writeMcpServersToFile = writeMcpServersToFile;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Write MCP servers configuration to IDE targets
+ * @param mcpServers The MCP servers configuration
+ * @param ides The IDEs to write to
+ * @param cwd The current working directory
+ */
+function writeMcpServersToTargets(mcpServers, ides, cwd) {
+    if (!mcpServers)
+        return;
+    for (const ide of ides) {
+        if (ide === "cursor") {
+            const mcpPath = node_path_1.default.join(cwd, ".cursor", "mcp.json");
+            writeMcpServersToFile(mcpServers, mcpPath);
+        }
+        // Windsurf does not support project mcpServers, so skip
+    }
+}
+/**
+ * Write MCP servers configuration to a specific file
+ * @param mcpServers The MCP servers configuration
+ * @param mcpPath The path to the mcp.json file
+ */
+function writeMcpServersToFile(mcpServers, mcpPath) {
+    var _a;
+    if (!mcpServers)
+        return;
+    fs_extra_1.default.ensureDirSync(node_path_1.default.dirname(mcpPath));
+    const existingConfig = fs_extra_1.default.existsSync(mcpPath)
+        ? fs_extra_1.default.readJsonSync(mcpPath)
+        : {};
+    const existingMcpServers = (_a = existingConfig === null || existingConfig === void 0 ? void 0 : existingConfig.mcpServers) !== null && _a !== void 0 ? _a : {};
+    // Filter out any existing aicm-managed servers (with aicm: true)
+    // This removes stale aicm servers that are no longer in the configuration
+    const userMcpServers = {};
+    for (const [key, value] of Object.entries(existingMcpServers)) {
+        if (typeof value === "object" && value !== null && value.aicm !== true) {
+            userMcpServers[key] = value;
+        }
+    }
+    // Mark new aicm servers as managed and filter out canceled servers
+    const aicmMcpServers = {};
+    for (const [key, value] of Object.entries(mcpServers)) {
+        if (value !== false) {
+            aicmMcpServers[key] = {
+                ...value,
+                aicm: true,
+            };
+        }
+    }
+    // Merge user servers with aicm servers (aicm servers override user servers with same key)
+    const mergedMcpServers = {
+        ...userMcpServers,
+        ...aicmMcpServers,
+    };
+    const mergedConfig = {
+        ...existingConfig,
+        mcpServers: mergedMcpServers,
+    };
+    fs_extra_1.default.writeJsonSync(mcpPath, mergedConfig, { spaces: 2 });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicm",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A TypeScript CLI tool for managing AI IDE rules across different projects and teams",
   "main": "dist/api.js",
   "types": "dist/api.d.ts",