rulesync 6.6.0 → 6.6.2

package/README.md

@@ -120,6 +120,9 @@ Get-FileHash rulesync.exe -Algorithm SHA256 | ForEach-Object {
 ```bash
 # Create necessary directories, sample rule files, and configuration file
 npx rulesync init
+
+# Install official skills (recommended)
+npx rulesync fetch dyoshikawa/rulesync --features skills
 ```
 
 On the other hand, if you already have AI tool configurations:
@@ -231,7 +234,7 @@ npx rulesync generate --targets "*" --features rules
 # Generate simulated commands and subagents
 npx rulesync generate --targets copilot,cursor,codexcli --features commands,subagents --simulate-commands --simulate-subagents
 
-# Preview changes without writing files (dry-run mode)
+# Dry run: show changes without writing files
 npx rulesync generate --dry-run --targets claudecode --features rules
 
 # Check if files are up to date (for CI/CD pipelines)
@@ -250,13 +253,13 @@ npx rulesync update --check
 npx rulesync update --force
 ```
 
-## Preview Modes
+## Dry Run
 
-Rulesync provides two preview modes for the `generate` command that allow you to see what changes would be made without actually writing files:
+Rulesync provides two dry run options for the `generate` command that allow you to see what changes would be made without actually writing files:
 
 ### `--dry-run`
 
-Preview changes without writing any files. Shows what would be written or deleted with a `[PREVIEW]` prefix.
+Show what would be written or deleted without actually writing any files. Changes are displayed with a `[DRY RUN]` prefix.
 
 ```bash
 npx rulesync generate --dry-run --targets claudecode --features rules
@@ -333,6 +336,9 @@ npx rulesync fetch owner/repo@v1.0.0 --features rules,commands
 export GITHUB_TOKEN=ghp_xxxx
 npx rulesync fetch owner/private-repo
 
+# Or use GitHub CLI to get the token
+GITHUB_TOKEN=$(gh auth token) npx rulesync fetch owner/private-repo
+
 # Preserve existing files (skip conflicts)
 npx rulesync fetch owner/repo --conflict skip
 

package/dist/index.cjs

@@ -125,6 +125,7 @@ var Logger = class {
 var logger = new Logger();
 
 // src/lib/fetch.ts
+var import_promise = require("es-toolkit/promise");
 var import_node_path107 = require("path");
 
 // src/constants/rulesync-paths.ts
@@ -10409,6 +10410,9 @@ var ToolRule = class extends ToolFile {
     return false;
   }
 };
+function buildToolPath(toolDir, subDir, excludeToolDir) {
+  return excludeToolDir ? subDir : (0, import_node_path84.join)(toolDir, subDir);
+}
 
 // src/features/rules/agentsmd-rule.ts
 var AgentsMdRule = class _AgentsMdRule extends ToolRule {
@@ -10426,7 +10430,7 @@ var AgentsMdRule = class _AgentsMdRule extends ToolRule {
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : (0, import_node_path85.join)(".agents", "memories")
+        relativeDirPath: buildToolPath(".agents", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -10666,7 +10670,7 @@ var AntigravityRule = class _AntigravityRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : (0, import_node_path86.join)(".agent", "rules")
+        relativeDirPath: buildToolPath(".agent", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -10842,7 +10846,7 @@ var AugmentcodeLegacyRule = class _AugmentcodeLegacyRule extends ToolRule {
         relativeFilePath: ".augment-guidelines"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : (0, import_node_path87.join)(".augment", "rules")
+        relativeDirPath: buildToolPath(".augment", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -10915,7 +10919,7 @@ var AugmentcodeRule = class _AugmentcodeRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : (0, import_node_path88.join)(".augment", "rules")
+        relativeDirPath: buildToolPath(".augment", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -10984,7 +10988,7 @@ var ClaudecodeLegacyRule = class _ClaudecodeLegacyRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".claude",
+          relativeDirPath: buildToolPath(".claude", ".", excludeToolDir),
           relativeFilePath: "CLAUDE.md"
         }
       };
@@ -10995,7 +10999,7 @@ var ClaudecodeLegacyRule = class _ClaudecodeLegacyRule extends ToolRule {
         relativeFilePath: "CLAUDE.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "memories" : (0, import_node_path89.join)(".claude", "memories")
+        relativeDirPath: buildToolPath(".claude", "memories", excludeToolDir)
       }
     };
   }
@@ -11099,7 +11103,7 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".claude",
+          relativeDirPath: buildToolPath(".claude", ".", excludeToolDir),
           relativeFilePath: "CLAUDE.md"
         }
       };
@@ -11110,7 +11114,7 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
         relativeFilePath: "CLAUDE.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "rules" : (0, import_node_path90.join)(".claude", "rules")
+        relativeDirPath: buildToolPath(".claude", "rules", excludeToolDir)
       }
     };
   }
@@ -11376,7 +11380,7 @@ var CodexcliRule = class _CodexcliRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".codex",
+          relativeDirPath: buildToolPath(".codex", ".", excludeToolDir),
           relativeFilePath: "AGENTS.md"
         }
       };
@@ -11387,7 +11391,7 @@ var CodexcliRule = class _CodexcliRule extends ToolRule {
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "memories" : (0, import_node_path92.join)(".codex", "memories")
+        relativeDirPath: buildToolPath(".codex", "memories", excludeToolDir)
       }
     };
   }
@@ -11489,11 +11493,11 @@ var CopilotRule = class _CopilotRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       root: {
-        relativeDirPath: _options.excludeToolDir ? "." : ".github",
+        relativeDirPath: buildToolPath(".github", ".", _options.excludeToolDir),
         relativeFilePath: "copilot-instructions.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "instructions" : (0, import_node_path93.join)(".github", "instructions")
+        relativeDirPath: buildToolPath(".github", "instructions", _options.excludeToolDir)
       }
     };
   }
