rulesync 3.7.0 → 3.8.0

package/README.md

@@ -77,8 +77,8 @@ Rulesync supports both **generation** and **import** for All of the major AI cod
 | Warp               |  ✅   |        |      |         |          |
 
 * ✅: Supports project mode
-* 🌏: Supports global mode (Experimental)
-* 🎮: Supports simulated commands/subagents (Project mode only, experimental)
+* 🌏: Supports global mode
+* 🎮: Supports simulated commands/subagents (Project mode only)
 
 ## Why Rulesync?
 
@@ -98,10 +98,10 @@ Avoid lock-in completely. If you decide to stop using Rulesync, you can continue
 Apply consistent rules across all AI tools, improving code quality and development experience for the entire team.
 
 ### 🌏 **Global Mode**
-You can use global mode via Rulesync by enabling `--experimental-global` option.
+You can use global mode via Rulesync by enabling `--global` option.
 
 ### 🎮 **Simulated Commands and Subagents**
-Simulated commands and subagents are experimental features that allow you to generate simulated commands and subagents for copilot, cursor and codexcli. This is useful for shortening your prompts.
+Simulated commands and subagents allow you to generate simulated commands and subagents for copilot, cursor and codexcli. This is useful for shortening your prompts.
 
 ## Quick Commands
 
@@ -122,8 +122,8 @@ npx rulesync generate --targets claudecode --features rules,subagents
 # Generate only rules (no MCP, ignore files, commands, or subagents)
 npx rulesync generate --targets "*" --features rules
 
-# Generate simulated commands and subagents with experimental features
-npx rulesync generate --targets copilot,cursor,codexcli --features commands,subagents --experimental-simulate-commands --experimental-simulate-subagents
+# Generate simulated commands and subagents
+npx rulesync generate --targets copilot,cursor,codexcli --features commands,subagents --simulated-commands --simulated-subagents
 
 # Add generated files to .gitignore
 npx rulesync gitignore
@@ -155,10 +155,15 @@ Example:
   // Verbose output
   "verbose": false,
 
-  // Experimental features
-  "experimentalGlobal": false,
-  "experimentalSimulateCommands": false,
-  "experimentalSimulateSubagents": false
+  // Advanced options
+  "global": false,  // Generate for global(user scope) configuration files
+  "simulatedCommands": false,  // Generate simulated commands
+  "simulatedSubagents": false  // Generate simulated subagents
+
+  // Deprecated experimental options (for backward compatibility)
+  // "experimentalGlobal": false,
+  // "experimentalSimulateCommands": false,
+  // "experimentalSimulateSubagents": false
 }
 ```
 
@@ -281,9 +286,9 @@ tmp/
 credentials/
 ```
 
-## Global Mode(Experimental Feature)
+## Global Mode
 
-You can use global mode via Rulesync by enabling `--experimental-global` option. It can also be called as user scope mode.
+You can use global mode via Rulesync by enabling `--global` option. It can also be called as user scope mode.
 
 Currently, supports rules and commands generation for Claude Code. Import for global files is supported for rules and commands.
 
@@ -299,7 +304,7 @@ Currently, supports rules and commands generation for Claude Code. Import for gl
 3. Edit `~/.aiglobal/rulesync.jsonc` to enable global mode.
     ```jsonc
     {
-      "experimentalGlobal": true
+      "global": true
     }
     ```
 4. Edit `~/.aiglobal/.rulesync/rules/overview.md` to your preferences.
@@ -322,9 +327,9 @@ Currently, supports rules and commands generation for Claude Code. Import for gl
 > * `rules/*.md` only supports single file has `root: true`, and frontmatter parameters without `root` are ignored.
 > * Only Claude Code is supported for global mode commands.
 
-## Simulate Commands and Subagents(Experimental Feature)
+## Simulate Commands and Subagents
 
-Simulated commands and subagents are experimental features that allow you to generate simulated commands and subagents for copilot, cursor, codexcli and etc. This is useful for shortening your prompts.
+Simulated commands and subagents allow you to generate simulated commands and subagents for copilot, cursor, codexcli and etc. This is useful for shortening your prompts.
 
 1. Prepare `.rulesync/commands/*.md` and `.rulesync/subagents/*.md` for your purposes.
 2. Generate simulated commands and subagents for specific tools that are included in copilot, cursor, codexcli and etc.
