rulesync 3.19.0 → 3.20.0

package/dist/index.js

@@ -84,9 +84,9 @@ var logger = new Logger();
 // src/cli/commands/generate.ts
 import { intersection } from "es-toolkit";
 
-// src/commands/commands-processor.ts
-import { basename as basename11, join as join11 } from "path";
-import { z as z9 } from "zod/mini";
+// src/config/config-resolver.ts
+import { resolve as resolve2 } from "path";
+import { parse as parseJsonc } from "jsonc-parser";
 
 // src/utils/file.ts
 import { globSync } from "fs";
@@ -109,14 +109,24 @@ async function readOrInitializeFileContent(filePath, initialContent = "") {
     return initialContent;
   }
 }
-function resolvePath(relativePath, baseDir) {
-  if (!baseDir) return relativePath;
-  const resolved = resolve(baseDir, relativePath);
-  const rel = relative(baseDir, resolved);
+function checkPathTraversal({
+  relativePath,
+  intendedRootDir
+}) {
+  const segments = relativePath.split(/[/\\]/);
+  if (segments.includes("..")) {
+    throw new Error(`Path traversal detected: ${relativePath}`);
+  }
+  const resolved = resolve(intendedRootDir, relativePath);
+  const rel = relative(intendedRootDir, resolved);
   if (rel.startsWith("..") || resolve(resolved) !== resolved) {
     throw new Error(`Path traversal detected: ${relativePath}`);
   }
-  return resolved;
+}
+function resolvePath(relativePath, baseDir) {
+  if (!baseDir) return relativePath;
+  checkPathTraversal({ relativePath, intendedRootDir: baseDir });
+  return resolve(baseDir, relativePath);
 }
 async function directoryExists(dirPath) {
   try {
@@ -179,16 +189,252 @@ function validateBaseDir(baseDir) {
   if (baseDir.trim() === "") {
     throw new Error("baseDir cannot be an empty string");
   }
-  if (baseDir.includes("..")) {
-    throw new Error(`baseDir cannot contain directory traversal (..): ${baseDir}`);
+  checkPathTraversal({ relativePath: baseDir, intendedRootDir: process.cwd() });
+}
+
+// src/config/config.ts
+import { optional, z as z3 } from "zod/mini";
+
+// src/types/tool-targets.ts
+import { z as z2 } from "zod/mini";
+var ALL_TOOL_TARGETS = [
+  "agentsmd",
+  "amazonqcli",
+  "augmentcode",
+  "augmentcode-legacy",
+  "copilot",
+  "cursor",
+  "cline",
+  "claudecode",
+  "codexcli",
+  "opencode",
+  "qwencode",
+  "roo",
+  "geminicli",
+  "kiro",
+  "junie",
+  "warp",
+  "windsurf"
+];
+var ALL_TOOL_TARGETS_WITH_WILDCARD = [...ALL_TOOL_TARGETS, "*"];
+var ToolTargetSchema = z2.enum(ALL_TOOL_TARGETS);
+var ToolTargetsSchema = z2.array(ToolTargetSchema);
+var RulesyncTargetsSchema = z2.array(z2.enum(ALL_TOOL_TARGETS_WITH_WILDCARD));
+
+// src/config/config.ts
+var ConfigParamsSchema = z3.object({
+  baseDirs: z3.array(z3.string()),
+  targets: RulesyncTargetsSchema,
+  features: RulesyncFeaturesSchema,
+  verbose: z3.boolean(),
+  delete: z3.boolean(),
+  // New non-experimental options
+  global: optional(z3.boolean()),
+  simulatedCommands: optional(z3.boolean()),
+  simulatedSubagents: optional(z3.boolean()),
+  modularMcp: optional(z3.boolean()),
+  // Deprecated experimental options (for backward compatibility)
+  experimentalGlobal: optional(z3.boolean()),
+  experimentalSimulateCommands: optional(z3.boolean()),
+  experimentalSimulateSubagents: optional(z3.boolean())
+});
+var PartialConfigParamsSchema = z3.partial(ConfigParamsSchema);
+var RequiredConfigParamsSchema = z3.required(ConfigParamsSchema);
+var Config = class {
+  baseDirs;
+  targets;
+  features;
+  verbose;
+  delete;
+  global;
+  simulatedCommands;
+  simulatedSubagents;
+  modularMcp;
+  constructor({
+    baseDirs,
+    targets,
+    features,
+    verbose,
+    delete: isDelete,
+    global,
+    simulatedCommands,
+    simulatedSubagents,
+    modularMcp,
+    experimentalGlobal,
+    experimentalSimulateCommands,
+    experimentalSimulateSubagents
+  }) {
+    this.baseDirs = baseDirs;
+    this.targets = targets;
+    this.features = features;
+    this.verbose = verbose;
+    this.delete = isDelete;
+    this.global = global ?? experimentalGlobal ?? false;
+    this.simulatedCommands = simulatedCommands ?? experimentalSimulateCommands ?? false;
+    this.simulatedSubagents = simulatedSubagents ?? experimentalSimulateSubagents ?? false;
+    this.modularMcp = modularMcp ?? false;
+  }
+  getBaseDirs() {
+    return this.baseDirs;
+  }
+  getTargets() {
+    if (this.targets.includes("*")) {
+      return [...ALL_TOOL_TARGETS];
+    }
+    return this.targets.filter((target) => target !== "*");
+  }
+  getFeatures() {
+    if (this.features.includes("*")) {
+      return [...ALL_FEATURES];
+    }
+    return this.features.filter((feature) => feature !== "*");
+  }
+  getVerbose() {
+    return this.verbose;
+  }
+  getDelete() {
+    return this.delete;
+  }
+  getGlobal() {
+    return this.global;
+  }
+  getSimulatedCommands() {
+    return this.simulatedCommands;
+  }
+  getSimulatedSubagents() {
+    return this.simulatedSubagents;
+  }
+  getModularMcp() {
+    return this.modularMcp;
+  }
+  // Deprecated getters for backward compatibility
+  /** @deprecated Use getGlobal() instead */
+  getExperimentalGlobal() {
+    return this.global;
+  }
+  /** @deprecated Use getSimulatedCommands() instead */
+  getExperimentalSimulateCommands() {
+    return this.simulatedCommands;
+  }
+  /** @deprecated Use getSimulatedSubagents() instead */
+  getExperimentalSimulateSubagents() {
+    return this.simulatedSubagents;
+  }
+};
+
+// src/config/config-resolver.ts
+var defaults = {
+  targets: ["agentsmd"],
+  features: ["rules"],
+  verbose: false,
+  delete: false,
+  baseDirs: [process.cwd()],
+  configPath: "rulesync.jsonc",
+  global: false,
+  simulatedCommands: false,
+  simulatedSubagents: false,
+  modularMcp: false,
+  experimentalGlobal: false,
+  experimentalSimulateCommands: false,
+  experimentalSimulateSubagents: false
+};
+var ConfigResolver = class {
+  static async resolve({
+    targets,
+    features,
+    verbose,
+    delete: isDelete,
+    baseDirs,
+    configPath = defaults.configPath,
+    global,
+    simulatedCommands,
+    simulatedSubagents,
+    modularMcp,
+    experimentalGlobal,
+    experimentalSimulateCommands,
+    experimentalSimulateSubagents
+  }) {
+    const validatedConfigPath = resolvePath(configPath, process.cwd());
+    let configByFile = {};
+    if (await fileExists(validatedConfigPath)) {
+      try {
+        const fileContent = await readFileContent(validatedConfigPath);
+        const jsonData = parseJsonc(fileContent);
+        configByFile = PartialConfigParamsSchema.parse(jsonData);
+      } catch (error) {
+        logger.error(`Failed to load config file: ${formatError(error)}`);
+        throw error;
+      }
+    }
+    const deprecatedGlobal = experimentalGlobal ?? configByFile.experimentalGlobal;
+    const deprecatedCommands = experimentalSimulateCommands ?? configByFile.experimentalSimulateCommands;
+    const deprecatedSubagents = experimentalSimulateSubagents ?? configByFile.experimentalSimulateSubagents;
+    if (deprecatedGlobal !== void 0) {
+      warnDeprecatedOptions({ experimentalGlobal: deprecatedGlobal });
+    }
+    if (deprecatedCommands !== void 0) {
+      warnDeprecatedOptions({ experimentalSimulateCommands: deprecatedCommands });
+    }
+    if (deprecatedSubagents !== void 0) {
+      warnDeprecatedOptions({ experimentalSimulateSubagents: deprecatedSubagents });
+    }
+    const resolvedGlobal = global ?? configByFile.global ?? experimentalGlobal ?? configByFile.experimentalGlobal ?? defaults.global;
+    const resolvedSimulatedCommands = simulatedCommands ?? configByFile.simulatedCommands ?? experimentalSimulateCommands ?? configByFile.experimentalSimulateCommands ?? defaults.simulatedCommands;
+    const resolvedSimulatedSubagents = simulatedSubagents ?? configByFile.simulatedSubagents ?? experimentalSimulateSubagents ?? configByFile.experimentalSimulateSubagents ?? defaults.simulatedSubagents;
+    const configParams = {
+      targets: targets ?? configByFile.targets ?? defaults.targets,
+      features: features ?? configByFile.features ?? defaults.features,
+      verbose: verbose ?? configByFile.verbose ?? defaults.verbose,
+      delete: isDelete ?? configByFile.delete ?? defaults.delete,
+      baseDirs: getBaseDirsInLightOfGlobal({
+        baseDirs: baseDirs ?? configByFile.baseDirs ?? defaults.baseDirs,
+        global: resolvedGlobal
+      }),
+      global: resolvedGlobal,
+      simulatedCommands: resolvedSimulatedCommands,
+      simulatedSubagents: resolvedSimulatedSubagents,
+      modularMcp: modularMcp ?? configByFile.modularMcp ?? defaults.modularMcp
+    };
+    return new Config(configParams);
+  }
+};
+function warnDeprecatedOptions({
+  experimentalGlobal,
+  experimentalSimulateCommands,
+  experimentalSimulateSubagents
+}) {
+  if (experimentalGlobal !== void 0) {
+    logger.warn("'experimentalGlobal' option is deprecated. Please use 'global' instead.");
+  }
+  if (experimentalSimulateCommands !== void 0) {
+    logger.warn(
+      "'experimentalSimulateCommands' option is deprecated. Please use 'simulatedCommands' instead."
+    );
+  }
+  if (experimentalSimulateSubagents !== void 0) {
+    logger.warn(
+      "'experimentalSimulateSubagents' option is deprecated. Please use 'simulatedSubagents' instead."
+    );
   }
-  const normalized = resolve(baseDir);
-  const rel = relative(process.cwd(), normalized);
-  if (rel.startsWith("..")) {
-    throw new Error(`baseDir cannot contain directory traversal (..): ${baseDir}`);
+}
+function getBaseDirsInLightOfGlobal({
+  baseDirs,
+  global
+}) {
+  if (global) {
+    return [getHomeDirectory()];
   }
+  const resolvedBaseDirs = baseDirs.map((baseDir) => resolve2(baseDir));
+  resolvedBaseDirs.forEach((baseDir) => {
+    validateBaseDir(baseDir);
+  });
+  return resolvedBaseDirs;
 }
 
+// src/features/commands/commands-processor.ts
+import { basename as basename11, join as join11 } from "path";
+import { z as z10 } from "zod/mini";
+
 // src/types/feature-processor.ts
 var FeatureProcessor = class {
   baseDir;
@@ -219,7 +465,7 @@ var FeatureProcessor = class {
   }
 };
 
-// src/commands/agentsmd-command.ts
+// src/features/commands/agentsmd-command.ts
 import { basename as basename3, join as join3 } from "path";
 
 // src/utils/frontmatter.ts
@@ -271,12 +517,12 @@ function parseFrontmatter(content) {
   return { frontmatter, body };
 }
 
-// src/commands/simulated-command.ts
+// src/features/commands/simulated-command.ts
 import { basename as basename2, join as join2 } from "path";
-import { z as z2 } from "zod/mini";
+import { z as z4 } from "zod/mini";
 
 // src/types/ai-file.ts
-import path, { relative as relative2, resolve as resolve2 } from "path";
+import path, { relative as relative2, resolve as resolve3 } from "path";
 var AiFile = class {
   /**
    * @example "."
@@ -332,8 +578,8 @@ var AiFile = class {
   }
   getFilePath() {
     const fullPath = path.join(this.baseDir, this.relativeDirPath, this.relativeFilePath);
-    const resolvedFull = resolve2(fullPath);
-    const resolvedBase = resolve2(this.baseDir);
+    const resolvedFull = resolve3(fullPath);
+    const resolvedBase = resolve3(this.baseDir);
     const rel = relative2(resolvedBase, resolvedFull);
     if (rel.startsWith("..") || path.isAbsolute(rel)) {
       throw new Error(
@@ -353,7 +599,7 @@ var AiFile = class {
   }
 };
 
-// src/commands/tool-command.ts
+// src/features/commands/tool-command.ts
 var ToolCommand = class extends AiFile {
   static getSettablePaths() {
     throw new Error("Please implement this method in the subclass.");
@@ -423,9 +669,9 @@ var ToolCommand = class extends AiFile {
   }
 };
 
-// src/commands/simulated-command.ts
-var SimulatedCommandFrontmatterSchema = z2.object({
-  description: z2.string()
+// src/features/commands/simulated-command.ts
+var SimulatedCommandFrontmatterSchema = z4.object({
+  description: z4.string()
 });
 var SimulatedCommand = class _SimulatedCommand extends ToolCommand {
   frontmatter;
@@ -517,7 +763,7 @@ var SimulatedCommand = class _SimulatedCommand extends ToolCommand {
   }
 };
 
-// src/commands/agentsmd-command.ts
+// src/features/commands/agentsmd-command.ts
 var AgentsmdCommand = class _AgentsmdCommand extends SimulatedCommand {
   static getSettablePaths() {
     return {
@@ -566,13 +812,13 @@ var AgentsmdCommand = class _AgentsmdCommand extends SimulatedCommand {
   }
 };
 
-// src/commands/claudecode-command.ts
+// src/features/commands/claudecode-command.ts
 import { basename as basename5, join as join5 } from "path";
-import { z as z5 } from "zod/mini";
+import { z as z6 } from "zod/mini";
 
-// src/commands/rulesync-command.ts
+// src/features/commands/rulesync-command.ts
 import { basename as basename4, join as join4 } from "path";
-import { z as z4 } from "zod/mini";
+import { z as z5 } from "zod/mini";
 
 // src/types/rulesync-file.ts
 var RulesyncFile = class extends AiFile {
@@ -584,36 +830,10 @@ var RulesyncFile = class extends AiFile {
   }
 };
 
-// src/types/tool-targets.ts
-import { z as z3 } from "zod/mini";
-var ALL_TOOL_TARGETS = [
-  "agentsmd",
-  "amazonqcli",
-  "augmentcode",
-  "augmentcode-legacy",
-  "copilot",
-  "cursor",
-  "cline",
-  "claudecode",
-  "codexcli",
-  "opencode",
-  "qwencode",
-  "roo",
-  "geminicli",
-  "kiro",
-  "junie",
-  "warp",
-  "windsurf"
-];
-var ALL_TOOL_TARGETS_WITH_WILDCARD = [...ALL_TOOL_TARGETS, "*"];
-var ToolTargetSchema = z3.enum(ALL_TOOL_TARGETS);
-var ToolTargetsSchema = z3.array(ToolTargetSchema);
-var RulesyncTargetsSchema = z3.array(z3.enum(ALL_TOOL_TARGETS_WITH_WILDCARD));
-
-// src/commands/rulesync-command.ts
-var RulesyncCommandFrontmatterSchema = z4.object({
+// src/features/commands/rulesync-command.ts
+var RulesyncCommandFrontmatterSchema = z5.object({
   targets: RulesyncTargetsSchema,
-  description: z4.string()
+  description: z5.string()
 });
 var RulesyncCommand = class _RulesyncCommand extends RulesyncFile {
   frontmatter;
@@ -664,9 +884,12 @@ var RulesyncCommand = class _RulesyncCommand extends RulesyncFile {
   static async fromFile({
     relativeFilePath
   }) {
-    const fileContent = await readFileContent(
-      join4(_RulesyncCommand.getSettablePaths().relativeDirPath, relativeFilePath)
+    const filePath = join4(
+      process.cwd(),
+      _RulesyncCommand.getSettablePaths().relativeDirPath,
+      relativeFilePath
     );
+    const fileContent = await readFileContent(filePath);
     const { frontmatter, body: content } = parseFrontmatter(fileContent);
     const result = RulesyncCommandFrontmatterSchema.safeParse(frontmatter);
     if (!result.success) {
@@ -684,9 +907,9 @@ var RulesyncCommand = class _RulesyncCommand extends RulesyncFile {
   }
 };
 
-// src/commands/claudecode-command.ts
-var ClaudecodeCommandFrontmatterSchema = z5.object({
-  description: z5.string()
+// src/features/commands/claudecode-command.ts
+var ClaudecodeCommandFrontmatterSchema = z6.object({
+  description: z6.string()
 });
 var ClaudecodeCommand = class _ClaudecodeCommand extends ToolCommand {
   frontmatter;
@@ -803,7 +1026,7 @@ var ClaudecodeCommand = class _ClaudecodeCommand extends ToolCommand {
   }
 };
 
-// src/commands/codexcli-command.ts
+// src/features/commands/codexcli-command.ts
 import { basename as basename6, join as join6 } from "path";
 var CodexcliCommand = class _CodexcliCommand extends ToolCommand {
   static getSettablePaths({ global } = {}) {
@@ -877,12 +1100,12 @@ var CodexcliCommand = class _CodexcliCommand extends ToolCommand {
   }
 };
 
-// src/commands/copilot-command.ts
+// src/features/commands/copilot-command.ts
 import { basename as basename7, join as join7 } from "path";
-import { z as z6 } from "zod/mini";
-var CopilotCommandFrontmatterSchema = z6.object({
-  mode: z6.literal("agent"),
-  description: z6.string()
+import { z as z7 } from "zod/mini";
+var CopilotCommandFrontmatterSchema = z7.object({
+  mode: z7.literal("agent"),
+  description: z7.string()
 });
 var CopilotCommand = class _CopilotCommand extends ToolCommand {
   frontmatter;
@@ -1000,7 +1223,7 @@ var CopilotCommand = class _CopilotCommand extends ToolCommand {
   }
 };
 
-// src/commands/cursor-command.ts
+// src/features/commands/cursor-command.ts
 import { basename as basename8, join as join8 } from "path";
 var CursorCommand = class _CursorCommand extends ToolCommand {
   static getSettablePaths(_options = {}) {
@@ -1071,13 +1294,13 @@ var CursorCommand = class _CursorCommand extends ToolCommand {
   }
 };
 
-// src/commands/geminicli-command.ts
+// src/features/commands/geminicli-command.ts
 import { basename as basename9, join as join9 } from "path";
 import { parse as parseToml } from "smol-toml";
-import { z as z7 } from "zod/mini";
-var GeminiCliCommandFrontmatterSchema = z7.object({
-  description: z7.optional(z7.string()),
-  prompt: z7.string()
+import { z as z8 } from "zod/mini";
+var GeminiCliCommandFrontmatterSchema = z8.object({
+  description: z8.optional(z8.string()),
+  prompt: z8.string()
 });
 var GeminiCliCommand = class _GeminiCliCommand extends ToolCommand {
   frontmatter;
@@ -1193,12 +1416,12 @@ ${geminiFrontmatter.prompt}
   }
 };
 
-// src/commands/roo-command.ts
+// src/features/commands/roo-command.ts
 import { basename as basename10, join as join10 } from "path";
-import { optional, z as z8 } from "zod/mini";
-var RooCommandFrontmatterSchema = z8.object({
-  description: z8.string(),
-  "argument-hint": optional(z8.string())
+import { optional as optional2, z as z9 } from "zod/mini";
+var RooCommandFrontmatterSchema = z9.object({
+  description: z9.string(),
+  "argument-hint": optional2(z9.string())
 });
 var RooCommand = class _RooCommand extends ToolCommand {
   frontmatter;
@@ -1314,7 +1537,7 @@ var RooCommand = class _RooCommand extends ToolCommand {
   }
 };
 
-// src/commands/commands-processor.ts
+// src/features/commands/commands-processor.ts
 var commandsProcessorToolTargets = [
   "agentsmd",
   "claudecode",
@@ -1323,7 +1546,7 @@ var commandsProcessorToolTargets = [
   "copilot",
   "cursor"
 ];
-var CommandsProcessorToolTargetSchema = z9.enum(
+var CommandsProcessorToolTargetSchema = z10.enum(
   // codexcli is not in the list of tool targets but we add it here because it is a valid tool target for global mode generation
   commandsProcessorToolTargets.concat("codexcli")
 );
@@ -1632,232 +1855,17 @@ var CommandsProcessor = class extends FeatureProcessor {
   }
 };
 
-// src/config/config-resolver.ts
-import { resolve as resolve3 } from "path";
-import { parse as parseJsonc } from "jsonc-parser";
-
-// src/config/config.ts
-import { optional as optional2, z as z10 } from "zod/mini";
-var ConfigParamsSchema = z10.object({
-  baseDirs: z10.array(z10.string()),
-  targets: RulesyncTargetsSchema,
-  features: RulesyncFeaturesSchema,
-  verbose: z10.boolean(),
-  delete: z10.boolean(),
-  // New non-experimental options
-  global: optional2(z10.boolean()),
-  simulatedCommands: optional2(z10.boolean()),
-  simulatedSubagents: optional2(z10.boolean()),
-  modularMcp: optional2(z10.boolean()),
-  // Deprecated experimental options (for backward compatibility)
-  experimentalGlobal: optional2(z10.boolean()),
-  experimentalSimulateCommands: optional2(z10.boolean()),
-  experimentalSimulateSubagents: optional2(z10.boolean())
-});
-var PartialConfigParamsSchema = z10.partial(ConfigParamsSchema);
-var RequiredConfigParamsSchema = z10.required(ConfigParamsSchema);
-var Config = class {
-  baseDirs;
-  targets;
-  features;
-  verbose;
-  delete;
-  global;
-  simulatedCommands;
-  simulatedSubagents;
-  modularMcp;
-  constructor({
-    baseDirs,
-    targets,
-    features,
-    verbose,
-    delete: isDelete,
-    global,
-    simulatedCommands,
-    simulatedSubagents,
-    modularMcp,
-    experimentalGlobal,
-    experimentalSimulateCommands,
-    experimentalSimulateSubagents
-  }) {
-    this.baseDirs = baseDirs;
-    this.targets = targets;
-    this.features = features;
-    this.verbose = verbose;
-    this.delete = isDelete;
-    this.global = global ?? experimentalGlobal ?? false;
-    this.simulatedCommands = simulatedCommands ?? experimentalSimulateCommands ?? false;
-    this.simulatedSubagents = simulatedSubagents ?? experimentalSimulateSubagents ?? false;
-    this.modularMcp = modularMcp ?? false;
-  }
-  getBaseDirs() {
-    return this.baseDirs;
-  }
-  getTargets() {
-    if (this.targets.includes("*")) {
-      return [...ALL_TOOL_TARGETS];
-    }
-    return this.targets.filter((target) => target !== "*");
-  }
-  getFeatures() {
-    if (this.features.includes("*")) {
-      return [...ALL_FEATURES];
-    }
-    return this.features.filter((feature) => feature !== "*");
-  }
-  getVerbose() {
-    return this.verbose;
-  }
-  getDelete() {
-    return this.delete;
-  }
-  getGlobal() {
-    return this.global;
-  }
-  getSimulatedCommands() {
-    return this.simulatedCommands;
-  }
-  getSimulatedSubagents() {
-    return this.simulatedSubagents;
-  }
-  getModularMcp() {
-    return this.modularMcp;
-  }
-  // Deprecated getters for backward compatibility
-  /** @deprecated Use getGlobal() instead */
-  getExperimentalGlobal() {
-    return this.global;
-  }
-  /** @deprecated Use getSimulatedCommands() instead */
-  getExperimentalSimulateCommands() {
-    return this.simulatedCommands;
-  }
-  /** @deprecated Use getSimulatedSubagents() instead */
-  getExperimentalSimulateSubagents() {
-    return this.simulatedSubagents;
-  }
-};
-
-// src/config/config-resolver.ts
-var defaults = {
-  targets: ["agentsmd"],
-  features: ["rules"],
-  verbose: false,
-  delete: false,
-  baseDirs: [process.cwd()],
-  configPath: "rulesync.jsonc",
-  global: false,
-  simulatedCommands: false,
-  simulatedSubagents: false,
-  modularMcp: false,
-  experimentalGlobal: false,
-  experimentalSimulateCommands: false,
-  experimentalSimulateSubagents: false
-};
-var ConfigResolver = class {
-  static async resolve({
-    targets,
-    features,
-    verbose,
-    delete: isDelete,
-    baseDirs,
-    configPath = defaults.configPath,
-    global,
-    simulatedCommands,
-    simulatedSubagents,
-    modularMcp,
-    experimentalGlobal,
-    experimentalSimulateCommands,
-    experimentalSimulateSubagents
-  }) {
-    const validatedConfigPath = resolvePath(configPath, process.cwd());
-    let configByFile = {};
-    if (await fileExists(validatedConfigPath)) {
-      try {
-        const fileContent = await readFileContent(validatedConfigPath);
-        const jsonData = parseJsonc(fileContent);
-        configByFile = PartialConfigParamsSchema.parse(jsonData);
-      } catch (error) {
-        logger.error(`Failed to load config file: ${formatError(error)}`);
-        throw error;
-      }
-    }
-    const deprecatedGlobal = experimentalGlobal ?? configByFile.experimentalGlobal;
-    const deprecatedCommands = experimentalSimulateCommands ?? configByFile.experimentalSimulateCommands;
-    const deprecatedSubagents = experimentalSimulateSubagents ?? configByFile.experimentalSimulateSubagents;
-    if (deprecatedGlobal !== void 0) {
-      warnDeprecatedOptions({ experimentalGlobal: deprecatedGlobal });
-    }
-    if (deprecatedCommands !== void 0) {
-      warnDeprecatedOptions({ experimentalSimulateCommands: deprecatedCommands });
-    }
-    if (deprecatedSubagents !== void 0) {
-      warnDeprecatedOptions({ experimentalSimulateSubagents: deprecatedSubagents });
-    }
-    const resolvedGlobal = global ?? configByFile.global ?? experimentalGlobal ?? configByFile.experimentalGlobal ?? defaults.global;
-    const resolvedSimulatedCommands = simulatedCommands ?? configByFile.simulatedCommands ?? experimentalSimulateCommands ?? configByFile.experimentalSimulateCommands ?? defaults.simulatedCommands;
-    const resolvedSimulatedSubagents = simulatedSubagents ?? configByFile.simulatedSubagents ?? experimentalSimulateSubagents ?? configByFile.experimentalSimulateSubagents ?? defaults.simulatedSubagents;
-    const configParams = {
-      targets: targets ?? configByFile.targets ?? defaults.targets,
-      features: features ?? configByFile.features ?? defaults.features,
-      verbose: verbose ?? configByFile.verbose ?? defaults.verbose,
-      delete: isDelete ?? configByFile.delete ?? defaults.delete,
-      baseDirs: getBaseDirsInLightOfGlobal({
-        baseDirs: baseDirs ?? configByFile.baseDirs ?? defaults.baseDirs,
-        global: resolvedGlobal
-      }),
-      global: resolvedGlobal,
-      simulatedCommands: resolvedSimulatedCommands,
-      simulatedSubagents: resolvedSimulatedSubagents,
-      modularMcp: modularMcp ?? configByFile.modularMcp ?? defaults.modularMcp
-    };
-    return new Config(configParams);
-  }
-};
-function warnDeprecatedOptions({
-  experimentalGlobal,
-  experimentalSimulateCommands,
-  experimentalSimulateSubagents
-}) {
-  if (experimentalGlobal !== void 0) {
-    logger.warn("'experimentalGlobal' option is deprecated. Please use 'global' instead.");
-  }
-  if (experimentalSimulateCommands !== void 0) {
-    logger.warn(
-      "'experimentalSimulateCommands' option is deprecated. Please use 'simulatedCommands' instead."
-    );
-  }
-  if (experimentalSimulateSubagents !== void 0) {
-    logger.warn(
-      "'experimentalSimulateSubagents' option is deprecated. Please use 'simulatedSubagents' instead."
-    );
-  }
-}
-function getBaseDirsInLightOfGlobal({
-  baseDirs,
-  global
-}) {
-  if (global) {
-    return [getHomeDirectory()];
-  }
-  const resolvedBaseDirs = baseDirs.map((baseDir) => resolve3(baseDir));
-  resolvedBaseDirs.forEach((baseDir) => {
-    validateBaseDir(baseDir);
-  });
-  return resolvedBaseDirs;
-}
-
-// src/ignore/ignore-processor.ts
+// src/features/ignore/ignore-processor.ts
 import { z as z11 } from "zod/mini";
 
-// src/ignore/amazonqcli-ignore.ts
+// src/features/ignore/amazonqcli-ignore.ts
 import { join as join13 } from "path";
 
 // src/types/tool-file.ts
 var ToolFile = class extends AiFile {
 };
 
-// src/ignore/rulesync-ignore.ts
+// src/features/ignore/rulesync-ignore.ts
 import { join as join12 } from "path";
 var RulesyncIgnore = class _RulesyncIgnore extends RulesyncFile {
   validate() {
@@ -1882,7 +1890,7 @@ var RulesyncIgnore = class _RulesyncIgnore extends RulesyncFile {
   }
 };
 
-// src/ignore/tool-ignore.ts
+// src/features/ignore/tool-ignore.ts
 var ToolIgnore = class extends ToolFile {
   patterns;
   constructor(params) {
@@ -1923,7 +1931,7 @@ var ToolIgnore = class extends ToolFile {
   }
 };
 
-// src/ignore/amazonqcli-ignore.ts
+// src/features/ignore/amazonqcli-ignore.ts
 var AmazonqcliIgnore = class _AmazonqcliIgnore extends ToolIgnore {
   static getSettablePaths() {
     return {
@@ -1978,7 +1986,7 @@ var AmazonqcliIgnore = class _AmazonqcliIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/augmentcode-ignore.ts
+// src/features/ignore/augmentcode-ignore.ts
 import { join as join14 } from "path";
 var AugmentcodeIgnore = class _AugmentcodeIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2033,7 +2041,7 @@ var AugmentcodeIgnore = class _AugmentcodeIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/claudecode-ignore.ts
+// src/features/ignore/claudecode-ignore.ts
 import { join as join15 } from "path";
 import { uniq } from "es-toolkit";
 var ClaudecodeIgnore = class _ClaudecodeIgnore extends ToolIgnore {
@@ -2114,7 +2122,7 @@ var ClaudecodeIgnore = class _ClaudecodeIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/cline-ignore.ts
+// src/features/ignore/cline-ignore.ts
 import { join as join16 } from "path";
 var ClineIgnore = class _ClineIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2168,7 +2176,7 @@ var ClineIgnore = class _ClineIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/cursor-ignore.ts
+// src/features/ignore/cursor-ignore.ts
 import { join as join17 } from "path";
 var CursorIgnore = class _CursorIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2218,7 +2226,7 @@ var CursorIgnore = class _CursorIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/geminicli-ignore.ts
+// src/features/ignore/geminicli-ignore.ts
 import { join as join18 } from "path";
 var GeminiCliIgnore = class _GeminiCliIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2262,7 +2270,7 @@ var GeminiCliIgnore = class _GeminiCliIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/junie-ignore.ts
+// src/features/ignore/junie-ignore.ts
 import { join as join19 } from "path";
 var JunieIgnore = class _JunieIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2306,7 +2314,7 @@ var JunieIgnore = class _JunieIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/kiro-ignore.ts
+// src/features/ignore/kiro-ignore.ts
 import { join as join20 } from "path";
 var KiroIgnore = class _KiroIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2350,7 +2358,7 @@ var KiroIgnore = class _KiroIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/qwencode-ignore.ts
+// src/features/ignore/qwencode-ignore.ts
 import { join as join21 } from "path";
 var QwencodeIgnore = class _QwencodeIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2394,7 +2402,7 @@ var QwencodeIgnore = class _QwencodeIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/roo-ignore.ts
+// src/features/ignore/roo-ignore.ts
 import { join as join22 } from "path";
 var RooIgnore = class _RooIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2438,7 +2446,7 @@ var RooIgnore = class _RooIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/windsurf-ignore.ts
+// src/features/ignore/windsurf-ignore.ts
 import { join as join23 } from "path";
 var WindsurfIgnore = class _WindsurfIgnore extends ToolIgnore {
   static getSettablePaths() {
@@ -2482,7 +2490,7 @@ var WindsurfIgnore = class _WindsurfIgnore extends ToolIgnore {
   }
 };
 
-// src/ignore/ignore-processor.ts
+// src/features/ignore/ignore-processor.ts
 var ignoreProcessorToolTargets = [
   "amazonqcli",
   "augmentcode",
@@ -2670,13 +2678,13 @@ var IgnoreProcessor = class extends FeatureProcessor {
   }
 };
 
-// src/mcp/mcp-processor.ts
+// src/features/mcp/mcp-processor.ts
 import { z as z13 } from "zod/mini";
 
-// src/mcp/amazonqcli-mcp.ts
+// src/features/mcp/amazonqcli-mcp.ts
 import { join as join25 } from "path";
 
-// src/mcp/rulesync-mcp.ts
+// src/features/mcp/rulesync-mcp.ts
 import { join as join24 } from "path";
 import { omit } from "es-toolkit/object";
 import { z as z12 } from "zod/mini";
@@ -2821,7 +2829,7 @@ var RulesyncMcp = class _RulesyncMcp extends RulesyncFile {
   }
 };
 
-// src/mcp/tool-mcp.ts
+// src/features/mcp/tool-mcp.ts
 var ToolMcp = class extends ToolFile {
   constructor({ ...rest }) {
     super({
@@ -2860,7 +2868,7 @@ var ToolMcp = class extends ToolFile {
   }
 };
 
-// src/mcp/amazonqcli-mcp.ts
+// src/features/mcp/amazonqcli-mcp.ts
 var AmazonqcliMcp = class _AmazonqcliMcp extends ToolMcp {
   json;
   constructor(params) {
@@ -2916,10 +2924,10 @@ var AmazonqcliMcp = class _AmazonqcliMcp extends ToolMcp {
   }
 };
 
-// src/mcp/claudecode-mcp.ts
+// src/features/mcp/claudecode-mcp.ts
 import { join as join27 } from "path";
 
-// src/mcp/modular-mcp.ts
+// src/features/mcp/modular-mcp.ts
 import { join as join26 } from "path";
 var ModularMcp = class _ModularMcp extends AiFile {
   json;
@@ -3007,7 +3015,7 @@ var ModularMcp = class _ModularMcp extends AiFile {
   }
 };
 
-// src/mcp/claudecode-mcp.ts
+// src/features/mcp/claudecode-mcp.ts
 var ClaudecodeMcp = class _ClaudecodeMcp extends ToolMcp {
   json;
   constructor(params) {
@@ -3088,7 +3096,7 @@ var ClaudecodeMcp = class _ClaudecodeMcp extends ToolMcp {
   }
 };
 
-// src/mcp/cline-mcp.ts
+// src/features/mcp/cline-mcp.ts
 import { join as join28 } from "path";
 var ClineMcp = class _ClineMcp extends ToolMcp {
   json;
@@ -3145,7 +3153,7 @@ var ClineMcp = class _ClineMcp extends ToolMcp {
   }
 };
 
-// src/mcp/codexcli-mcp.ts
+// src/features/mcp/codexcli-mcp.ts
 import { join as join29 } from "path";
 import * as smolToml from "smol-toml";
 var CodexcliMcp = class _CodexcliMcp extends ToolMcp {
@@ -3239,7 +3247,7 @@ var CodexcliMcp = class _CodexcliMcp extends ToolMcp {
   }
 };
 
-// src/mcp/copilot-mcp.ts
+// src/features/mcp/copilot-mcp.ts
 import { join as join30 } from "path";
 var CopilotMcp = class _CopilotMcp extends ToolMcp {
   json;
@@ -3296,7 +3304,7 @@ var CopilotMcp = class _CopilotMcp extends ToolMcp {
   }
 };
 
-// src/mcp/cursor-mcp.ts
+// src/features/mcp/cursor-mcp.ts
 import { join as join31 } from "path";
 var CursorMcp = class _CursorMcp extends ToolMcp {
   json;
@@ -3364,7 +3372,7 @@ var CursorMcp = class _CursorMcp extends ToolMcp {
   }
 };
 
-// src/mcp/geminicli-mcp.ts
+// src/features/mcp/geminicli-mcp.ts
 import { join as join32 } from "path";
 var GeminiCliMcp = class _GeminiCliMcp extends ToolMcp {
   json;
@@ -3438,7 +3446,7 @@ var GeminiCliMcp = class _GeminiCliMcp extends ToolMcp {
   }
 };
 
-// src/mcp/roo-mcp.ts
+// src/features/mcp/roo-mcp.ts
 import { join as join33 } from "path";
 var RooMcp = class _RooMcp extends ToolMcp {
   json;
@@ -3496,7 +3504,7 @@ var RooMcp = class _RooMcp extends ToolMcp {
   }
 };
 
-// src/mcp/mcp-processor.ts
+// src/features/mcp/mcp-processor.ts
 var mcpProcessorToolTargets = [
   "amazonqcli",
   "claudecode",
@@ -3742,19 +3750,19 @@ var McpProcessor = class extends FeatureProcessor {
   }
 };
 
-// src/rules/rules-processor.ts
+// src/features/rules/rules-processor.ts
 import { basename as basename17, join as join63 } from "path";
 import { XMLBuilder } from "fast-xml-parser";
 import { z as z22 } from "zod/mini";
 
-// src/subagents/agentsmd-subagent.ts
+// src/features/subagents/agentsmd-subagent.ts
 import { join as join35 } from "path";
 
-// src/subagents/simulated-subagent.ts
+// src/features/subagents/simulated-subagent.ts
 import { basename as basename12, join as join34 } from "path";
 import { z as z14 } from "zod/mini";
 
-// src/subagents/tool-subagent.ts
+// src/features/subagents/tool-subagent.ts
 var ToolSubagent = class extends ToolFile {
   static getSettablePaths() {
     throw new Error("Please implement this method in the subclass.");
@@ -3786,7 +3794,7 @@ var ToolSubagent = class extends ToolFile {
   }
 };
 
-// src/subagents/simulated-subagent.ts
+// src/features/subagents/simulated-subagent.ts
 var SimulatedSubagentFrontmatterSchema = z14.object({
   name: z14.string(),
   description: z14.string()
@@ -3878,7 +3886,7 @@ var SimulatedSubagent = class extends ToolSubagent {
   }
 };
 
-// src/subagents/agentsmd-subagent.ts
+// src/features/subagents/agentsmd-subagent.ts
 var AgentsmdSubagent = class _AgentsmdSubagent extends SimulatedSubagent {
   static getSettablePaths() {
     return {
@@ -3901,7 +3909,7 @@ var AgentsmdSubagent = class _AgentsmdSubagent extends SimulatedSubagent {
   }
 };
 
-// src/subagents/codexcli-subagent.ts
+// src/features/subagents/codexcli-subagent.ts
 import { join as join36 } from "path";
 var CodexCliSubagent = class _CodexCliSubagent extends SimulatedSubagent {
   static getSettablePaths() {
@@ -3925,7 +3933,7 @@ var CodexCliSubagent = class _CodexCliSubagent extends SimulatedSubagent {
   }
 };
 
-// src/subagents/copilot-subagent.ts
+// src/features/subagents/copilot-subagent.ts
 import { join as join37 } from "path";
 var CopilotSubagent = class _CopilotSubagent extends SimulatedSubagent {
   static getSettablePaths() {
@@ -3949,7 +3957,7 @@ var CopilotSubagent = class _CopilotSubagent extends SimulatedSubagent {
   }
 };
 
-// src/subagents/cursor-subagent.ts
+// src/features/subagents/cursor-subagent.ts
 import { join as join38 } from "path";
 var CursorSubagent = class _CursorSubagent extends SimulatedSubagent {
   static getSettablePaths() {
@@ -3973,7 +3981,7 @@ var CursorSubagent = class _CursorSubagent extends SimulatedSubagent {
   }
 };
 
-// src/subagents/geminicli-subagent.ts
+// src/features/subagents/geminicli-subagent.ts
 import { join as join39 } from "path";
 var GeminiCliSubagent = class _GeminiCliSubagent extends SimulatedSubagent {
   static getSettablePaths() {
@@ -3997,7 +4005,7 @@ var GeminiCliSubagent = class _GeminiCliSubagent extends SimulatedSubagent {
   }
 };
 
-// src/subagents/roo-subagent.ts
+// src/features/subagents/roo-subagent.ts
 import { join as join40 } from "path";
 var RooSubagent = class _RooSubagent extends SimulatedSubagent {
   static getSettablePaths() {
@@ -4021,15 +4029,15 @@ var RooSubagent = class _RooSubagent extends SimulatedSubagent {
   }
 };
 
-// src/subagents/subagents-processor.ts
+// src/features/subagents/subagents-processor.ts
 import { basename as basename14, join as join43 } from "path";
 import { z as z17 } from "zod/mini";
 
-// src/subagents/claudecode-subagent.ts
+// src/features/subagents/claudecode-subagent.ts
 import { join as join42 } from "path";
 import { z as z16 } from "zod/mini";
 
-// src/subagents/rulesync-subagent.ts
+// src/features/subagents/rulesync-subagent.ts
 import { basename as basename13, join as join41 } from "path";
 import { z as z15 } from "zod/mini";
 var RulesyncSubagentModelSchema = z15.enum(["opus", "sonnet", "haiku", "inherit"]);
@@ -4056,7 +4064,8 @@ var RulesyncSubagent = class _RulesyncSubagent extends RulesyncFile {
       }
     }
     super({
-      ...rest
+      ...rest,
+      fileContent: stringifyFrontmatter(body, frontmatter)
     });
     this.frontmatter = frontmatter;
     this.body = body;
@@ -4105,13 +4114,12 @@ var RulesyncSubagent = class _RulesyncSubagent extends RulesyncFile {
       relativeDirPath: this.getSettablePaths().relativeDirPath,
       relativeFilePath: filename,
       frontmatter: result.data,
-      body: content.trim(),
-      fileContent
+      body: content.trim()
     });
   }
 };
 
-// src/subagents/claudecode-subagent.ts
+// src/features/subagents/claudecode-subagent.ts
 var ClaudecodeSubagentFrontmatterSchema = z16.object({
   name: z16.string(),
   description: z16.string(),
@@ -4157,7 +4165,6 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
         }
       }
     };
-    const fileContent = stringifyFrontmatter(this.body, rulesyncFrontmatter);
     return new RulesyncSubagent({
       baseDir: ".",
       // RulesyncCommand baseDir is always the project root directory
@@ -4165,7 +4172,6 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
       body: this.body,
       relativeDirPath: join42(".rulesync", "subagents"),
       relativeFilePath: this.getRelativeFilePath(),
-      fileContent,
       validate: true
     });
   }
@@ -4242,7 +4248,7 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
   }
 };
 
-// src/subagents/subagents-processor.ts
+// src/features/subagents/subagents-processor.ts
 var subagentsProcessorToolTargets = [
   "agentsmd",
   "claudecode",
@@ -4538,13 +4544,13 @@ var SubagentsProcessor = class extends FeatureProcessor {
   }
 };
 
-// src/rules/agentsmd-rule.ts
+// src/features/rules/agentsmd-rule.ts
 import { join as join46 } from "path";
 
-// src/rules/tool-rule.ts
+// src/features/rules/tool-rule.ts
 import { join as join45 } from "path";
 
-// src/rules/rulesync-rule.ts
+// src/features/rules/rulesync-rule.ts
 import { basename as basename15, join as join44 } from "path";
 import { z as z18 } from "zod/mini";
 var RulesyncRuleFrontmatterSchema = z18.object({
@@ -4690,7 +4696,7 @@ var RulesyncRule = class _RulesyncRule extends RulesyncFile {
   }
 };
 
-// src/rules/tool-rule.ts
+// src/features/rules/tool-rule.ts
 var ToolRule = class extends ToolFile {
   root;
   description;
@@ -4811,7 +4817,7 @@ var ToolRule = class extends ToolFile {
   }
 };
 
-// src/rules/agentsmd-rule.ts
+// src/features/rules/agentsmd-rule.ts
 var AgentsMdRule = class _AgentsMdRule extends ToolRule {
   constructor({ fileContent, root, ...rest }) {
     super({
@@ -4877,7 +4883,7 @@ var AgentsMdRule = class _AgentsMdRule extends ToolRule {
   }
 };
 
-// src/rules/amazonqcli-rule.ts
+// src/features/rules/amazonqcli-rule.ts
 import { join as join47 } from "path";
 var AmazonQCliRule = class _AmazonQCliRule extends ToolRule {
   static getSettablePaths() {
@@ -4932,7 +4938,7 @@ var AmazonQCliRule = class _AmazonQCliRule extends ToolRule {
   }
 };
 
-// src/rules/augmentcode-legacy-rule.ts
+// src/features/rules/augmentcode-legacy-rule.ts
 import { join as join48 } from "path";
 var AugmentcodeLegacyRule = class _AugmentcodeLegacyRule extends ToolRule {
   toRulesyncRule() {
@@ -5007,7 +5013,7 @@ var AugmentcodeLegacyRule = class _AugmentcodeLegacyRule extends ToolRule {
   }
 };
 
-// src/rules/augmentcode-rule.ts
+// src/features/rules/augmentcode-rule.ts
 import { join as join49 } from "path";
 var AugmentcodeRule = class _AugmentcodeRule extends ToolRule {
   toRulesyncRule() {
@@ -5062,7 +5068,7 @@ var AugmentcodeRule = class _AugmentcodeRule extends ToolRule {
   }
 };
 
-// src/rules/claudecode-rule.ts
+// src/features/rules/claudecode-rule.ts
 import { join as join50 } from "path";
 var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
   static getSettablePaths({
@@ -5153,7 +5159,7 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
   }
 };
 
-// src/rules/cline-rule.ts
+// src/features/rules/cline-rule.ts
 import { join as join51 } from "path";
 import { z as z19 } from "zod/mini";
 var ClineRuleFrontmatterSchema = z19.object({
@@ -5211,7 +5217,7 @@ var ClineRule = class _ClineRule extends ToolRule {
   }
 };
 
-// src/rules/codexcli-rule.ts
+// src/features/rules/codexcli-rule.ts
 import { join as join52 } from "path";
 var CodexcliRule = class _CodexcliRule extends ToolRule {
   static getSettablePaths({
@@ -5302,7 +5308,7 @@ var CodexcliRule = class _CodexcliRule extends ToolRule {
   }
 };
 
-// src/rules/copilot-rule.ts
+// src/features/rules/copilot-rule.ts
 import { join as join53 } from "path";
 import { z as z20 } from "zod/mini";
 var CopilotRuleFrontmatterSchema = z20.object({
@@ -5472,7 +5478,7 @@ var CopilotRule = class _CopilotRule extends ToolRule {
   }
 };
 
-// src/rules/cursor-rule.ts
+// src/features/rules/cursor-rule.ts
 import { basename as basename16, join as join54 } from "path";
 import { z as z21 } from "zod/mini";
 var CursorRuleFrontmatterSchema = z21.object({
@@ -5660,7 +5666,7 @@ var CursorRule = class _CursorRule extends ToolRule {
   }
 };
 
-// src/rules/geminicli-rule.ts
+// src/features/rules/geminicli-rule.ts
 import { join as join55 } from "path";
 var GeminiCliRule = class _GeminiCliRule extends ToolRule {
   static getSettablePaths({
@@ -5751,7 +5757,7 @@ var GeminiCliRule = class _GeminiCliRule extends ToolRule {
   }
 };
 
-// src/rules/junie-rule.ts
+// src/features/rules/junie-rule.ts
 import { join as join56 } from "path";
 var JunieRule = class _JunieRule extends ToolRule {
   static getSettablePaths() {
@@ -5811,7 +5817,7 @@ var JunieRule = class _JunieRule extends ToolRule {
   }
 };
 
-// src/rules/kiro-rule.ts
+// src/features/rules/kiro-rule.ts
 import { join as join57 } from "path";
 var KiroRule = class _KiroRule extends ToolRule {
   static getSettablePaths() {
@@ -5866,7 +5872,7 @@ var KiroRule = class _KiroRule extends ToolRule {
   }
 };
 
-// src/rules/opencode-rule.ts
+// src/features/rules/opencode-rule.ts
 import { join as join58 } from "path";
 var OpenCodeRule = class _OpenCodeRule extends ToolRule {
   static getSettablePaths() {
@@ -5926,7 +5932,7 @@ var OpenCodeRule = class _OpenCodeRule extends ToolRule {
   }
 };
 
-// src/rules/qwencode-rule.ts
+// src/features/rules/qwencode-rule.ts
 import { join as join59 } from "path";
 var QwencodeRule = class _QwencodeRule extends ToolRule {
   static getSettablePaths() {
@@ -5983,7 +5989,7 @@ var QwencodeRule = class _QwencodeRule extends ToolRule {
   }
 };
 
-// src/rules/roo-rule.ts
+// src/features/rules/roo-rule.ts
 import { join as join60 } from "path";
 var RooRule = class _RooRule extends ToolRule {
   static getSettablePaths() {
@@ -6053,7 +6059,7 @@ var RooRule = class _RooRule extends ToolRule {
   }
 };
 
-// src/rules/warp-rule.ts
+// src/features/rules/warp-rule.ts
 import { join as join61 } from "path";
 var WarpRule = class _WarpRule extends ToolRule {
   constructor({ fileContent, root, ...rest }) {
@@ -6120,7 +6126,7 @@ var WarpRule = class _WarpRule extends ToolRule {
   }
 };
 
-// src/rules/windsurf-rule.ts
+// src/features/rules/windsurf-rule.ts
 import { join as join62 } from "path";
 var WindsurfRule = class _WindsurfRule extends ToolRule {
   static getSettablePaths() {
@@ -6174,7 +6180,7 @@ var WindsurfRule = class _WindsurfRule extends ToolRule {
   }
 };
 
-// src/rules/rules-processor.ts
+// src/features/rules/rules-processor.ts
 var rulesProcessorToolTargets = [
   "agentsmd",
   "amazonqcli",
@@ -7684,111 +7690,494 @@ Attention, again, you are just the planner, so though you can read any files and
 }
 
 // src/cli/commands/mcp.ts
-import { basename as basename18, join as join66 } from "path";
 import { FastMCP } from "fastmcp";
+
+// src/mcp/commands.ts
+import { basename as basename18, join as join66 } from "path";
 import { z as z23 } from "zod/mini";
-var MAX_RULE_SIZE_BYTES = 1024 * 1024;
-var MAX_RULES_COUNT = 1e3;
-var RULES_DIR_PREFIX = ".rulesync/rules";
-function validateRulePath(relativePathFromCwd) {
-  const normalizedPath = relativePathFromCwd.replace(/\\/g, "/");
-  if (!normalizedPath.startsWith(`${RULES_DIR_PREFIX}/`)) {
-    throw new Error(`Invalid rule path: must be within ${RULES_DIR_PREFIX}/ directory`);
-  }
-  try {
-    resolvePath(normalizedPath, process.cwd());
-  } catch (error) {
-    throw new Error(`Path validation failed: ${formatError(error)}`, { cause: error });
-  }
-  const filename = basename18(normalizedPath);
-  if (!/^[a-zA-Z0-9_-]+\.md$/.test(filename)) {
-    throw new Error(
-      `Invalid filename: ${filename}. Must match pattern [a-zA-Z0-9_-]+.md (alphanumeric, hyphens, underscores only)`
-    );
-  }
-}
-async function listRules() {
-  const rulesDir = join66(process.cwd(), ".rulesync", "rules");
+var maxCommandSizeBytes = 1024 * 1024;
+var maxCommandsCount = 1e3;
+async function listCommands() {
+  const commandsDir = join66(process.cwd(), ".rulesync", "commands");
   try {
-    const files = await listDirectoryFiles(rulesDir);
+    const files = await listDirectoryFiles(commandsDir);
     const mdFiles = files.filter((file) => file.endsWith(".md"));
-    const rules = await Promise.all(
+    const commands = await Promise.all(
       mdFiles.map(async (file) => {
         try {
-          const rule = await RulesyncRule.fromFile({
-            relativeFilePath: file,
-            validate: true
+          const command = await RulesyncCommand.fromFile({
+            relativeFilePath: file
           });
-          const frontmatter = rule.getFrontmatter();
+          const frontmatter = command.getFrontmatter();
           return {
-            relativePathFromCwd: join66(".rulesync", "rules", file),
+            relativePathFromCwd: join66(".rulesync", "commands", file),
             frontmatter
           };
         } catch (error) {
-          logger.error(`Failed to read rule file ${file}: ${formatError(error)}`);
+          logger.error(`Failed to read command file ${file}: ${formatError(error)}`);
           return null;
         }
       })
     );
-    return rules.filter((rule) => rule !== null);
+    return commands.filter((command) => command !== null);
   } catch (error) {
-    logger.error(`Failed to read rules directory: ${formatError(error)}`);
+    logger.error(`Failed to read commands directory: ${formatError(error)}`);
     return [];
   }
 }
-async function getRule({ relativePathFromCwd }) {
-  validateRulePath(relativePathFromCwd);
+async function getCommand({ relativePathFromCwd }) {
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
   const filename = basename18(relativePathFromCwd);
   try {
-    const rule = await RulesyncRule.fromFile({
-      relativeFilePath: filename,
-      validate: true
+    const command = await RulesyncCommand.fromFile({
+      relativeFilePath: filename
     });
     return {
-      relativePathFromCwd: join66(".rulesync", "rules", filename),
-      frontmatter: rule.getFrontmatter(),
-      body: rule.getBody()
+      relativePathFromCwd: join66(".rulesync", "commands", filename),
+      frontmatter: command.getFrontmatter(),
+      body: command.getBody()
     };
   } catch (error) {
-    throw new Error(`Failed to read rule file ${relativePathFromCwd}: ${formatError(error)}`, {
+    throw new Error(`Failed to read command file ${relativePathFromCwd}: ${formatError(error)}`, {
       cause: error
     });
   }
 }
-async function putRule({
+async function putCommand({
   relativePathFromCwd,
   frontmatter,
   body
 }) {
-  validateRulePath(relativePathFromCwd);
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
   const filename = basename18(relativePathFromCwd);
   const estimatedSize = JSON.stringify(frontmatter).length + body.length;
-  if (estimatedSize > MAX_RULE_SIZE_BYTES) {
+  if (estimatedSize > maxCommandSizeBytes) {
     throw new Error(
-      `Rule size ${estimatedSize} bytes exceeds maximum ${MAX_RULE_SIZE_BYTES} bytes (1MB)`
+      `Command size ${estimatedSize} bytes exceeds maximum ${maxCommandSizeBytes} bytes (1MB)`
     );
   }
   try {
-    const existingRules = await listRules();
-    const isUpdate = existingRules.some(
-      (rule2) => rule2.relativePathFromCwd === join66(".rulesync", "rules", filename)
+    const existingCommands = await listCommands();
+    const isUpdate = existingCommands.some(
+      (command2) => command2.relativePathFromCwd === join66(".rulesync", "commands", filename)
     );
-    if (!isUpdate && existingRules.length >= MAX_RULES_COUNT) {
-      throw new Error(`Maximum number of rules (${MAX_RULES_COUNT}) reached`);
+    if (!isUpdate && existingCommands.length >= maxCommandsCount) {
+      throw new Error(`Maximum number of commands (${maxCommandsCount}) reached`);
+    }
+    const fileContent = stringifyFrontmatter(body, frontmatter);
+    const command = new RulesyncCommand({
+      baseDir: process.cwd(),
+      relativeDirPath: join66(".rulesync", "commands"),
+      relativeFilePath: filename,
+      frontmatter,
+      body,
+      fileContent,
+      validate: true
+    });
+    const commandsDir = join66(process.cwd(), ".rulesync", "commands");
+    await ensureDir(commandsDir);
+    await writeFileContent(command.getFilePath(), command.getFileContent());
+    return {
+      relativePathFromCwd: join66(".rulesync", "commands", filename),
+      frontmatter: command.getFrontmatter(),
+      body: command.getBody()
+    };
+  } catch (error) {
+    throw new Error(`Failed to write command file ${relativePathFromCwd}: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function deleteCommand({ relativePathFromCwd }) {
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
+  const filename = basename18(relativePathFromCwd);
+  const fullPath = join66(process.cwd(), ".rulesync", "commands", filename);
+  try {
+    await removeFile(fullPath);
+    return {
+      relativePathFromCwd: join66(".rulesync", "commands", filename)
+    };
+  } catch (error) {
+    throw new Error(`Failed to delete command file ${relativePathFromCwd}: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+var commandToolSchemas = {
+  listCommands: z23.object({}),
+  getCommand: z23.object({
+    relativePathFromCwd: z23.string()
+  }),
+  putCommand: z23.object({
+    relativePathFromCwd: z23.string(),
+    frontmatter: RulesyncCommandFrontmatterSchema,
+    body: z23.string()
+  }),
+  deleteCommand: z23.object({
+    relativePathFromCwd: z23.string()
+  })
+};
+var commandTools = {
+  listCommands: {
+    name: "listCommands",
+    description: `List all commands from ${join66(".rulesync", "commands", "*.md")} with their frontmatter.`,
+    parameters: commandToolSchemas.listCommands,
+    execute: async () => {
+      const commands = await listCommands();
+      const output = { commands };
+      return JSON.stringify(output, null, 2);
+    }
+  },
+  getCommand: {
+    name: "getCommand",
+    description: "Get detailed information about a specific command. relativePathFromCwd parameter is required.",
+    parameters: commandToolSchemas.getCommand,
+    execute: async (args) => {
+      const result = await getCommand({ relativePathFromCwd: args.relativePathFromCwd });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  putCommand: {
+    name: "putCommand",
+    description: "Create or update a command (upsert operation). relativePathFromCwd, frontmatter, and body parameters are required.",
+    parameters: commandToolSchemas.putCommand,
+    execute: async (args) => {
+      const result = await putCommand({
+        relativePathFromCwd: args.relativePathFromCwd,
+        frontmatter: args.frontmatter,
+        body: args.body
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  deleteCommand: {
+    name: "deleteCommand",
+    description: "Delete a command file. relativePathFromCwd parameter is required.",
+    parameters: commandToolSchemas.deleteCommand,
+    execute: async (args) => {
+      const result = await deleteCommand({ relativePathFromCwd: args.relativePathFromCwd });
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/mcp/ignore.ts
+import { join as join67 } from "path";
+import { z as z24 } from "zod/mini";
+var maxIgnoreFileSizeBytes = 100 * 1024;
+async function getIgnoreFile() {
+  const ignoreFilePath = join67(process.cwd(), ".rulesyncignore");
+  try {
+    const content = await readFileContent(ignoreFilePath);
+    return {
+      relativePathFromCwd: ".rulesyncignore",
+      content
+    };
+  } catch (error) {
+    throw new Error(`Failed to read .rulesyncignore file: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function putIgnoreFile({ content }) {
+  const ignoreFilePath = join67(process.cwd(), ".rulesyncignore");
+  const contentSizeBytes = Buffer.byteLength(content, "utf8");
+  if (contentSizeBytes > maxIgnoreFileSizeBytes) {
+    throw new Error(
+      `Ignore file size ${contentSizeBytes} bytes exceeds maximum ${maxIgnoreFileSizeBytes} bytes (100KB)`
+    );
+  }
+  try {
+    await ensureDir(process.cwd());
+    await writeFileContent(ignoreFilePath, content);
+    return {
+      relativePathFromCwd: ".rulesyncignore",
+      content
+    };
+  } catch (error) {
+    throw new Error(`Failed to write .rulesyncignore file: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function deleteIgnoreFile() {
+  const ignoreFilePath = join67(process.cwd(), ".rulesyncignore");
+  try {
+    await removeFile(ignoreFilePath);
+    return {
+      relativePathFromCwd: ".rulesyncignore"
+    };
+  } catch (error) {
+    throw new Error(`Failed to delete .rulesyncignore file: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+var ignoreToolSchemas = {
+  getIgnoreFile: z24.object({}),
+  putIgnoreFile: z24.object({
+    content: z24.string()
+  }),
+  deleteIgnoreFile: z24.object({})
+};
+var ignoreTools = {
+  getIgnoreFile: {
+    name: "getIgnoreFile",
+    description: "Get the content of the .rulesyncignore file from the project root.",
+    parameters: ignoreToolSchemas.getIgnoreFile,
+    execute: async () => {
+      const result = await getIgnoreFile();
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  putIgnoreFile: {
+    name: "putIgnoreFile",
+    description: "Create or update the .rulesyncignore file (upsert operation). content parameter is required.",
+    parameters: ignoreToolSchemas.putIgnoreFile,
+    execute: async (args) => {
+      const result = await putIgnoreFile({ content: args.content });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  deleteIgnoreFile: {
+    name: "deleteIgnoreFile",
+    description: "Delete the .rulesyncignore file from the project root.",
+    parameters: ignoreToolSchemas.deleteIgnoreFile,
+    execute: async () => {
+      const result = await deleteIgnoreFile();
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/mcp/mcp.ts
+import { join as join68 } from "path";
+import { z as z25 } from "zod/mini";
+var maxMcpSizeBytes = 1024 * 1024;
+async function getMcpFile() {
+  try {
+    const rulesyncMcp = await RulesyncMcp.fromFile({
+      validate: true,
+      modularMcp: false
+    });
+    const relativePathFromCwd = join68(
+      rulesyncMcp.getRelativeDirPath(),
+      rulesyncMcp.getRelativeFilePath()
+    );
+    return {
+      relativePathFromCwd,
+      content: rulesyncMcp.getFileContent()
+    };
+  } catch (error) {
+    throw new Error(`Failed to read MCP file: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function putMcpFile({ content }) {
+  if (content.length > maxMcpSizeBytes) {
+    throw new Error(
+      `MCP file size ${content.length} bytes exceeds maximum ${maxMcpSizeBytes} bytes (1MB)`
+    );
+  }
+  try {
+    JSON.parse(content);
+  } catch (error) {
+    throw new Error(`Invalid JSON format in MCP file: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+  try {
+    const baseDir = process.cwd();
+    const paths = RulesyncMcp.getSettablePaths();
+    const relativeDirPath = paths.recommended.relativeDirPath;
+    const relativeFilePath = paths.recommended.relativeFilePath;
+    const fullPath = join68(baseDir, relativeDirPath, relativeFilePath);
+    const rulesyncMcp = new RulesyncMcp({
+      baseDir,
+      relativeDirPath,
+      relativeFilePath,
+      fileContent: content,
+      validate: true,
+      modularMcp: false
+    });
+    await ensureDir(join68(baseDir, relativeDirPath));
+    await writeFileContent(fullPath, content);
+    const relativePathFromCwd = join68(relativeDirPath, relativeFilePath);
+    return {
+      relativePathFromCwd,
+      content: rulesyncMcp.getFileContent()
+    };
+  } catch (error) {
+    throw new Error(`Failed to write MCP file: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function deleteMcpFile() {
+  try {
+    const baseDir = process.cwd();
+    const paths = RulesyncMcp.getSettablePaths();
+    const recommendedPath = join68(
+      baseDir,
+      paths.recommended.relativeDirPath,
+      paths.recommended.relativeFilePath
+    );
+    const legacyPath = join68(baseDir, paths.legacy.relativeDirPath, paths.legacy.relativeFilePath);
+    await removeFile(recommendedPath);
+    await removeFile(legacyPath);
+    const relativePathFromCwd = join68(
+      paths.recommended.relativeDirPath,
+      paths.recommended.relativeFilePath
+    );
+    return {
+      relativePathFromCwd
+    };
+  } catch (error) {
+    throw new Error(`Failed to delete MCP file: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+var mcpToolSchemas = {
+  getMcpFile: z25.object({}),
+  putMcpFile: z25.object({
+    content: z25.string()
+  }),
+  deleteMcpFile: z25.object({})
+};
+var mcpTools = {
+  getMcpFile: {
+    name: "getMcpFile",
+    description: `Get the MCP configuration file (${join68(".rulesync", "mcp.json")}).`,
+    parameters: mcpToolSchemas.getMcpFile,
+    execute: async () => {
+      const result = await getMcpFile();
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  putMcpFile: {
+    name: "putMcpFile",
+    description: "Create or update the MCP configuration file (upsert operation). content parameter is required and must be valid JSON.",
+    parameters: mcpToolSchemas.putMcpFile,
+    execute: async (args) => {
+      const result = await putMcpFile({ content: args.content });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  deleteMcpFile: {
+    name: "deleteMcpFile",
+    description: "Delete the MCP configuration file.",
+    parameters: mcpToolSchemas.deleteMcpFile,
+    execute: async () => {
+      const result = await deleteMcpFile();
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/mcp/rules.ts
+import { basename as basename19, join as join69 } from "path";
+import { z as z26 } from "zod/mini";
+var maxRuleSizeBytes = 1024 * 1024;
+var maxRulesCount = 1e3;
+async function listRules() {
+  const rulesDir = join69(process.cwd(), ".rulesync", "rules");
+  try {
+    const files = await listDirectoryFiles(rulesDir);
+    const mdFiles = files.filter((file) => file.endsWith(".md"));
+    const rules = await Promise.all(
+      mdFiles.map(async (file) => {
+        try {
+          const rule = await RulesyncRule.fromFile({
+            relativeFilePath: file,
+            validate: true
+          });
+          const frontmatter = rule.getFrontmatter();
+          return {
+            relativePathFromCwd: join69(".rulesync", "rules", file),
+            frontmatter
+          };
+        } catch (error) {
+          logger.error(`Failed to read rule file ${file}: ${formatError(error)}`);
+          return null;
+        }
+      })
+    );
+    return rules.filter((rule) => rule !== null);
+  } catch (error) {
+    logger.error(`Failed to read rules directory: ${formatError(error)}`);
+    return [];
+  }
+}
+async function getRule({ relativePathFromCwd }) {
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
+  const filename = basename19(relativePathFromCwd);
+  try {
+    const rule = await RulesyncRule.fromFile({
+      relativeFilePath: filename,
+      validate: true
+    });
+    return {
+      relativePathFromCwd: join69(".rulesync", "rules", filename),
+      frontmatter: rule.getFrontmatter(),
+      body: rule.getBody()
+    };
+  } catch (error) {
+    throw new Error(`Failed to read rule file ${relativePathFromCwd}: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function putRule({
+  relativePathFromCwd,
+  frontmatter,
+  body
+}) {
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
+  const filename = basename19(relativePathFromCwd);
+  const estimatedSize = JSON.stringify(frontmatter).length + body.length;
+  if (estimatedSize > maxRuleSizeBytes) {
+    throw new Error(
+      `Rule size ${estimatedSize} bytes exceeds maximum ${maxRuleSizeBytes} bytes (1MB)`
+    );
+  }
+  try {
+    const existingRules = await listRules();
+    const isUpdate = existingRules.some(
+      (rule2) => rule2.relativePathFromCwd === join69(".rulesync", "rules", filename)
+    );
+    if (!isUpdate && existingRules.length >= maxRulesCount) {
+      throw new Error(`Maximum number of rules (${maxRulesCount}) reached`);
     }
     const rule = new RulesyncRule({
       baseDir: process.cwd(),
-      relativeDirPath: ".rulesync/rules",
+      relativeDirPath: join69(".rulesync", "rules"),
       relativeFilePath: filename,
       frontmatter,
       body,
       validate: true
     });
-    const rulesDir = join66(process.cwd(), ".rulesync", "rules");
+    const rulesDir = join69(process.cwd(), ".rulesync", "rules");
     await ensureDir(rulesDir);
     await writeFileContent(rule.getFilePath(), rule.getFileContent());
     return {
-      relativePathFromCwd: join66(".rulesync", "rules", filename),
+      relativePathFromCwd: join69(".rulesync", "rules", filename),
       frontmatter: rule.getFrontmatter(),
       body: rule.getBody()
     };
@@ -7799,13 +8188,16 @@ async function putRule({
   }
 }
 async function deleteRule({ relativePathFromCwd }) {
-  validateRulePath(relativePathFromCwd);
-  const filename = basename18(relativePathFromCwd);
-  const fullPath = join66(process.cwd(), ".rulesync", "rules", filename);
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
+  const filename = basename19(relativePathFromCwd);
+  const fullPath = join69(process.cwd(), ".rulesync", "rules", filename);
   try {
     await removeFile(fullPath);
     return {
-      relativePathFromCwd: join66(".rulesync", "rules", filename)
+      relativePathFromCwd: join69(".rulesync", "rules", filename)
     };
   } catch (error) {
     throw new Error(`Failed to delete rule file ${relativePathFromCwd}: ${formatError(error)}`, {
@@ -7813,42 +8205,44 @@ async function deleteRule({ relativePathFromCwd }) {
     });
   }
 }
-async function mcpCommand({ version }) {
-  const server = new FastMCP({
-    name: "rulesync-mcp-server",
-    // Type assertion is safe here because version comes from package.json which follows semver
-    // eslint-disable-next-line no-type-assertion/no-type-assertion
-    version
-  });
-  server.addTool({
+var ruleToolSchemas = {
+  listRules: z26.object({}),
+  getRule: z26.object({
+    relativePathFromCwd: z26.string()
+  }),
+  putRule: z26.object({
+    relativePathFromCwd: z26.string(),
+    frontmatter: RulesyncRuleFrontmatterSchema,
+    body: z26.string()
+  }),
+  deleteRule: z26.object({
+    relativePathFromCwd: z26.string()
+  })
+};
+var ruleTools = {
+  listRules: {
     name: "listRules",
-    description: "List all rules from .rulesync/rules/*.md with their frontmatter",
-    parameters: z23.object({}),
+    description: `List all rules from ${join69(".rulesync", "rules", "*.md")} with their frontmatter.`,
+    parameters: ruleToolSchemas.listRules,
     execute: async () => {
       const rules = await listRules();
       const output = { rules };
       return JSON.stringify(output, null, 2);
     }
-  });
-  server.addTool({
+  },
+  getRule: {
     name: "getRule",
     description: "Get detailed information about a specific rule. relativePathFromCwd parameter is required.",
-    parameters: z23.object({
-      relativePathFromCwd: z23.string()
-    }),
+    parameters: ruleToolSchemas.getRule,
     execute: async (args) => {
       const result = await getRule({ relativePathFromCwd: args.relativePathFromCwd });
       return JSON.stringify(result, null, 2);
     }
-  });
-  server.addTool({
+  },
+  putRule: {
     name: "putRule",
     description: "Create or update a rule (upsert operation). relativePathFromCwd, frontmatter, and body parameters are required.",
-    parameters: z23.object({
-      relativePathFromCwd: z23.string(),
-      frontmatter: RulesyncRuleFrontmatterSchema,
-      body: z23.string()
-    }),
+    parameters: ruleToolSchemas.putRule,
     execute: async (args) => {
       const result = await putRule({
         relativePathFromCwd: args.relativePathFromCwd,
@@ -7857,18 +8251,227 @@ async function mcpCommand({ version }) {
       });
       return JSON.stringify(result, null, 2);
     }
-  });
-  server.addTool({
+  },
+  deleteRule: {
     name: "deleteRule",
     description: "Delete a rule file. relativePathFromCwd parameter is required.",
-    parameters: z23.object({
-      relativePathFromCwd: z23.string()
-    }),
+    parameters: ruleToolSchemas.deleteRule,
     execute: async (args) => {
       const result = await deleteRule({ relativePathFromCwd: args.relativePathFromCwd });
       return JSON.stringify(result, null, 2);
     }
+  }
+};
+
+// src/mcp/subagents.ts
+import { basename as basename20, join as join70 } from "path";
+import { z as z27 } from "zod/mini";
+var maxSubagentSizeBytes = 1024 * 1024;
+var maxSubagentsCount = 1e3;
+async function listSubagents() {
+  const subagentsDir = join70(process.cwd(), ".rulesync", "subagents");
+  try {
+    const files = await listDirectoryFiles(subagentsDir);
+    const mdFiles = files.filter((file) => file.endsWith(".md"));
+    const subagents = await Promise.all(
+      mdFiles.map(async (file) => {
+        try {
+          const subagent = await RulesyncSubagent.fromFile({
+            relativeFilePath: file,
+            validate: true
+          });
+          const frontmatter = subagent.getFrontmatter();
+          return {
+            relativePathFromCwd: join70(".rulesync", "subagents", file),
+            frontmatter
+          };
+        } catch (error) {
+          logger.error(`Failed to read subagent file ${file}: ${formatError(error)}`);
+          return null;
+        }
+      })
+    );
+    return subagents.filter(
+      (subagent) => subagent !== null
+    );
+  } catch (error) {
+    logger.error(`Failed to read subagents directory: ${formatError(error)}`);
+    return [];
+  }
+}
+async function getSubagent({ relativePathFromCwd }) {
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
+  const filename = basename20(relativePathFromCwd);
+  try {
+    const subagent = await RulesyncSubagent.fromFile({
+      relativeFilePath: filename,
+      validate: true
+    });
+    return {
+      relativePathFromCwd: join70(".rulesync", "subagents", filename),
+      frontmatter: subagent.getFrontmatter(),
+      body: subagent.getBody()
+    };
+  } catch (error) {
+    throw new Error(`Failed to read subagent file ${relativePathFromCwd}: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function putSubagent({
+  relativePathFromCwd,
+  frontmatter,
+  body
+}) {
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
+  const filename = basename20(relativePathFromCwd);
+  const estimatedSize = JSON.stringify(frontmatter).length + body.length;
+  if (estimatedSize > maxSubagentSizeBytes) {
+    throw new Error(
+      `Subagent size ${estimatedSize} bytes exceeds maximum ${maxSubagentSizeBytes} bytes (1MB)`
+    );
+  }
+  try {
+    const existingSubagents = await listSubagents();
+    const isUpdate = existingSubagents.some(
+      (subagent2) => subagent2.relativePathFromCwd === join70(".rulesync", "subagents", filename)
+    );
+    if (!isUpdate && existingSubagents.length >= maxSubagentsCount) {
+      throw new Error(`Maximum number of subagents (${maxSubagentsCount}) reached`);
+    }
+    const subagent = new RulesyncSubagent({
+      baseDir: process.cwd(),
+      relativeDirPath: join70(".rulesync", "subagents"),
+      relativeFilePath: filename,
+      frontmatter,
+      body,
+      validate: true
+    });
+    const subagentsDir = join70(process.cwd(), ".rulesync", "subagents");
+    await ensureDir(subagentsDir);
+    await writeFileContent(subagent.getFilePath(), subagent.getFileContent());
+    return {
+      relativePathFromCwd: join70(".rulesync", "subagents", filename),
+      frontmatter: subagent.getFrontmatter(),
+      body: subagent.getBody()
+    };
+  } catch (error) {
+    throw new Error(`Failed to write subagent file ${relativePathFromCwd}: ${formatError(error)}`, {
+      cause: error
+    });
+  }
+}
+async function deleteSubagent({ relativePathFromCwd }) {
+  checkPathTraversal({
+    relativePath: relativePathFromCwd,
+    intendedRootDir: process.cwd()
+  });
+  const filename = basename20(relativePathFromCwd);
+  const fullPath = join70(process.cwd(), ".rulesync", "subagents", filename);
+  try {
+    await removeFile(fullPath);
+    return {
+      relativePathFromCwd: join70(".rulesync", "subagents", filename)
+    };
+  } catch (error) {
+    throw new Error(
+      `Failed to delete subagent file ${relativePathFromCwd}: ${formatError(error)}`,
+      {
+        cause: error
+      }
+    );
+  }
+}
+var subagentToolSchemas = {
+  listSubagents: z27.object({}),
+  getSubagent: z27.object({
+    relativePathFromCwd: z27.string()
+  }),
+  putSubagent: z27.object({
+    relativePathFromCwd: z27.string(),
+    frontmatter: RulesyncSubagentFrontmatterSchema,
+    body: z27.string()
+  }),
+  deleteSubagent: z27.object({
+    relativePathFromCwd: z27.string()
+  })
+};
+var subagentTools = {
+  listSubagents: {
+    name: "listSubagents",
+    description: `List all subagents from ${join70(".rulesync", "subagents", "*.md")} with their frontmatter.`,
+    parameters: subagentToolSchemas.listSubagents,
+    execute: async () => {
+      const subagents = await listSubagents();
+      const output = { subagents };
+      return JSON.stringify(output, null, 2);
+    }
+  },
+  getSubagent: {
+    name: "getSubagent",
+    description: "Get detailed information about a specific subagent. relativePathFromCwd parameter is required.",
+    parameters: subagentToolSchemas.getSubagent,
+    execute: async (args) => {
+      const result = await getSubagent({ relativePathFromCwd: args.relativePathFromCwd });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  putSubagent: {
+    name: "putSubagent",
+    description: "Create or update a subagent (upsert operation). relativePathFromCwd, frontmatter, and body parameters are required.",
+    parameters: subagentToolSchemas.putSubagent,
+    execute: async (args) => {
+      const result = await putSubagent({
+        relativePathFromCwd: args.relativePathFromCwd,
+        frontmatter: args.frontmatter,
+        body: args.body
+      });
+      return JSON.stringify(result, null, 2);
+    }
+  },
+  deleteSubagent: {
+    name: "deleteSubagent",
+    description: "Delete a subagent file. relativePathFromCwd parameter is required.",
+    parameters: subagentToolSchemas.deleteSubagent,
+    execute: async (args) => {
+      const result = await deleteSubagent({ relativePathFromCwd: args.relativePathFromCwd });
+      return JSON.stringify(result, null, 2);
+    }
+  }
+};
+
+// src/cli/commands/mcp.ts
+async function mcpCommand({ version }) {
+  const server = new FastMCP({
+    name: "Rulesync MCP Server",
+    // eslint-disable-next-line no-type-assertion/no-type-assertion
+    version,
+    instructions: "This server handles Rulesync files including rules, commands, MCP, ignore files, and subagents for any AI agents. It should be used when you need those files."
   });
+  server.addTool(ruleTools.listRules);
+  server.addTool(ruleTools.getRule);
+  server.addTool(ruleTools.putRule);
+  server.addTool(ruleTools.deleteRule);
+  server.addTool(commandTools.listCommands);
+  server.addTool(commandTools.getCommand);
+  server.addTool(commandTools.putCommand);
+  server.addTool(commandTools.deleteCommand);
+  server.addTool(subagentTools.listSubagents);
+  server.addTool(subagentTools.getSubagent);
+  server.addTool(subagentTools.putSubagent);
+  server.addTool(subagentTools.deleteSubagent);
+  server.addTool(ignoreTools.getIgnoreFile);
+  server.addTool(ignoreTools.putIgnoreFile);
+  server.addTool(ignoreTools.deleteIgnoreFile);
+  server.addTool(mcpTools.getMcpFile);
+  server.addTool(mcpTools.putMcpFile);
+  server.addTool(mcpTools.deleteMcpFile);
   logger.info("Rulesync MCP server started via stdio");
   void server.start({
     transportType: "stdio"
@@ -7876,7 +8479,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.19.0";
+var getVersion = () => "3.20.0";
 var main = async () => {
   const program = new Command();
   const version = getVersion();