@@ -11677,7 +11681,7 @@ var CursorRule = class _CursorRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : (0, import_node_path94.join)(".cursor", "rules")
+        relativeDirPath: buildToolPath(".cursor", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -11879,21 +11883,21 @@ var FactorydroidRule = class _FactorydroidRule extends ToolRule {
     if (options?.global) {
       return {
         root: {
-          relativeDirPath: options.excludeToolDir ? "." : ".factorydroid",
+          relativeDirPath: buildToolPath(".factorydroid", ".", options.excludeToolDir),
           relativeFilePath: "AGENTS.md"
         },
         nonRoot: {
-          relativeDirPath: options.excludeToolDir ? "memories" : (0, import_node_path95.join)(".factorydroid", "memories")
+          relativeDirPath: buildToolPath(".factorydroid", "memories", options.excludeToolDir)
         }
       };
     }
     return {
       root: {
-        relativeDirPath: options?.excludeToolDir ? "." : ".factorydroid",
+        relativeDirPath: buildToolPath(".factorydroid", ".", options?.excludeToolDir),
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: options?.excludeToolDir ? "memories" : (0, import_node_path95.join)(".factorydroid", "memories")
+        relativeDirPath: buildToolPath(".factorydroid", "memories", options?.excludeToolDir)
       }
     };
   }
@@ -11974,7 +11978,7 @@ var GeminiCliRule = class _GeminiCliRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".gemini",
+          relativeDirPath: buildToolPath(".gemini", ".", excludeToolDir),
           relativeFilePath: "GEMINI.md"
         }
       };
@@ -11985,7 +11989,7 @@ var GeminiCliRule = class _GeminiCliRule extends ToolRule {
         relativeFilePath: "GEMINI.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "memories" : (0, import_node_path96.join)(".gemini", "memories")
+        relativeDirPath: buildToolPath(".gemini", "memories", excludeToolDir)
       }
     };
   }
@@ -12079,11 +12083,11 @@ var JunieRule = class _JunieRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       root: {
-        relativeDirPath: _options.excludeToolDir ? "." : ".junie",
+        relativeDirPath: buildToolPath(".junie", ".", _options.excludeToolDir),
         relativeFilePath: "guidelines.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : (0, import_node_path97.join)(".junie", "memories")
+        relativeDirPath: buildToolPath(".junie", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12154,7 +12158,7 @@ var KiloRule = class _KiloRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : (0, import_node_path98.join)(".kilocode", "rules")
+        relativeDirPath: buildToolPath(".kilocode", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -12221,7 +12225,7 @@ var KiroRule = class _KiroRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "steering" : (0, import_node_path99.join)(".kiro", "steering")
+        relativeDirPath: buildToolPath(".kiro", "steering", _options.excludeToolDir)
       }
     };
   }