@@ -332,8 +337,8 @@ Simulated commands and subagents are experimental features that allow you to gen
     npx rulesync generate \
       --targets copilot,cursor,codexcli \
       --features commands,subagents \
-      --experimental-simulate-commands \
-      --experimental-simulate-subagents
+      --simulated-commands \
+      --simulated-subagents
     ```
 3. Use simulated commands and subagents in your prompts.
     - Prompt examples:

package/dist/index.cjs

@@ -1648,15 +1648,18 @@ var Config = class {
   features;
   verbose;
   delete;
-  experimentalGlobal;
-  experimentalSimulateCommands;
-  experimentalSimulateSubagents;
+  global;
+  simulatedCommands;
+  simulatedSubagents;
   constructor({
     baseDirs,
     targets,
     features,
     verbose,
     delete: isDelete,
+    global,
+    simulatedCommands,
+    simulatedSubagents,
     experimentalGlobal,
     experimentalSimulateCommands,
     experimentalSimulateSubagents
@@ -1666,9 +1669,9 @@ var Config = class {
     this.features = features;
     this.verbose = verbose;
     this.delete = isDelete;
-    this.experimentalGlobal = experimentalGlobal;
-    this.experimentalSimulateCommands = experimentalSimulateCommands;
-    this.experimentalSimulateSubagents = experimentalSimulateSubagents;
+    this.global = global ?? experimentalGlobal ?? false;
+    this.simulatedCommands = simulatedCommands ?? experimentalSimulateCommands ?? false;
+    this.simulatedSubagents = simulatedSubagents ?? experimentalSimulateSubagents ?? false;
   }
   getBaseDirs() {
     return this.baseDirs;
@@ -1691,14 +1694,27 @@ var Config = class {
   getDelete() {
     return this.delete;
   }
+  getGlobal() {
+    return this.global;
+  }
+  getSimulatedCommands() {
+    return this.simulatedCommands;
+  }
+  getSimulatedSubagents() {
+    return this.simulatedSubagents;
+  }
+  // Deprecated getters for backward compatibility
+  /** @deprecated Use getGlobal() instead */
   getExperimentalGlobal() {
-    return this.experimentalGlobal;
+    return this.global;
   }
+  /** @deprecated Use getSimulatedCommands() instead */
   getExperimentalSimulateCommands() {
-    return this.experimentalSimulateCommands;
+    return this.simulatedCommands;
   }
+  /** @deprecated Use getSimulatedSubagents() instead */
   getExperimentalSimulateSubagents() {
-    return this.experimentalSimulateSubagents;
+    return this.simulatedSubagents;
   }
 };
 
@@ -1710,6 +1726,9 @@ var defaults = {
   delete: false,
   baseDirs: ["."],
   configPath: "rulesync.jsonc",
+  global: false,
+  simulatedCommands: false,
+  simulatedSubagents: false,
   experimentalGlobal: false,
   experimentalSimulateCommands: false,
   experimentalSimulateSubagents: false
@@ -1722,11 +1741,26 @@ var ConfigResolver = class {
     delete: isDelete,
     baseDirs,
     configPath = defaults.configPath,
+    global,
+    simulatedCommands,
+    simulatedSubagents,
     experimentalGlobal,
     experimentalSimulateCommands,
     experimentalSimulateSubagents
   }) {
     if (!await fileExists(configPath)) {
+      if (experimentalGlobal !== void 0) {
+        warnDeprecatedOptions({ experimentalGlobal });
+      }
+      if (experimentalSimulateCommands !== void 0) {
+        warnDeprecatedOptions({ experimentalSimulateCommands });
+      }
+      if (experimentalSimulateSubagents !== void 0) {
+        warnDeprecatedOptions({ experimentalSimulateSubagents });
+      }
+      const resolvedGlobal2 = global ?? experimentalGlobal ?? defaults.global;
+      const resolvedSimulatedCommands2 = simulatedCommands ?? experimentalSimulateCommands ?? defaults.simulatedCommands;
+      const resolvedSimulatedSubagents2 = simulatedSubagents ?? experimentalSimulateSubagents ?? defaults.simulatedSubagents;
       return new Config({
         targets: targets ?? defaults.targets,
         features: features ?? defaults.features,
@@ -1734,11 +1768,11 @@ var ConfigResolver = class {
         delete: isDelete ?? defaults.delete,
         baseDirs: getBaseDirsInLightOfGlobal({
           baseDirs: baseDirs ?? defaults.baseDirs,
-          global: experimentalGlobal ?? defaults.experimentalGlobal
+          global: resolvedGlobal2
         }),
-        experimentalGlobal: experimentalGlobal ?? defaults.experimentalGlobal,
-        experimentalSimulateCommands: experimentalSimulateCommands ?? defaults.experimentalSimulateCommands,
-        experimentalSimulateSubagents: experimentalSimulateSubagents ?? defaults.experimentalSimulateSubagents
+        global: resolvedGlobal2,
+        simulatedCommands: resolvedSimulatedCommands2,
+        simulatedSubagents: resolvedSimulatedSubagents2
       });
     }
     const loadOptions = {
@@ -1753,6 +1787,21 @@ var ConfigResolver = class {
       loadOptions.configFile = configPath;
     }
     const { config: configByFile } = await (0, import_c12.loadConfig)(loadOptions);
+    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,
@@ -1760,15 +1809,34 @@ var ConfigResolver = class {
       delete: isDelete ?? configByFile.delete ?? defaults.delete,
       baseDirs: getBaseDirsInLightOfGlobal({
         baseDirs: baseDirs ?? configByFile.baseDirs ?? defaults.baseDirs,
-        global: experimentalGlobal ?? configByFile.experimentalGlobal ?? defaults.experimentalGlobal
+        global: resolvedGlobal
       }),
-      experimentalGlobal: experimentalGlobal ?? configByFile.experimentalGlobal ?? defaults.experimentalGlobal,
-      experimentalSimulateCommands: experimentalSimulateCommands ?? configByFile.experimentalSimulateCommands ?? defaults.experimentalSimulateCommands,
-      experimentalSimulateSubagents: experimentalSimulateSubagents ?? configByFile.experimentalSimulateSubagents ?? defaults.experimentalSimulateSubagents
+      global: resolvedGlobal,
+      simulatedCommands: resolvedSimulatedCommands,
+      simulatedSubagents: resolvedSimulatedSubagents
     };
     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
@@ -6783,15 +6851,15 @@ async function generateRules(config) {
   }
   let totalRulesOutputs = 0;
   logger.info("Generating rule files...");
-  const toolTargets = config.getExperimentalGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), RulesProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(config.getTargets(), RulesProcessor.getToolTargets());
+  const toolTargets = config.getGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), RulesProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(config.getTargets(), RulesProcessor.getToolTargets());
   for (const baseDir of config.getBaseDirs()) {
     for (const toolTarget of toolTargets) {
       const processor = new RulesProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal(),
-        simulateCommands: config.getExperimentalSimulateCommands(),
-        simulateSubagents: config.getExperimentalSimulateSubagents()
+        global: config.getGlobal(),
+        simulateCommands: config.getSimulatedCommands(),
+        simulateSubagents: config.getSimulatedSubagents()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6814,7 +6882,7 @@ async function generateIgnore(config) {
     logger.debug("Skipping ignore file generation (not in --features)");
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
+  if (config.getGlobal()) {
     logger.debug("Skipping ignore file generation (not supported in global mode)");
     return 0;
   }
@@ -6856,13 +6924,13 @@ async function generateMcp(config) {
   }
   let totalMcpOutputs = 0;
   logger.info("Generating MCP files...");
-  const toolTargets = config.getExperimentalGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), McpProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(config.getTargets(), McpProcessor.getToolTargets());
+  const toolTargets = config.getGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), McpProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(config.getTargets(), McpProcessor.getToolTargets());
   for (const baseDir of config.getBaseDirs()) {
     for (const toolTarget of toolTargets) {
       const processor = new McpProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal()
+        global: config.getGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6884,10 +6952,10 @@ async function generateCommands(config) {
   }
   let totalCommandOutputs = 0;
   logger.info("Generating command files...");
-  const toolTargets = config.getExperimentalGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), CommandsProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(
+  const toolTargets = config.getGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), CommandsProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(
     config.getTargets(),
     CommandsProcessor.getToolTargets({
-      includeSimulated: config.getExperimentalSimulateCommands()
+      includeSimulated: config.getSimulatedCommands()
     })
   );
   for (const baseDir of config.getBaseDirs()) {
@@ -6895,7 +6963,7 @@ async function generateCommands(config) {
       const processor = new CommandsProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal()
+        global: config.getGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6917,10 +6985,10 @@ async function generateSubagents(config) {
   }
   let totalSubagentOutputs = 0;
   logger.info("Generating subagent files...");
-  const toolTargets = config.getExperimentalGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), SubagentsProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(
+  const toolTargets = config.getGlobal() ? (0, import_es_toolkit2.intersection)(config.getTargets(), SubagentsProcessor.getToolTargetsGlobal()) : (0, import_es_toolkit2.intersection)(
     config.getTargets(),
     SubagentsProcessor.getToolTargets({
-      includeSimulated: config.getExperimentalSimulateSubagents()
+      includeSimulated: config.getSimulatedSubagents()
     })
   );
   for (const baseDir of config.getBaseDirs()) {
@@ -6928,7 +6996,7 @@ async function generateSubagents(config) {
       const processor = new SubagentsProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal()
+        global: config.getGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -7060,7 +7128,7 @@ async function importRules(config, tool) {
   if (!config.getFeatures().includes("rules")) {
     return 0;
   }
-  const global = config.getExperimentalGlobal();
+  const global = config.getGlobal();
   const supportedTargets = global ? RulesProcessor.getToolTargetsGlobal() : RulesProcessor.getToolTargets();
   if (!supportedTargets.includes(tool)) {
     return 0;
@@ -7085,7 +7153,7 @@ async function importIgnore(config, tool) {
   if (!config.getFeatures().includes("ignore")) {
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
+  if (config.getGlobal()) {
     logger.debug("Skipping ignore file import (not supported in global mode)");
     return 0;
   }
@@ -7114,7 +7182,7 @@ async function importMcp(config, tool) {
   if (!config.getFeatures().includes("mcp")) {
     return 0;
   }
-  const global = config.getExperimentalGlobal();
+  const global = config.getGlobal();
   const supportedTargets = global ? McpProcessor.getToolTargetsGlobal() : McpProcessor.getToolTargets();
   if (!supportedTargets.includes(tool)) {
     return 0;
@@ -7139,7 +7207,7 @@ async function importCommands(config, tool) {
   if (!config.getFeatures().includes("commands")) {
     return 0;
   }
-  const global = config.getExperimentalGlobal();
+  const global = config.getGlobal();
   const supportedTargets = global ? CommandsProcessor.getToolTargetsGlobal() : CommandsProcessor.getToolTargets({ includeSimulated: false });
   if (!supportedTargets.includes(tool)) {
     return 0;
@@ -7171,7 +7239,7 @@ async function importSubagents(config, tool) {
   const subagentsProcessor = new SubagentsProcessor({
     baseDir: config.getBaseDirs()[0] ?? ".",
     toolTarget: tool,
-    global: config.getExperimentalGlobal()
+    global: config.getGlobal()
   });
   const toolFiles = await subagentsProcessor.loadToolFiles();
   if (toolFiles.length === 0) {
@@ -7211,9 +7279,9 @@ async function createConfigFile() {
         baseDirs: ["."],
         delete: true,
         verbose: false,
-        experimentalGlobal: false,
-        experimentalSimulateCommands: false,
-        experimentalSimulateSubagents: false
+        global: false,
+        simulatedCommands: false,
+        simulatedSubagents: false
       },
       null,
       2
@@ -7384,7 +7452,7 @@ Attention, again, you are just the planner, so though you can read any files and
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.7.0";
+var getVersion = () => "3.8.0";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();
@@ -7408,13 +7476,17 @@ var main = async () => {
     (value) => {
       return value.split(",").map((f) => f.trim());
     }
-  ).option("-V, --verbose", "Verbose output").option("-g, --experimental-global", "Import for global(user scope) configuration files").action(async (options) => {
+  ).option("-V, --verbose", "Verbose output").option("-g, --global", "Import for global(user scope) configuration files").option(
+    "--experimental-global",
+    "Import for global(user scope) configuration files (deprecated: use --global instead)"
+  ).action(async (options) => {
     try {
       await importCommand({
         targets: options.targets,
         features: options.features,
         verbose: options.verbose,
         configPath: options.config,
+        global: options.global,
         experimentalGlobal: options.experimentalGlobal
       });
     } catch (error) {
@@ -7437,12 +7509,21 @@ var main = async () => {
   ).option("--delete", "Delete all existing files in output directories before generating").option(
     "-b, --base-dir <paths>",
     "Base directories to generate files (comma-separated for multiple paths)"
-  ).option("-V, --verbose", "Verbose output").option("-c, --config <path>", "Path to configuration file").option("-g, --experimental-global", "Generate for global(user scope) configuration files").option(
+  ).option("-V, --verbose", "Verbose output").option("-c, --config <path>", "Path to configuration file").option("-g, --global", "Generate for global(user scope) configuration files").option(
+    "--simulated-commands",
+    "Generate simulated commands. This feature is only available for copilot, cursor and codexcli."
+  ).option(
+    "--simulated-subagents",
+    "Generate simulated subagents. This feature is only available for copilot, cursor and codexcli."
+  ).option(
+    "--experimental-global",
+    "Generate for global(user scope) configuration files (deprecated: use --global instead)"
+  ).option(
     "--experimental-simulate-commands",
-    "Generate simulated commands (experimental feature). This feature is only available for copilot, cursor and codexcli."
+    "Generate simulated commands (deprecated: use --simulated-commands instead)"
   ).option(
     "--experimental-simulate-subagents",
-    "Generate simulated subagents (experimental feature). This feature is only available for copilot, cursor and codexcli."
+    "Generate simulated subagents (deprecated: use --simulated-subagents instead)"
   ).action(async (options) => {
     try {
       await generateCommand({
@@ -7452,6 +7533,9 @@ var main = async () => {
         delete: options.delete,
         baseDirs: options.baseDirs,
         configPath: options.config,
+        global: options.global,
+        simulatedCommands: options.simulatedCommands,
+        simulatedSubagents: options.simulatedSubagents,
         experimentalGlobal: options.experimentalGlobal,
         experimentalSimulateCommands: options.experimentalSimulateCommands,
         experimentalSimulateSubagents: options.experimentalSimulateSubagents

package/dist/index.js

@@ -1625,15 +1625,18 @@ var Config = class {
   features;
   verbose;
   delete;
-  experimentalGlobal;
-  experimentalSimulateCommands;
-  experimentalSimulateSubagents;
+  global;
+  simulatedCommands;
+  simulatedSubagents;
   constructor({
     baseDirs,
     targets,
     features,
     verbose,
     delete: isDelete,
+    global,
+    simulatedCommands,
+    simulatedSubagents,
     experimentalGlobal,
     experimentalSimulateCommands,
     experimentalSimulateSubagents
@@ -1643,9 +1646,9 @@ var Config = class {
     this.features = features;
     this.verbose = verbose;
     this.delete = isDelete;
-    this.experimentalGlobal = experimentalGlobal;
-    this.experimentalSimulateCommands = experimentalSimulateCommands;
-    this.experimentalSimulateSubagents = experimentalSimulateSubagents;
+    this.global = global ?? experimentalGlobal ?? false;
+    this.simulatedCommands = simulatedCommands ?? experimentalSimulateCommands ?? false;
+    this.simulatedSubagents = simulatedSubagents ?? experimentalSimulateSubagents ?? false;
   }
   getBaseDirs() {
     return this.baseDirs;
@@ -1668,14 +1671,27 @@ var Config = class {
   getDelete() {
     return this.delete;
   }
+  getGlobal() {
+    return this.global;
+  }
+  getSimulatedCommands() {
+    return this.simulatedCommands;
+  }
+  getSimulatedSubagents() {
+    return this.simulatedSubagents;
+  }
+  // Deprecated getters for backward compatibility
+  /** @deprecated Use getGlobal() instead */
   getExperimentalGlobal() {
-    return this.experimentalGlobal;
+    return this.global;
   }
+  /** @deprecated Use getSimulatedCommands() instead */
   getExperimentalSimulateCommands() {
-    return this.experimentalSimulateCommands;
+    return this.simulatedCommands;
   }
+  /** @deprecated Use getSimulatedSubagents() instead */
   getExperimentalSimulateSubagents() {
-    return this.experimentalSimulateSubagents;
+    return this.simulatedSubagents;
   }
 };
 
@@ -1687,6 +1703,9 @@ var defaults = {
   delete: false,
   baseDirs: ["."],
   configPath: "rulesync.jsonc",
+  global: false,
+  simulatedCommands: false,
+  simulatedSubagents: false,
   experimentalGlobal: false,
   experimentalSimulateCommands: false,
   experimentalSimulateSubagents: false
@@ -1699,11 +1718,26 @@ var ConfigResolver = class {
     delete: isDelete,
     baseDirs,
     configPath = defaults.configPath,
+    global,
+    simulatedCommands,
+    simulatedSubagents,
     experimentalGlobal,
     experimentalSimulateCommands,
     experimentalSimulateSubagents
   }) {
     if (!await fileExists(configPath)) {
+      if (experimentalGlobal !== void 0) {
+        warnDeprecatedOptions({ experimentalGlobal });
+      }
+      if (experimentalSimulateCommands !== void 0) {
+        warnDeprecatedOptions({ experimentalSimulateCommands });
+      }
+      if (experimentalSimulateSubagents !== void 0) {
+        warnDeprecatedOptions({ experimentalSimulateSubagents });
+      }
+      const resolvedGlobal2 = global ?? experimentalGlobal ?? defaults.global;
+      const resolvedSimulatedCommands2 = simulatedCommands ?? experimentalSimulateCommands ?? defaults.simulatedCommands;
+      const resolvedSimulatedSubagents2 = simulatedSubagents ?? experimentalSimulateSubagents ?? defaults.simulatedSubagents;
       return new Config({
         targets: targets ?? defaults.targets,
         features: features ?? defaults.features,
@@ -1711,11 +1745,11 @@ var ConfigResolver = class {
         delete: isDelete ?? defaults.delete,
         baseDirs: getBaseDirsInLightOfGlobal({
           baseDirs: baseDirs ?? defaults.baseDirs,
-          global: experimentalGlobal ?? defaults.experimentalGlobal
+          global: resolvedGlobal2
         }),
-        experimentalGlobal: experimentalGlobal ?? defaults.experimentalGlobal,
-        experimentalSimulateCommands: experimentalSimulateCommands ?? defaults.experimentalSimulateCommands,
-        experimentalSimulateSubagents: experimentalSimulateSubagents ?? defaults.experimentalSimulateSubagents
+        global: resolvedGlobal2,
+        simulatedCommands: resolvedSimulatedCommands2,
+        simulatedSubagents: resolvedSimulatedSubagents2
       });
     }
     const loadOptions = {
@@ -1730,6 +1764,21 @@ var ConfigResolver = class {
       loadOptions.configFile = configPath;
     }
     const { config: configByFile } = await loadConfig(loadOptions);
+    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,
@@ -1737,15 +1786,34 @@ var ConfigResolver = class {
       delete: isDelete ?? configByFile.delete ?? defaults.delete,
       baseDirs: getBaseDirsInLightOfGlobal({
         baseDirs: baseDirs ?? configByFile.baseDirs ?? defaults.baseDirs,
-        global: experimentalGlobal ?? configByFile.experimentalGlobal ?? defaults.experimentalGlobal
+        global: resolvedGlobal
       }),
-      experimentalGlobal: experimentalGlobal ?? configByFile.experimentalGlobal ?? defaults.experimentalGlobal,
-      experimentalSimulateCommands: experimentalSimulateCommands ?? configByFile.experimentalSimulateCommands ?? defaults.experimentalSimulateCommands,
-      experimentalSimulateSubagents: experimentalSimulateSubagents ?? configByFile.experimentalSimulateSubagents ?? defaults.experimentalSimulateSubagents
+      global: resolvedGlobal,
+      simulatedCommands: resolvedSimulatedCommands,
+      simulatedSubagents: resolvedSimulatedSubagents
     };
     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
@@ -6760,15 +6828,15 @@ async function generateRules(config) {
   }
   let totalRulesOutputs = 0;
   logger.info("Generating rule files...");
-  const toolTargets = config.getExperimentalGlobal() ? intersection(config.getTargets(), RulesProcessor.getToolTargetsGlobal()) : intersection(config.getTargets(), RulesProcessor.getToolTargets());
+  const toolTargets = config.getGlobal() ? intersection(config.getTargets(), RulesProcessor.getToolTargetsGlobal()) : intersection(config.getTargets(), RulesProcessor.getToolTargets());
   for (const baseDir of config.getBaseDirs()) {
     for (const toolTarget of toolTargets) {
       const processor = new RulesProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal(),
-        simulateCommands: config.getExperimentalSimulateCommands(),
-        simulateSubagents: config.getExperimentalSimulateSubagents()
+        global: config.getGlobal(),
+        simulateCommands: config.getSimulatedCommands(),
+        simulateSubagents: config.getSimulatedSubagents()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6791,7 +6859,7 @@ async function generateIgnore(config) {
     logger.debug("Skipping ignore file generation (not in --features)");
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
+  if (config.getGlobal()) {
     logger.debug("Skipping ignore file generation (not supported in global mode)");
     return 0;
   }
@@ -6833,13 +6901,13 @@ async function generateMcp(config) {
   }
   let totalMcpOutputs = 0;
   logger.info("Generating MCP files...");
-  const toolTargets = config.getExperimentalGlobal() ? intersection(config.getTargets(), McpProcessor.getToolTargetsGlobal()) : intersection(config.getTargets(), McpProcessor.getToolTargets());
+  const toolTargets = config.getGlobal() ? intersection(config.getTargets(), McpProcessor.getToolTargetsGlobal()) : intersection(config.getTargets(), McpProcessor.getToolTargets());
   for (const baseDir of config.getBaseDirs()) {
     for (const toolTarget of toolTargets) {
       const processor = new McpProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal()
+        global: config.getGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6861,10 +6929,10 @@ async function generateCommands(config) {
   }
   let totalCommandOutputs = 0;
   logger.info("Generating command files...");
-  const toolTargets = config.getExperimentalGlobal() ? intersection(config.getTargets(), CommandsProcessor.getToolTargetsGlobal()) : intersection(
+  const toolTargets = config.getGlobal() ? intersection(config.getTargets(), CommandsProcessor.getToolTargetsGlobal()) : intersection(
     config.getTargets(),
     CommandsProcessor.getToolTargets({
-      includeSimulated: config.getExperimentalSimulateCommands()
+      includeSimulated: config.getSimulatedCommands()
     })
   );
   for (const baseDir of config.getBaseDirs()) {
@@ -6872,7 +6940,7 @@ async function generateCommands(config) {
       const processor = new CommandsProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal()
+        global: config.getGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6894,10 +6962,10 @@ async function generateSubagents(config) {
   }
   let totalSubagentOutputs = 0;
   logger.info("Generating subagent files...");
-  const toolTargets = config.getExperimentalGlobal() ? intersection(config.getTargets(), SubagentsProcessor.getToolTargetsGlobal()) : intersection(
+  const toolTargets = config.getGlobal() ? intersection(config.getTargets(), SubagentsProcessor.getToolTargetsGlobal()) : intersection(
     config.getTargets(),
     SubagentsProcessor.getToolTargets({
-      includeSimulated: config.getExperimentalSimulateSubagents()
+      includeSimulated: config.getSimulatedSubagents()
     })
   );
   for (const baseDir of config.getBaseDirs()) {
@@ -6905,7 +6973,7 @@ async function generateSubagents(config) {
       const processor = new SubagentsProcessor({
         baseDir,
         toolTarget,
-        global: config.getExperimentalGlobal()
+        global: config.getGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -7037,7 +7105,7 @@ async function importRules(config, tool) {
   if (!config.getFeatures().includes("rules")) {
     return 0;
   }
-  const global = config.getExperimentalGlobal();
+  const global = config.getGlobal();
   const supportedTargets = global ? RulesProcessor.getToolTargetsGlobal() : RulesProcessor.getToolTargets();
   if (!supportedTargets.includes(tool)) {
     return 0;
@@ -7062,7 +7130,7 @@ async function importIgnore(config, tool) {
   if (!config.getFeatures().includes("ignore")) {
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
+  if (config.getGlobal()) {
     logger.debug("Skipping ignore file import (not supported in global mode)");
     return 0;
   }
@@ -7091,7 +7159,7 @@ async function importMcp(config, tool) {
   if (!config.getFeatures().includes("mcp")) {
     return 0;
   }
-  const global = config.getExperimentalGlobal();
+  const global = config.getGlobal();
   const supportedTargets = global ? McpProcessor.getToolTargetsGlobal() : McpProcessor.getToolTargets();
   if (!supportedTargets.includes(tool)) {
     return 0;
@@ -7116,7 +7184,7 @@ async function importCommands(config, tool) {
   if (!config.getFeatures().includes("commands")) {
     return 0;
   }
-  const global = config.getExperimentalGlobal();
+  const global = config.getGlobal();
   const supportedTargets = global ? CommandsProcessor.getToolTargetsGlobal() : CommandsProcessor.getToolTargets({ includeSimulated: false });
   if (!supportedTargets.includes(tool)) {
     return 0;
@@ -7148,7 +7216,7 @@ async function importSubagents(config, tool) {
   const subagentsProcessor = new SubagentsProcessor({
     baseDir: config.getBaseDirs()[0] ?? ".",
     toolTarget: tool,
-    global: config.getExperimentalGlobal()
+    global: config.getGlobal()
   });
   const toolFiles = await subagentsProcessor.loadToolFiles();
   if (toolFiles.length === 0) {
@@ -7188,9 +7256,9 @@ async function createConfigFile() {
         baseDirs: ["."],
         delete: true,
         verbose: false,
-        experimentalGlobal: false,
-        experimentalSimulateCommands: false,
-        experimentalSimulateSubagents: false
+        global: false,
+        simulatedCommands: false,
+        simulatedSubagents: false
       },
       null,
       2
@@ -7361,7 +7429,7 @@ Attention, again, you are just the planner, so though you can read any files and
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.7.0";
+var getVersion = () => "3.8.0";
 var main = async () => {
   const program = new Command();
   const version = getVersion();
@@ -7385,13 +7453,17 @@ var main = async () => {
     (value) => {
       return value.split(",").map((f) => f.trim());
     }
-  ).option("-V, --verbose", "Verbose output").option("-g, --experimental-global", "Import for global(user scope) configuration files").action(async (options) => {
+  ).option("-V, --verbose", "Verbose output").option("-g, --global", "Import for global(user scope) configuration files").option(
+    "--experimental-global",
+    "Import for global(user scope) configuration files (deprecated: use --global instead)"
+  ).action(async (options) => {
     try {
       await importCommand({
         targets: options.targets,
         features: options.features,
         verbose: options.verbose,
         configPath: options.config,
+        global: options.global,
         experimentalGlobal: options.experimentalGlobal
       });
     } catch (error) {
@@ -7414,12 +7486,21 @@ var main = async () => {
   ).option("--delete", "Delete all existing files in output directories before generating").option(
     "-b, --base-dir <paths>",
     "Base directories to generate files (comma-separated for multiple paths)"
-  ).option("-V, --verbose", "Verbose output").option("-c, --config <path>", "Path to configuration file").option("-g, --experimental-global", "Generate for global(user scope) configuration files").option(
+  ).option("-V, --verbose", "Verbose output").option("-c, --config <path>", "Path to configuration file").option("-g, --global", "Generate for global(user scope) configuration files").option(
+    "--simulated-commands",
+    "Generate simulated commands. This feature is only available for copilot, cursor and codexcli."
+  ).option(
+    "--simulated-subagents",
+    "Generate simulated subagents. This feature is only available for copilot, cursor and codexcli."
+  ).option(
+    "--experimental-global",
+    "Generate for global(user scope) configuration files (deprecated: use --global instead)"
+  ).option(
     "--experimental-simulate-commands",
-    "Generate simulated commands (experimental feature). This feature is only available for copilot, cursor and codexcli."
+    "Generate simulated commands (deprecated: use --simulated-commands instead)"
   ).option(
     "--experimental-simulate-subagents",
-    "Generate simulated subagents (experimental feature). This feature is only available for copilot, cursor and codexcli."
+    "Generate simulated subagents (deprecated: use --simulated-subagents instead)"
   ).action(async (options) => {
     try {
       await generateCommand({
@@ -7429,6 +7510,9 @@ var main = async () => {
         delete: options.delete,
         baseDirs: options.baseDirs,
         configPath: options.config,
+        global: options.global,
+        simulatedCommands: options.simulatedCommands,
+        simulatedSubagents: options.simulatedSubagents,
         experimentalGlobal: options.experimentalGlobal,
         experimentalSimulateCommands: options.experimentalSimulateCommands,
         experimentalSimulateSubagents: options.experimentalSimulateSubagents

package/package.json

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