rulesync 3.6.0 → 3.8.0

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
@@ -5282,6 +5350,16 @@ var CursorRule = class _CursorRule extends ToolRule {
       validate: true
     });
   }
+  /**
+   * Resolve cursor globs with priority: cursor-specific > parent
+   * Returns comma-separated string for Cursor format, or undefined if no globs
+   * @param cursorSpecificGlobs - Cursor-specific globs (takes priority if defined)
+   * @param parentGlobs - Parent globs (used if cursorSpecificGlobs is undefined)
+   */
+  static resolveCursorGlobs(cursorSpecificGlobs, parentGlobs) {
+    const targetGlobs = cursorSpecificGlobs !== void 0 ? cursorSpecificGlobs : parentGlobs;
+    return targetGlobs && targetGlobs.length > 0 ? targetGlobs.join(",") : void 0;
+  }
   static fromRulesyncRule({
     baseDir = ".",
     rulesyncRule,
@@ -5290,7 +5368,7 @@ var CursorRule = class _CursorRule extends ToolRule {
     const rulesyncFrontmatter = rulesyncRule.getFrontmatter();
     const cursorFrontmatter = {
       description: rulesyncFrontmatter.description,
-      globs: rulesyncFrontmatter.globs?.length ?? 0 > 0 ? rulesyncFrontmatter.globs?.join(",") : void 0,
+      globs: this.resolveCursorGlobs(rulesyncFrontmatter.cursor?.globs, rulesyncFrontmatter.globs),
       alwaysApply: rulesyncFrontmatter.cursor?.alwaysApply ?? void 0
     };
     const body = rulesyncRule.getBody();
@@ -6773,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();
@@ -6804,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;
   }
@@ -6846,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();
@@ -6874,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()) {
@@ -6885,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();
@@ -6907,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()) {
@@ -6918,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();
@@ -6940,53 +7018,64 @@ var gitignoreCommand = async () => {
   const gitignorePath = (0, import_node_path58.join)(process.cwd(), ".gitignore");
   const rulesFilesToIgnore = [
     "# Generated by rulesync - AI tool configuration files",
+    // AGENTS.md
+    "**/AGENTS.md",
+    "**/.agents/",
+    // Amazon Q
     "**/.amazonq/",
-    "**/.github/copilot-instructions.md",
-    "**/.github/instructions/",
-    "**/.github/prompts/",
-    "**/.cursor/",
-    "**/.cursorignore",
-    "**/.clinerules/",
-    "**/.clineignore",
+    // Augment
+    "**/.augmentignore",
+    "**/.augment/rules/",
+    "**/.augment-guidelines",
+    // Claude Code
     "**/CLAUDE.md",
     "**/.claude/memories/",
     "**/.claude/commands/",
     "**/.claude/agents/",
     "**/.claude/settings.local.json",
-    "**/AGENTS.md",
-    "**/.agents/",
-    "**/.roo/rules/",
-    "**/.rooignore",
-    "**/.copilotignore",
+    "**/.mcp.json",
+    // Cline
+    "**/.clinerules/",
+    "**/.clineignore",
+    "**/.cline/mcp.json",
+    // Codex
+    "**/.codexignore",
+    "**/.codex/",
+    // Cursor
+    "**/.cursor/",
+    "**/.cursorignore",
+    "**/.cursor/mcp.json",
+    // Gemini
     "**/GEMINI.md",
     "**/.gemini/memories/",
     "**/.gemini/commands/",
     "**/.gemini/subagents/",
-    "**/QWEN.md",
-    "**/.qwen/memories/",
-    "**/.aiexclude",
-    "**/.aiignore",
-    "**/.augmentignore",
-    "**/.kiro/steering/",
-    "**/.augment/rules/",
-    "**/.augment-guidelines",
+    // GitHub Copilot
+    "**/.github/copilot-instructions.md",
+    "**/.github/instructions/",
+    "**/.github/prompts/",
+    "**/.github/subagents/",
+    "**/.vscode/mcp.json",
+    // Junie
     "**/.junie/guidelines.md",
-    "**/.noai",
+    // Kiro
+    "**/.kiro/steering/",
+    "**/.aiignore",
+    // OpenCode
     "**/.opencode/memories/",
     "**/.opencode/commands/",
     "**/opencode.json",
-    "**/.mcp.json",
-    "**/.cursor/mcp.json",
-    "**/.cline/mcp.json",
+    // Qwen
+    "**/QWEN.md",
+    "**/.qwen/memories/",
+    // Roo
+    "**/.roo/rules/",
+    "**/.rooignore",
     "**/.roo/mcp.json",
     "**/.roo/subagents/",
-    "**/.vscode/mcp.json",
-    "**/.github/commands/",
-    "**/.github/subagents/",
+    // Warp
     "**/.warp/",
-    "**/WARP.md",
-    "**/.codexignore",
-    "**/.codex/"
+    "**/WARP.md"
   ];
   let gitignoreContent = "";
   if (await fileExists(gitignorePath)) {
@@ -7039,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;
@@ -7064,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;
   }
@@ -7093,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;
@@ -7118,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;
@@ -7150,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) {
@@ -7173,7 +7262,7 @@ async function initCommand() {
   await createConfigFile();
   logger.success("rulesync initialized successfully!");
   logger.info("Next steps:");
-  logger.info(`1. Edit rule files in .rulesync/rules/`);
+  logger.info(`1. Edit .rulesync/**/*.md, .rulesync/.mcp.json and .rulesyncignore`);
   logger.info("2. Run 'rulesync generate' to create configuration files");
 }
 async function createConfigFile() {
@@ -7190,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
@@ -7201,7 +7290,7 @@ async function createConfigFile() {
   logger.success("Created rulesync.jsonc");
 }
 async function createSampleFiles() {
-  const sampleFile = {
+  const sampleRuleFile = {
     filename: "overview.md",
     content: `---
 root: true
@@ -7236,20 +7325,134 @@ globs: ["**/*"]
 - Follow single responsibility principle
 `
   };
-  const filepath = (0, import_node_path59.join)(".rulesync/rules", sampleFile.filename);
-  await ensureDir(".rulesync/rules");
-  await ensureDir(RulesyncCommand.getSettablePaths().relativeDirPath);
-  await ensureDir(".rulesync/subagents");
-  if (!await fileExists(filepath)) {
-    await writeFileContent(filepath, sampleFile.content);
-    logger.success(`Created ${filepath}`);
+  const sampleMcpFile = {
+    filename: ".mcp.json",
+    content: `{
+  "mcpServers": {
+    "serena": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/oraios/serena",
+        "serena",
+        "start-mcp-server",
+        "--context",
+        "ide-assistant",
+        "--enable-web-dashboard",
+        "false",
+        "--project",
+        "."
+      ],
+      "env": {}
+    },
+    "context7": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@upstash/context7-mcp"
+      ],
+      "env": {}
+    }
+  }
+}
+`
+  };
+  const sampleCommandFile = {
+    filename: "review-pr.md",
+    content: `---
+description: 'Review a pull request'
+targets: ["*"]
+---
+
+target_pr = $ARGUMENTS
+
+If target_pr is not provided, use the PR of the current branch.
+
+Execute the following in parallel:
+
+1. Check code quality and style consistency
+2. Review test coverage
+3. Verify documentation updates
+4. Check for potential bugs or security issues
+
+Then provide a summary of findings and suggestions for improvement.
+`
+  };
+  const sampleSubagentFile = {
+    filename: "planner.md",
+    content: `---
+name: planner
+targets: ["*"]
+description: >-
+  This is the general-purpose planner. The user asks the agent to plan to
+  suggest a specification, implement a new feature, refactor the codebase, or
+  fix a bug. This agent can be called by the user explicitly only.
+claudecode:
+  model: inherit
+---
+
+You are the planner for any tasks.
+
+Based on the user's instruction, create a plan while analyzing the related files. Then, report the plan in detail. You can output files to @tmp/ if needed.
+
+Attention, again, you are just the planner, so though you can read any files and run any commands for analysis, please don't write any code.
+`
+  };
+  const sampleIgnoreFile = {
+    content: `credentials/
+`
+  };
+  const rulePaths = RulesyncRule.getSettablePaths();
+  const mcpPaths = RulesyncMcp.getSettablePaths();
+  const commandPaths = RulesyncCommand.getSettablePaths();
+  const subagentPaths = RulesyncSubagent.getSettablePaths();
+  const ignorePaths = RulesyncIgnore.getSettablePaths();
+  await ensureDir(rulePaths.recommended.relativeDirPath);
+  await ensureDir(mcpPaths.relativeDirPath);
+  await ensureDir(commandPaths.relativeDirPath);
+  await ensureDir(subagentPaths.relativeDirPath);
+  await ensureDir(ignorePaths.relativeDirPath);
+  const ruleFilepath = (0, import_node_path59.join)(rulePaths.recommended.relativeDirPath, sampleRuleFile.filename);
+  if (!await fileExists(ruleFilepath)) {
+    await writeFileContent(ruleFilepath, sampleRuleFile.content);
+    logger.success(`Created ${ruleFilepath}`);
+  } else {
+    logger.info(`Skipped ${ruleFilepath} (already exists)`);
+  }
+  const mcpFilepath = (0, import_node_path59.join)(mcpPaths.relativeDirPath, mcpPaths.relativeFilePath);
+  if (!await fileExists(mcpFilepath)) {
+    await writeFileContent(mcpFilepath, sampleMcpFile.content);
+    logger.success(`Created ${mcpFilepath}`);
+  } else {
+    logger.info(`Skipped ${mcpFilepath} (already exists)`);
+  }
+  const commandFilepath = (0, import_node_path59.join)(commandPaths.relativeDirPath, sampleCommandFile.filename);
+  if (!await fileExists(commandFilepath)) {
+    await writeFileContent(commandFilepath, sampleCommandFile.content);
+    logger.success(`Created ${commandFilepath}`);
+  } else {
+    logger.info(`Skipped ${commandFilepath} (already exists)`);
+  }
+  const subagentFilepath = (0, import_node_path59.join)(subagentPaths.relativeDirPath, sampleSubagentFile.filename);
+  if (!await fileExists(subagentFilepath)) {
+    await writeFileContent(subagentFilepath, sampleSubagentFile.content);
+    logger.success(`Created ${subagentFilepath}`);
   } else {
-    logger.info(`Skipped ${filepath} (already exists)`);
+    logger.info(`Skipped ${subagentFilepath} (already exists)`);
+  }
+  const ignoreFilepath = (0, import_node_path59.join)(ignorePaths.relativeDirPath, ignorePaths.relativeFilePath);
+  if (!await fileExists(ignoreFilepath)) {
+    await writeFileContent(ignoreFilepath, sampleIgnoreFile.content);
+    logger.success(`Created ${ignoreFilepath}`);
+  } else {
+    logger.info(`Skipped ${ignoreFilepath} (already exists)`);
   }
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.6.0";
+var getVersion = () => "3.8.0";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();
@@ -7273,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) {
@@ -7302,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({
@@ -7317,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