@@ -12294,7 +12298,7 @@ var OpenCodeRule = class _OpenCodeRule extends ToolRule {
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : (0, import_node_path100.join)(".opencode", "memories")
+        relativeDirPath: buildToolPath(".opencode", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12369,7 +12373,7 @@ var QwencodeRule = class _QwencodeRule extends ToolRule {
         relativeFilePath: "QWEN.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : (0, import_node_path101.join)(".qwen", "memories")
+        relativeDirPath: buildToolPath(".qwen", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12525,7 +12529,7 @@ var RooRule = class _RooRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : (0, import_node_path103.join)(".roo", "rules")
+        relativeDirPath: buildToolPath(".roo", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -12620,7 +12624,7 @@ var WarpRule = class _WarpRule extends ToolRule {
         relativeFilePath: "WARP.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : (0, import_node_path104.join)(".warp", "memories")
+        relativeDirPath: buildToolPath(".warp", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12691,7 +12695,7 @@ var WindsurfRule = class _WindsurfRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : (0, import_node_path105.join)(".windsurf", "rules")
+        relativeDirPath: buildToolPath(".windsurf", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -13543,6 +13547,17 @@ var GitHubClientError = class extends Error {
     this.name = "GitHubClientError";
   }
 };
+function logGitHubAuthHints(error) {
+  logger.error(`GitHub API Error: ${error.message}`);
+  if (error.statusCode === 401 || error.statusCode === 403) {
+    logger.info(
+      "Tip: Set GITHUB_TOKEN or GH_TOKEN environment variable for private repositories or better rate limits."
+    );
+    logger.info(
+      "Tip: If you use GitHub CLI, you can use `GITHUB_TOKEN=$(gh auth token) rulesync fetch ...`"
+    );
+  }
+}
 var GitHubClient = class {
   octokit;
   hasToken;
@@ -13857,13 +13872,25 @@ function parseSource(source) {
   }
   return { provider: "github", ...parseShorthand(source) };
 }
+var GITHUB_HOSTS = /* @__PURE__ */ new Set(["github.com", "www.github.com"]);
+var GITLAB_HOSTS = /* @__PURE__ */ new Set(["gitlab.com", "www.gitlab.com"]);
+var MAX_RECURSION_DEPTH = 15;
+var FETCH_CONCURRENCY_LIMIT = 10;
+async function withSemaphore(semaphore, fn) {
+  await semaphore.acquire();
+  try {
+    return await fn();
+  } finally {
+    semaphore.release();
+  }
+}
 function parseUrl(url) {
   const urlObj = new URL(url);
   const host = urlObj.hostname.toLowerCase();
   let provider;
-  if (host === "github.com" || host.endsWith(".github.com")) {
+  if (GITHUB_HOSTS.has(host)) {
     provider = "github";
-  } else if (host === "gitlab.com" || host.endsWith(".gitlab.com")) {
+  } else if (GITLAB_HOSTS.has(host)) {
     provider = "gitlab";
   } else {
     throw new Error(
@@ -13996,13 +14023,15 @@ async function fetchFiles(params) {
       conflictStrategy
     });
   }
+  const semaphore = new import_promise.Semaphore(FETCH_CONCURRENCY_LIMIT);
   const filesToFetch = await collectFeatureFiles({
     client,
     owner: parsed.owner,
     repo: parsed.repo,
     basePath: resolvedPath,
     ref,
-    enabledFeatures
+    enabledFeatures,
+    semaphore
   });
   if (filesToFetch.length === 0) {
     logger.warn(`No files found matching enabled features: ${enabledFeatures.join(", ")}`);
@@ -14015,9 +14044,8 @@ async function fetchFiles(params) {
       skipped: 0
     };
   }
-  const results = [];
   const outputBasePath = (0, import_node_path107.join)(baseDir, outputDir);
-  for (const { remotePath, relativePath, size } of filesToFetch) {
+  for (const { relativePath, size } of filesToFetch) {
     checkPathTraversal({
       relativePath,
       intendedRootDir: outputBasePath
@@ -14027,20 +14055,25 @@ async function fetchFiles(params) {
         `File "${relativePath}" exceeds maximum size limit (${(size / 1024 / 1024).toFixed(2)}MB > ${MAX_FILE_SIZE / 1024 / 1024}MB)`
       );
     }
-    const localPath = (0, import_node_path107.join)(outputBasePath, relativePath);
-    const exists = await fileExists(localPath);
-    let status;
-    if (exists && conflictStrategy === "skip") {
-      status = "skipped";
-      logger.debug(`Skipping existing file: ${relativePath}`);
-    } else {
-      const content = await client.getFileContent(parsed.owner, parsed.repo, remotePath, ref);
+  }
+  const results = await Promise.all(
+    filesToFetch.map(async ({ remotePath, relativePath }) => {
+      const localPath = (0, import_node_path107.join)(outputBasePath, relativePath);
+      const exists = await fileExists(localPath);
+      if (exists && conflictStrategy === "skip") {
+        logger.debug(`Skipping existing file: ${relativePath}`);
+        return { relativePath, status: "skipped" };
+      }
+      const content = await withSemaphore(
+        semaphore,
+        () => client.getFileContent(parsed.owner, parsed.repo, remotePath, ref)
+      );
       await writeFileContent(localPath, content);
-      status = exists ? "overwritten" : "created";
+      const status = exists ? "overwritten" : "created";
       logger.debug(`Wrote: ${relativePath} (${status})`);
-    }
-    results.push({ relativePath, status });
-  }
+      return { relativePath, status };
+    })
+  );
   const summary = {
     source: `${parsed.owner}/${parsed.repo}`,
     ref,
@@ -14052,24 +14085,29 @@ async function fetchFiles(params) {
   return summary;
 }
 async function collectFeatureFiles(params) {
-  const { client, owner, repo, basePath, ref, enabledFeatures } = params;
-  const filesToFetch = [];
-  for (const feature of enabledFeatures) {
-    const featurePaths = FEATURE_PATHS[feature];
-    for (const featurePath of featurePaths) {
+  const { client, owner, repo, basePath, ref, enabledFeatures, semaphore } = params;
+  const tasks = enabledFeatures.flatMap(
+    (feature) => FEATURE_PATHS[feature].map((featurePath) => ({ feature, featurePath }))
+  );
+  const results = await Promise.all(
+    tasks.map(async ({ featurePath }) => {
       const fullPath = basePath === "." || basePath === "" ? featurePath : (0, import_node_path107.join)(basePath, featurePath);
+      const collected = [];
       try {
         if (featurePath.includes(".")) {
           try {
-            const entries = await client.listDirectory(
-              owner,
-              repo,
-              basePath === "." || basePath === "" ? "." : basePath,
-              ref
+            const entries = await withSemaphore(
+              semaphore,
+              () => client.listDirectory(
+                owner,
+                repo,
+                basePath === "." || basePath === "" ? "." : basePath,
+                ref
+              )
             );
             const fileEntry = entries.find((e) => e.name === featurePath && e.type === "file");
             if (fileEntry) {
-              filesToFetch.push({
+              collected.push({
                 remotePath: fileEntry.path,
                 relativePath: featurePath,
                 size: fileEntry.size
@@ -14083,10 +14121,17 @@ async function collectFeatureFiles(params) {
             }
           }
         } else {
-          const dirFiles = await listDirectoryRecursive(client, owner, repo, fullPath, ref);
+          const dirFiles = await listDirectoryRecursive({
+            client,
+            owner,
+            repo,
+            path: fullPath,
+            ref,
+            semaphore
+          });
           for (const file of dirFiles) {
             const relativePath = basePath === "." || basePath === "" ? file.path : file.path.substring(basePath.length + 1);
-            filesToFetch.push({
+            collected.push({
               remotePath: file.path,
               relativePath,
               size: file.size
@@ -14096,26 +14141,49 @@ async function collectFeatureFiles(params) {
       } catch (error) {
         if (isNotFoundError(error)) {
           logger.debug(`Feature not found: ${fullPath}`);
-          continue;
+          return collected;
         }
         throw error;
       }
-    }
-  }
-  return filesToFetch;
+      return collected;
+    })
+  );
+  return results.flat();
 }
-async function listDirectoryRecursive(client, owner, repo, path4, ref) {
-  const entries = await client.listDirectory(owner, repo, path4, ref);
+async function listDirectoryRecursive(params) {
+  const { client, owner, repo, path: path4, ref, depth = 0, semaphore } = params;
+  if (depth > MAX_RECURSION_DEPTH) {
+    throw new Error(
+      `Maximum recursion depth (${MAX_RECURSION_DEPTH}) exceeded while listing directory: ${path4}`
+    );
+  }
+  const entries = await withSemaphore(
+    semaphore,
+    () => client.listDirectory(owner, repo, path4, ref)
+  );
   const files = [];
+  const directories = [];
   for (const entry of entries) {
     if (entry.type === "file") {
       files.push(entry);
     } else if (entry.type === "dir") {
-      const subFiles = await listDirectoryRecursive(client, owner, repo, entry.path, ref);
-      files.push(...subFiles);
+      directories.push(entry);
     }
   }
-  return files;
+  const subResults = await Promise.all(
+    directories.map(
+      (dir) => listDirectoryRecursive({
+        client,
+        owner,
+        repo,
+        path: dir.path,
+        ref,
+        depth: depth + 1,
+        semaphore
+      })
+    )
+  );
+  return [...files, ...subResults.flat()];
 }
 async function fetchAndConvertToolFiles(params) {
   const {
@@ -14131,6 +14199,7 @@ async function fetchAndConvertToolFiles(params) {
   } = params;
   const tempDir = await createTempDirectory();
   logger.debug(`Created temp directory: ${tempDir}`);
+  const semaphore = new import_promise.Semaphore(FETCH_CONCURRENCY_LIMIT);
   try {
     const filesToFetch = await collectFeatureFiles({
       client,
@@ -14138,7 +14207,8 @@ async function fetchAndConvertToolFiles(params) {
       repo: parsed.repo,
       basePath: resolvedPath,
       ref,
-      enabledFeatures
+      enabledFeatures,
+      semaphore
     });
     if (filesToFetch.length === 0) {
       logger.warn(`No files found matching enabled features: ${enabledFeatures.join(", ")}`);
@@ -14151,25 +14221,31 @@ async function fetchAndConvertToolFiles(params) {
         skipped: 0
       };
     }
-    const toolPaths = getToolPathMapping(target);
-    const fetchedFiles = [];
-    for (const { remotePath, relativePath, size } of filesToFetch) {
+    for (const { relativePath, size } of filesToFetch) {
       if (size > MAX_FILE_SIZE) {
         throw new GitHubClientError(
           `File "${relativePath}" exceeds maximum size limit (${(size / 1024 / 1024).toFixed(2)}MB > ${MAX_FILE_SIZE / 1024 / 1024}MB)`
         );
       }
-      const toolRelativePath = mapToToolPath(relativePath, toolPaths);
-      checkPathTraversal({
-        relativePath: toolRelativePath,
-        intendedRootDir: tempDir
-      });
-      const localPath = (0, import_node_path107.join)(tempDir, toolRelativePath);
-      const content = await client.getFileContent(parsed.owner, parsed.repo, remotePath, ref);
-      await writeFileContent(localPath, content);
-      fetchedFiles.push(toolRelativePath);
-      logger.debug(`Fetched to temp: ${toolRelativePath}`);
     }
+    const toolPaths = getToolPathMapping(target);
+    await Promise.all(
+      filesToFetch.map(async ({ remotePath, relativePath }) => {
+        const toolRelativePath = mapToToolPath(relativePath, toolPaths);
+        checkPathTraversal({
+          relativePath: toolRelativePath,
+          intendedRootDir: tempDir
+        });
+        const localPath = (0, import_node_path107.join)(tempDir, toolRelativePath);
+        const content = await withSemaphore(
+          semaphore,
+          () => client.getFileContent(parsed.owner, parsed.repo, remotePath, ref)
+        );
+        await writeFileContent(localPath, content);
+        logger.debug(`Fetched to temp: ${toolRelativePath}`);
+        return toolRelativePath;
+      })
+    );
     const outputBasePath = (0, import_node_path107.join)(baseDir, outputDir);
     const { converted, convertedPaths } = await convertFetchedFilesToRulesync({
       tempDir,
@@ -14307,12 +14383,7 @@ async function fetchCommand(options) {
     }
   } catch (error) {
     if (error instanceof GitHubClientError) {
-      logger.error(`GitHub API Error: ${error.message}`);
-      if (error.statusCode === 401 || error.statusCode === 403) {
-        logger.info(
-          "Tip: Set GITHUB_TOKEN or GH_TOKEN environment variable for private repositories."
-        );
-      }
+      logGitHubAuthHints(error);
     } else {
       logger.error(formatError(error));
     }
@@ -17183,7 +17254,8 @@ var MAX_DOWNLOAD_SIZE = 500 * 1024 * 1024;
 var ALLOWED_DOWNLOAD_DOMAINS = [
   "github.com",
   "objects.githubusercontent.com",
-  "github-releases.githubusercontent.com"
+  "github-releases.githubusercontent.com",
+  "release-assets.githubusercontent.com"
 ];
 var UpdatePermissionError = class extends Error {
   constructor(message) {
@@ -17509,12 +17581,7 @@ async function updateCommand(currentVersion, options) {
     logger.success(message);
   } catch (error) {
     if (error instanceof GitHubClientError) {
-      logger.error(`GitHub API Error: ${error.message}`);
-      if (error.statusCode === 401 || error.statusCode === 403) {
-        logger.info(
-          "Tip: Set GITHUB_TOKEN or GH_TOKEN environment variable for better rate limits."
-        );
-      }
+      logGitHubAuthHints(error);
     } else if (error instanceof UpdatePermissionError) {
       logger.error(error.message);
       logger.info("Tip: Run with elevated privileges (e.g., sudo rulesync update)");
@@ -17526,7 +17593,7 @@ async function updateCommand(currentVersion, options) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "6.6.0";
+var getVersion = () => "6.6.2";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();
@@ -17626,7 +17693,7 @@ var main = async () => {
   ).option(
     "--modular-mcp",
     "Generate modular-mcp configuration for context compression (experimental)"
-  ).option("--dry-run", "Preview changes without writing files").option("--check", "Check if files are up to date (exits with code 1 if changes needed)").action(async (options) => {
+  ).option("--dry-run", "Dry run: show changes without writing files").option("--check", "Check if files are up to date (exits with code 1 if changes needed)").action(async (options) => {
     try {
       await generateCommand({
         targets: options.targets,

package/dist/index.js

@@ -102,6 +102,7 @@ var Logger = class {
 var logger = new Logger();
 
 // src/lib/fetch.ts
+import { Semaphore } from "es-toolkit/promise";
 import { join as join106 } from "path";
 
 // src/constants/rulesync-paths.ts
@@ -10386,6 +10387,9 @@ var ToolRule = class extends ToolFile {
     return false;
   }
 };
+function buildToolPath(toolDir, subDir, excludeToolDir) {
+  return excludeToolDir ? subDir : join83(toolDir, subDir);
+}
 
 // src/features/rules/agentsmd-rule.ts
 var AgentsMdRule = class _AgentsMdRule extends ToolRule {
@@ -10403,7 +10407,7 @@ var AgentsMdRule = class _AgentsMdRule extends ToolRule {
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : join84(".agents", "memories")
+        relativeDirPath: buildToolPath(".agents", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -10643,7 +10647,7 @@ var AntigravityRule = class _AntigravityRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : join85(".agent", "rules")
+        relativeDirPath: buildToolPath(".agent", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -10819,7 +10823,7 @@ var AugmentcodeLegacyRule = class _AugmentcodeLegacyRule extends ToolRule {
         relativeFilePath: ".augment-guidelines"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : join86(".augment", "rules")
+        relativeDirPath: buildToolPath(".augment", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -10892,7 +10896,7 @@ var AugmentcodeRule = class _AugmentcodeRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : join87(".augment", "rules")
+        relativeDirPath: buildToolPath(".augment", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -10961,7 +10965,7 @@ var ClaudecodeLegacyRule = class _ClaudecodeLegacyRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".claude",
+          relativeDirPath: buildToolPath(".claude", ".", excludeToolDir),
           relativeFilePath: "CLAUDE.md"
         }
       };
@@ -10972,7 +10976,7 @@ var ClaudecodeLegacyRule = class _ClaudecodeLegacyRule extends ToolRule {
         relativeFilePath: "CLAUDE.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "memories" : join88(".claude", "memories")
+        relativeDirPath: buildToolPath(".claude", "memories", excludeToolDir)
       }
     };
   }
@@ -11076,7 +11080,7 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".claude",
+          relativeDirPath: buildToolPath(".claude", ".", excludeToolDir),
           relativeFilePath: "CLAUDE.md"
         }
       };
@@ -11087,7 +11091,7 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
         relativeFilePath: "CLAUDE.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "rules" : join89(".claude", "rules")
+        relativeDirPath: buildToolPath(".claude", "rules", excludeToolDir)
       }
     };
   }
@@ -11353,7 +11357,7 @@ var CodexcliRule = class _CodexcliRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".codex",
+          relativeDirPath: buildToolPath(".codex", ".", excludeToolDir),
           relativeFilePath: "AGENTS.md"
         }
       };
@@ -11364,7 +11368,7 @@ var CodexcliRule = class _CodexcliRule extends ToolRule {
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "memories" : join91(".codex", "memories")
+        relativeDirPath: buildToolPath(".codex", "memories", excludeToolDir)
       }
     };
   }
@@ -11466,11 +11470,11 @@ var CopilotRule = class _CopilotRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       root: {
-        relativeDirPath: _options.excludeToolDir ? "." : ".github",
+        relativeDirPath: buildToolPath(".github", ".", _options.excludeToolDir),
         relativeFilePath: "copilot-instructions.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "instructions" : join92(".github", "instructions")
+        relativeDirPath: buildToolPath(".github", "instructions", _options.excludeToolDir)
       }
     };
   }
@@ -11654,7 +11658,7 @@ var CursorRule = class _CursorRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : join93(".cursor", "rules")
+        relativeDirPath: buildToolPath(".cursor", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -11856,21 +11860,21 @@ var FactorydroidRule = class _FactorydroidRule extends ToolRule {
     if (options?.global) {
       return {
         root: {
-          relativeDirPath: options.excludeToolDir ? "." : ".factorydroid",
+          relativeDirPath: buildToolPath(".factorydroid", ".", options.excludeToolDir),
           relativeFilePath: "AGENTS.md"
         },
         nonRoot: {
-          relativeDirPath: options.excludeToolDir ? "memories" : join94(".factorydroid", "memories")
+          relativeDirPath: buildToolPath(".factorydroid", "memories", options.excludeToolDir)
         }
       };
     }
     return {
       root: {
-        relativeDirPath: options?.excludeToolDir ? "." : ".factorydroid",
+        relativeDirPath: buildToolPath(".factorydroid", ".", options?.excludeToolDir),
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: options?.excludeToolDir ? "memories" : join94(".factorydroid", "memories")
+        relativeDirPath: buildToolPath(".factorydroid", "memories", options?.excludeToolDir)
       }
     };
   }
@@ -11951,7 +11955,7 @@ var GeminiCliRule = class _GeminiCliRule extends ToolRule {
     if (global) {
       return {
         root: {
-          relativeDirPath: excludeToolDir ? "." : ".gemini",
+          relativeDirPath: buildToolPath(".gemini", ".", excludeToolDir),
           relativeFilePath: "GEMINI.md"
         }
       };
@@ -11962,7 +11966,7 @@ var GeminiCliRule = class _GeminiCliRule extends ToolRule {
         relativeFilePath: "GEMINI.md"
       },
       nonRoot: {
-        relativeDirPath: excludeToolDir ? "memories" : join95(".gemini", "memories")
+        relativeDirPath: buildToolPath(".gemini", "memories", excludeToolDir)
       }
     };
   }
@@ -12056,11 +12060,11 @@ var JunieRule = class _JunieRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       root: {
-        relativeDirPath: _options.excludeToolDir ? "." : ".junie",
+        relativeDirPath: buildToolPath(".junie", ".", _options.excludeToolDir),
         relativeFilePath: "guidelines.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : join96(".junie", "memories")
+        relativeDirPath: buildToolPath(".junie", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12131,7 +12135,7 @@ var KiloRule = class _KiloRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : join97(".kilocode", "rules")
+        relativeDirPath: buildToolPath(".kilocode", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -12198,7 +12202,7 @@ var KiroRule = class _KiroRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "steering" : join98(".kiro", "steering")
+        relativeDirPath: buildToolPath(".kiro", "steering", _options.excludeToolDir)
       }
     };
   }
@@ -12271,7 +12275,7 @@ var OpenCodeRule = class _OpenCodeRule extends ToolRule {
         relativeFilePath: "AGENTS.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : join99(".opencode", "memories")
+        relativeDirPath: buildToolPath(".opencode", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12346,7 +12350,7 @@ var QwencodeRule = class _QwencodeRule extends ToolRule {
         relativeFilePath: "QWEN.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : join100(".qwen", "memories")
+        relativeDirPath: buildToolPath(".qwen", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12502,7 +12506,7 @@ var RooRule = class _RooRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : join102(".roo", "rules")
+        relativeDirPath: buildToolPath(".roo", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -12597,7 +12601,7 @@ var WarpRule = class _WarpRule extends ToolRule {
         relativeFilePath: "WARP.md"
       },
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "memories" : join103(".warp", "memories")
+        relativeDirPath: buildToolPath(".warp", "memories", _options.excludeToolDir)
       }
     };
   }
@@ -12668,7 +12672,7 @@ var WindsurfRule = class _WindsurfRule extends ToolRule {
   static getSettablePaths(_options = {}) {
     return {
       nonRoot: {
-        relativeDirPath: _options.excludeToolDir ? "rules" : join104(".windsurf", "rules")
+        relativeDirPath: buildToolPath(".windsurf", "rules", _options.excludeToolDir)
       }
     };
   }
@@ -13520,6 +13524,17 @@ var GitHubClientError = class extends Error {
     this.name = "GitHubClientError";
   }
 };
+function logGitHubAuthHints(error) {
+  logger.error(`GitHub API Error: ${error.message}`);
+  if (error.statusCode === 401 || error.statusCode === 403) {
+    logger.info(
+      "Tip: Set GITHUB_TOKEN or GH_TOKEN environment variable for private repositories or better rate limits."
+    );
+    logger.info(
+      "Tip: If you use GitHub CLI, you can use `GITHUB_TOKEN=$(gh auth token) rulesync fetch ...`"
+    );
+  }
+}
 var GitHubClient = class {
   octokit;
   hasToken;
@@ -13834,13 +13849,25 @@ function parseSource(source) {
   }
   return { provider: "github", ...parseShorthand(source) };
 }
+var GITHUB_HOSTS = /* @__PURE__ */ new Set(["github.com", "www.github.com"]);
+var GITLAB_HOSTS = /* @__PURE__ */ new Set(["gitlab.com", "www.gitlab.com"]);
+var MAX_RECURSION_DEPTH = 15;
+var FETCH_CONCURRENCY_LIMIT = 10;
+async function withSemaphore(semaphore, fn) {
+  await semaphore.acquire();
+  try {
+    return await fn();
+  } finally {
+    semaphore.release();
+  }
+}
 function parseUrl(url) {
   const urlObj = new URL(url);
   const host = urlObj.hostname.toLowerCase();
   let provider;
-  if (host === "github.com" || host.endsWith(".github.com")) {
+  if (GITHUB_HOSTS.has(host)) {
     provider = "github";
-  } else if (host === "gitlab.com" || host.endsWith(".gitlab.com")) {
+  } else if (GITLAB_HOSTS.has(host)) {
     provider = "gitlab";
   } else {
     throw new Error(
@@ -13973,13 +14000,15 @@ async function fetchFiles(params) {
       conflictStrategy
     });
   }
+  const semaphore = new Semaphore(FETCH_CONCURRENCY_LIMIT);
   const filesToFetch = await collectFeatureFiles({
     client,
     owner: parsed.owner,
     repo: parsed.repo,
     basePath: resolvedPath,
     ref,
-    enabledFeatures
+    enabledFeatures,
+    semaphore
   });
   if (filesToFetch.length === 0) {
     logger.warn(`No files found matching enabled features: ${enabledFeatures.join(", ")}`);
@@ -13992,9 +14021,8 @@ async function fetchFiles(params) {
       skipped: 0
     };
   }
-  const results = [];
   const outputBasePath = join106(baseDir, outputDir);
-  for (const { remotePath, relativePath, size } of filesToFetch) {
+  for (const { relativePath, size } of filesToFetch) {
     checkPathTraversal({
       relativePath,
       intendedRootDir: outputBasePath
@@ -14004,20 +14032,25 @@ async function fetchFiles(params) {
         `File "${relativePath}" exceeds maximum size limit (${(size / 1024 / 1024).toFixed(2)}MB > ${MAX_FILE_SIZE / 1024 / 1024}MB)`
       );
     }
-    const localPath = join106(outputBasePath, relativePath);
-    const exists = await fileExists(localPath);
-    let status;
-    if (exists && conflictStrategy === "skip") {
-      status = "skipped";
-      logger.debug(`Skipping existing file: ${relativePath}`);
-    } else {
-      const content = await client.getFileContent(parsed.owner, parsed.repo, remotePath, ref);
+  }
+  const results = await Promise.all(
+    filesToFetch.map(async ({ remotePath, relativePath }) => {
+      const localPath = join106(outputBasePath, relativePath);
+      const exists = await fileExists(localPath);
+      if (exists && conflictStrategy === "skip") {
+        logger.debug(`Skipping existing file: ${relativePath}`);
+        return { relativePath, status: "skipped" };
+      }
+      const content = await withSemaphore(
+        semaphore,
+        () => client.getFileContent(parsed.owner, parsed.repo, remotePath, ref)
+      );
       await writeFileContent(localPath, content);
-      status = exists ? "overwritten" : "created";
+      const status = exists ? "overwritten" : "created";
       logger.debug(`Wrote: ${relativePath} (${status})`);
-    }
-    results.push({ relativePath, status });
-  }
+      return { relativePath, status };
+    })
+  );
   const summary = {
     source: `${parsed.owner}/${parsed.repo}`,
     ref,
@@ -14029,24 +14062,29 @@ async function fetchFiles(params) {
   return summary;
 }
 async function collectFeatureFiles(params) {
-  const { client, owner, repo, basePath, ref, enabledFeatures } = params;
-  const filesToFetch = [];
-  for (const feature of enabledFeatures) {
-    const featurePaths = FEATURE_PATHS[feature];
-    for (const featurePath of featurePaths) {
+  const { client, owner, repo, basePath, ref, enabledFeatures, semaphore } = params;
+  const tasks = enabledFeatures.flatMap(
+    (feature) => FEATURE_PATHS[feature].map((featurePath) => ({ feature, featurePath }))
+  );
+  const results = await Promise.all(
+    tasks.map(async ({ featurePath }) => {
       const fullPath = basePath === "." || basePath === "" ? featurePath : join106(basePath, featurePath);
+      const collected = [];
       try {
         if (featurePath.includes(".")) {
           try {
-            const entries = await client.listDirectory(
-              owner,
-              repo,
-              basePath === "." || basePath === "" ? "." : basePath,
-              ref
+            const entries = await withSemaphore(
+              semaphore,
+              () => client.listDirectory(
+                owner,
+                repo,
+                basePath === "." || basePath === "" ? "." : basePath,
+                ref
+              )
             );
             const fileEntry = entries.find((e) => e.name === featurePath && e.type === "file");
             if (fileEntry) {
-              filesToFetch.push({
+              collected.push({
                 remotePath: fileEntry.path,
                 relativePath: featurePath,
                 size: fileEntry.size
@@ -14060,10 +14098,17 @@ async function collectFeatureFiles(params) {
             }
           }
         } else {
-          const dirFiles = await listDirectoryRecursive(client, owner, repo, fullPath, ref);
+          const dirFiles = await listDirectoryRecursive({
+            client,
+            owner,
+            repo,
+            path: fullPath,
+            ref,
+            semaphore
+          });
           for (const file of dirFiles) {
             const relativePath = basePath === "." || basePath === "" ? file.path : file.path.substring(basePath.length + 1);
-            filesToFetch.push({
+            collected.push({
               remotePath: file.path,
               relativePath,
               size: file.size
@@ -14073,26 +14118,49 @@ async function collectFeatureFiles(params) {
       } catch (error) {
         if (isNotFoundError(error)) {
           logger.debug(`Feature not found: ${fullPath}`);
-          continue;
+          return collected;
         }
         throw error;
       }
-    }
-  }
-  return filesToFetch;
+      return collected;
+    })
+  );
+  return results.flat();
 }
-async function listDirectoryRecursive(client, owner, repo, path4, ref) {
-  const entries = await client.listDirectory(owner, repo, path4, ref);
+async function listDirectoryRecursive(params) {
+  const { client, owner, repo, path: path4, ref, depth = 0, semaphore } = params;
+  if (depth > MAX_RECURSION_DEPTH) {
+    throw new Error(
+      `Maximum recursion depth (${MAX_RECURSION_DEPTH}) exceeded while listing directory: ${path4}`
+    );
+  }
+  const entries = await withSemaphore(
+    semaphore,
+    () => client.listDirectory(owner, repo, path4, ref)
+  );
   const files = [];
+  const directories = [];
   for (const entry of entries) {
     if (entry.type === "file") {
       files.push(entry);
     } else if (entry.type === "dir") {
-      const subFiles = await listDirectoryRecursive(client, owner, repo, entry.path, ref);
-      files.push(...subFiles);
+      directories.push(entry);
     }
   }
-  return files;
+  const subResults = await Promise.all(
+    directories.map(
+      (dir) => listDirectoryRecursive({
+        client,
+        owner,
+        repo,
+        path: dir.path,
+        ref,
+        depth: depth + 1,
+        semaphore
+      })
+    )
+  );
+  return [...files, ...subResults.flat()];
 }
 async function fetchAndConvertToolFiles(params) {
   const {
@@ -14108,6 +14176,7 @@ async function fetchAndConvertToolFiles(params) {
   } = params;
   const tempDir = await createTempDirectory();
   logger.debug(`Created temp directory: ${tempDir}`);
+  const semaphore = new Semaphore(FETCH_CONCURRENCY_LIMIT);
   try {
     const filesToFetch = await collectFeatureFiles({
       client,
@@ -14115,7 +14184,8 @@ async function fetchAndConvertToolFiles(params) {
       repo: parsed.repo,
       basePath: resolvedPath,
       ref,
-      enabledFeatures
+      enabledFeatures,
+      semaphore
     });
     if (filesToFetch.length === 0) {
       logger.warn(`No files found matching enabled features: ${enabledFeatures.join(", ")}`);
@@ -14128,25 +14198,31 @@ async function fetchAndConvertToolFiles(params) {
         skipped: 0
       };
     }
-    const toolPaths = getToolPathMapping(target);
-    const fetchedFiles = [];
-    for (const { remotePath, relativePath, size } of filesToFetch) {
+    for (const { relativePath, size } of filesToFetch) {
       if (size > MAX_FILE_SIZE) {
         throw new GitHubClientError(
           `File "${relativePath}" exceeds maximum size limit (${(size / 1024 / 1024).toFixed(2)}MB > ${MAX_FILE_SIZE / 1024 / 1024}MB)`
         );
       }
-      const toolRelativePath = mapToToolPath(relativePath, toolPaths);
-      checkPathTraversal({
-        relativePath: toolRelativePath,
-        intendedRootDir: tempDir
-      });
-      const localPath = join106(tempDir, toolRelativePath);
-      const content = await client.getFileContent(parsed.owner, parsed.repo, remotePath, ref);
-      await writeFileContent(localPath, content);
-      fetchedFiles.push(toolRelativePath);
-      logger.debug(`Fetched to temp: ${toolRelativePath}`);
     }
+    const toolPaths = getToolPathMapping(target);
+    await Promise.all(
+      filesToFetch.map(async ({ remotePath, relativePath }) => {
+        const toolRelativePath = mapToToolPath(relativePath, toolPaths);
+        checkPathTraversal({
+          relativePath: toolRelativePath,
+          intendedRootDir: tempDir
+        });
+        const localPath = join106(tempDir, toolRelativePath);
+        const content = await withSemaphore(
+          semaphore,
+          () => client.getFileContent(parsed.owner, parsed.repo, remotePath, ref)
+        );
+        await writeFileContent(localPath, content);
+        logger.debug(`Fetched to temp: ${toolRelativePath}`);
+        return toolRelativePath;
+      })
+    );
     const outputBasePath = join106(baseDir, outputDir);
     const { converted, convertedPaths } = await convertFetchedFilesToRulesync({
       tempDir,
@@ -14284,12 +14360,7 @@ async function fetchCommand(options) {
     }
   } catch (error) {
     if (error instanceof GitHubClientError) {
-      logger.error(`GitHub API Error: ${error.message}`);
-      if (error.statusCode === 401 || error.statusCode === 403) {
-        logger.info(
-          "Tip: Set GITHUB_TOKEN or GH_TOKEN environment variable for private repositories."
-        );
-      }
+      logGitHubAuthHints(error);
     } else {
       logger.error(formatError(error));
     }
@@ -17160,7 +17231,8 @@ var MAX_DOWNLOAD_SIZE = 500 * 1024 * 1024;
 var ALLOWED_DOWNLOAD_DOMAINS = [
   "github.com",
   "objects.githubusercontent.com",
-  "github-releases.githubusercontent.com"
+  "github-releases.githubusercontent.com",
+  "release-assets.githubusercontent.com"
 ];
 var UpdatePermissionError = class extends Error {
   constructor(message) {
@@ -17486,12 +17558,7 @@ async function updateCommand(currentVersion, options) {
     logger.success(message);
   } catch (error) {
     if (error instanceof GitHubClientError) {
-      logger.error(`GitHub API Error: ${error.message}`);
-      if (error.statusCode === 401 || error.statusCode === 403) {
-        logger.info(
-          "Tip: Set GITHUB_TOKEN or GH_TOKEN environment variable for better rate limits."
-        );
-      }
+      logGitHubAuthHints(error);
     } else if (error instanceof UpdatePermissionError) {
       logger.error(error.message);
       logger.info("Tip: Run with elevated privileges (e.g., sudo rulesync update)");
@@ -17503,7 +17570,7 @@ async function updateCommand(currentVersion, options) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "6.6.0";
+var getVersion = () => "6.6.2";
 var main = async () => {
   const program = new Command();
   const version = getVersion();
@@ -17603,7 +17670,7 @@ var main = async () => {
   ).option(
     "--modular-mcp",
     "Generate modular-mcp configuration for context compression (experimental)"
-  ).option("--dry-run", "Preview changes without writing files").option("--check", "Check if files are up to date (exits with code 1 if changes needed)").action(async (options) => {
+  ).option("--dry-run", "Dry run: show changes without writing files").option("--check", "Check if files are up to date (exits with code 1 if changes needed)").action(async (options) => {
     try {
       await generateCommand({
         targets: options.targets,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "6.6.0",
+  "version": "6.6.2",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "keywords": [
     "ai",
@@ -72,6 +72,7 @@
     "eslint-plugin-zod-import": "0.3.0",
     "knip": "5.82.1",
     "lint-staged": "16.2.7",
+    "marked": "17.0.1",
     "oxfmt": "0.27.0",
     "oxlint": "1.42.0",
     "repomix": "1.11.1",