rulesync 3.22.1 → 3.23.0

package/README.md

@@ -460,6 +460,25 @@ When enabling modular-mcp, each MCP server must have a `description` field. Exam
 }
 ```
 
+You can also configure `exposed` to exclude specific MCP servers from modular-mcp. It is optional and default to `false`. If you specify `exposed: true`, the MCP server is always loaded in the initial context.
+
+```diff
+// .rulesync/mcp.json
+{
+  "mcpServers": {
+    "context7": {
++     "exposed": true,
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@upstash/context7-mcp"
+      ],
+      "env": {}
+    }
+}
+```
+
 To demonstrate the effect of modular-mcp, please see the following example:
 
 <details>

package/dist/index.cjs

@@ -46,10 +46,7 @@ function isZodErrorLike(error) {
 }
 function formatError(error) {
   if (error instanceof import_zod.ZodError || isZodErrorLike(error)) {
-    return error.issues.map((issue) => {
-      const path2 = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
-      return `${path2}${issue.message}`;
-    }).join("; ");
+    return `Zod raw error: ${JSON.stringify(error.issues)}`;
   }
   if (error instanceof Error) {
     return `${error.name}: ${error.message}`;
@@ -2743,14 +2740,18 @@ var McpServerBaseSchema = import_mini12.z.object({
   kiroAutoBlock: import_mini12.z.optional(import_mini12.z.array(import_mini12.z.string())),
   headers: import_mini12.z.optional(import_mini12.z.record(import_mini12.z.string(), import_mini12.z.string()))
 });
-var ModularMcpServerSchema = import_mini12.z.extend(McpServerBaseSchema, {
-  description: import_mini12.z.string().check(import_mini12.z.minLength(1))
-});
-var ModularMcpServersSchema = import_mini12.z.record(import_mini12.z.string(), ModularMcpServerSchema);
-var RulesyncMcpServersSchema = import_mini12.z.extend(McpServerBaseSchema, {
-  description: import_mini12.z.optional(import_mini12.z.string()),
-  targets: import_mini12.z.optional(RulesyncTargetsSchema)
-});
+var RulesyncMcpServersSchema = import_mini12.z.union([
+  import_mini12.z.extend(McpServerBaseSchema, {
+    targets: import_mini12.z.optional(RulesyncTargetsSchema),
+    description: import_mini12.z.optional(import_mini12.z.string()),
+    exposed: import_mini12.z.optional(import_mini12.z.literal(false))
+  }),
+  import_mini12.z.extend(McpServerBaseSchema, {
+    targets: import_mini12.z.optional(RulesyncTargetsSchema),
+    description: import_mini12.z.undefined(),
+    exposed: import_mini12.z.literal(true)
+  })
+]);
 var RulesyncMcpConfigSchema = import_mini12.z.object({
   mcpServers: import_mini12.z.record(import_mini12.z.string(), RulesyncMcpServersSchema)
 });
@@ -2781,17 +2782,6 @@ var RulesyncMcp = class _RulesyncMcp extends RulesyncFile {
     };
   }
   validate() {
-    if (this.modularMcp) {
-      const result = ModularMcpServersSchema.safeParse(this.json.mcpServers);
-      if (!result.success) {
-        return {
-          success: false,
-          error: new Error(
-            `Invalid MCP server configuration for modular-mcp: ${formatError(result.error)}`
-          )
-        };
-      }
-    }
     return { success: true, error: null };
   }
   static async fromFile({
@@ -2841,20 +2831,40 @@ var RulesyncMcp = class _RulesyncMcp extends RulesyncFile {
       modularMcp
     });
   }
-  getJson({ modularMcp = false } = {}) {
-    if (modularMcp) {
-      return this.json;
+  getExposedServers() {
+    if (!this.json || typeof this.json !== "object") {
+      return {};
+    }
+    if (!this.json.mcpServers || typeof this.json.mcpServers !== "object") {
+      return {};
     }
+    return Object.fromEntries(
+      Object.entries(this.json.mcpServers).filter(([, serverConfig]) => serverConfig.exposed === true).map(([serverName, serverConfig]) => [
+        serverName,
+        (0, import_object.omit)(serverConfig, ["description", "exposed"])
+      ])
+    );
+  }
+  getJson({ modularMcp = false } = {}) {
     if (!this.json || typeof this.json !== "object") {
       return this.json;
     }
     if (!this.json.mcpServers || typeof this.json.mcpServers !== "object") {
       return this.json;
     }
+    if (modularMcp) {
+      const mcpServersForModularMcp = Object.fromEntries(
+        Object.entries(this.json.mcpServers).filter(([, serverConfig]) => !serverConfig.exposed).map(([serverName, serverConfig]) => [serverName, (0, import_object.omit)(serverConfig, ["exposed"])])
+      );
+      return {
+        ...this.json,
+        mcpServers: mcpServersForModularMcp
+      };
+    }
     const mcpServersWithoutDescription = Object.fromEntries(
       Object.entries(this.json.mcpServers).map(([serverName, serverConfig]) => [
         serverName,
-        (0, import_object.omit)(serverConfig, ["description"])
+        (0, import_object.omit)(serverConfig, ["description", "exposed"])
       ])
     );
     return {
@@ -3107,11 +3117,15 @@ var ClaudecodeMcp = class _ClaudecodeMcp extends ToolMcp {
     const json = JSON.parse(fileContent);
     const mcpJson = modularMcp ? {
       ...json,
-      mcpServers: global ? ModularMcp.getMcpServers({
-        baseDir,
-        global: true,
-        relativeDirPath: this.getSettablePaths({ global: true }).relativeDirPath
-      }) : ModularMcp.getMcpServers({ baseDir, global: false })
+      mcpServers: {
+        ...global ? ModularMcp.getMcpServers({
+          baseDir,
+          global: true,
+          relativeDirPath: this.getSettablePaths({ global: true }).relativeDirPath
+        }) : ModularMcp.getMcpServers({ baseDir, global: false }),
+        // Merge exposed servers
+        ...rulesyncMcp.getExposedServers()
+      }
     } : { ...json, mcpServers: rulesyncMcp.getJson({ modularMcp: false }).mcpServers };
     return new _ClaudecodeMcp({
       baseDir,
@@ -8515,7 +8529,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.22.1";
+var getVersion = () => "3.23.0";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();

package/dist/index.js

@@ -23,10 +23,7 @@ function isZodErrorLike(error) {
 }
 function formatError(error) {
   if (error instanceof ZodError || isZodErrorLike(error)) {
-    return error.issues.map((issue) => {
-      const path2 = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
-      return `${path2}${issue.message}`;
-    }).join("; ");
+    return `Zod raw error: ${JSON.stringify(error.issues)}`;
   }
   if (error instanceof Error) {
     return `${error.name}: ${error.message}`;
@@ -2720,14 +2717,18 @@ var McpServerBaseSchema = z12.object({
   kiroAutoBlock: z12.optional(z12.array(z12.string())),
   headers: z12.optional(z12.record(z12.string(), z12.string()))
 });
-var ModularMcpServerSchema = z12.extend(McpServerBaseSchema, {
-  description: z12.string().check(z12.minLength(1))
-});
-var ModularMcpServersSchema = z12.record(z12.string(), ModularMcpServerSchema);
-var RulesyncMcpServersSchema = z12.extend(McpServerBaseSchema, {
-  description: z12.optional(z12.string()),
-  targets: z12.optional(RulesyncTargetsSchema)
-});
+var RulesyncMcpServersSchema = z12.union([
+  z12.extend(McpServerBaseSchema, {
+    targets: z12.optional(RulesyncTargetsSchema),
+    description: z12.optional(z12.string()),
+    exposed: z12.optional(z12.literal(false))
+  }),
+  z12.extend(McpServerBaseSchema, {
+    targets: z12.optional(RulesyncTargetsSchema),
+    description: z12.undefined(),
+    exposed: z12.literal(true)
+  })
+]);
 var RulesyncMcpConfigSchema = z12.object({
   mcpServers: z12.record(z12.string(), RulesyncMcpServersSchema)
 });
@@ -2758,17 +2759,6 @@ var RulesyncMcp = class _RulesyncMcp extends RulesyncFile {
     };
   }
   validate() {
-    if (this.modularMcp) {
-      const result = ModularMcpServersSchema.safeParse(this.json.mcpServers);
-      if (!result.success) {
-        return {
-          success: false,
-          error: new Error(
-            `Invalid MCP server configuration for modular-mcp: ${formatError(result.error)}`
-          )
-        };
-      }
-    }
     return { success: true, error: null };
   }
   static async fromFile({
@@ -2818,20 +2808,40 @@ var RulesyncMcp = class _RulesyncMcp extends RulesyncFile {
       modularMcp
     });
   }
-  getJson({ modularMcp = false } = {}) {
-    if (modularMcp) {
-      return this.json;
+  getExposedServers() {
+    if (!this.json || typeof this.json !== "object") {
+      return {};
+    }
+    if (!this.json.mcpServers || typeof this.json.mcpServers !== "object") {
+      return {};
     }
+    return Object.fromEntries(
+      Object.entries(this.json.mcpServers).filter(([, serverConfig]) => serverConfig.exposed === true).map(([serverName, serverConfig]) => [
+        serverName,
+        omit(serverConfig, ["description", "exposed"])
+      ])
+    );
+  }
+  getJson({ modularMcp = false } = {}) {
     if (!this.json || typeof this.json !== "object") {
       return this.json;
     }
     if (!this.json.mcpServers || typeof this.json.mcpServers !== "object") {
       return this.json;
     }
+    if (modularMcp) {
+      const mcpServersForModularMcp = Object.fromEntries(
+        Object.entries(this.json.mcpServers).filter(([, serverConfig]) => !serverConfig.exposed).map(([serverName, serverConfig]) => [serverName, omit(serverConfig, ["exposed"])])
+      );
+      return {
+        ...this.json,
+        mcpServers: mcpServersForModularMcp
+      };
+    }
     const mcpServersWithoutDescription = Object.fromEntries(
       Object.entries(this.json.mcpServers).map(([serverName, serverConfig]) => [
         serverName,
-        omit(serverConfig, ["description"])
+        omit(serverConfig, ["description", "exposed"])
       ])
     );
     return {
@@ -3084,11 +3094,15 @@ var ClaudecodeMcp = class _ClaudecodeMcp extends ToolMcp {
     const json = JSON.parse(fileContent);
     const mcpJson = modularMcp ? {
       ...json,
-      mcpServers: global ? ModularMcp.getMcpServers({
-        baseDir,
-        global: true,
-        relativeDirPath: this.getSettablePaths({ global: true }).relativeDirPath
-      }) : ModularMcp.getMcpServers({ baseDir, global: false })
+      mcpServers: {
+        ...global ? ModularMcp.getMcpServers({
+          baseDir,
+          global: true,
+          relativeDirPath: this.getSettablePaths({ global: true }).relativeDirPath
+        }) : ModularMcp.getMcpServers({ baseDir, global: false }),
+        // Merge exposed servers
+        ...rulesyncMcp.getExposedServers()
+      }
     } : { ...json, mcpServers: rulesyncMcp.getJson({ modularMcp: false }).mcpServers };
     return new _ClaudecodeMcp({
       baseDir,
@@ -8492,7 +8506,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.22.1";
+var getVersion = () => "3.23.0";
 var main = async () => {
   const program = new Command();
   const version = getVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "3.22.1",
+  "version": "3.23.0",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "keywords": [
     "ai",