rulesync 3.3.0 → 3.4.0

package/README.md

@@ -58,7 +58,7 @@ Rulesync supports both **generation** and **import** for All of the major AI cod
 | Tool                  | rules | ignore | mcp   | commands | subagents |
 |------------------------|:-----:|:------:|:-----:|:--------:|:---------:|
 | AGENTS.md            |  ✅   |      |       |     🎮     |      🎮     |
-| Claude Code            |  ✅ 🌏   |  ✅   |  ✅ 🌏   |    ✅ 🌏     |    ✅      |
+| Claude Code            |  ✅ 🌏   |  ✅   |  ✅ 🌏   |    ✅ 🌏     |    ✅ 🌏     |
 | Codex CLI              |  ✅ 🌏   |      |   🌏   |     🌏    |    🎮      |
 | Gemini CLI             |  ✅ 🌏  |   ✅   |      |     ✅ 🌏  |      🎮     |
 | GitHub Copilot         |  ✅    |       |  ✅    |    🎮      |    🎮      |
@@ -314,7 +314,7 @@ Currently, supports rules and commands generation for Claude Code. Import for gl
     npx rulesync generate
     ```
 
-> [!WARNING]
+> [!NOTE]
 > Currently, when in the directory enabled global mode:
 > * `rulesync.jsonc` only supports `global`, `features`, `delete` and `verbose`. `Features` can be set `"rules"` and `"commands"`. Other parameters are ignored.
 > * `rules/*.md` only supports single file has `root: true`, and frontmatter parameters without `root` are ignored.
@@ -351,4 +351,15 @@ MIT License
 
 Issues and Pull Requests are welcome!
 
-For development setup and contribution guidelines, see [CONTRIBUTING.md](./CONTRIBUTING.md).
+For development setup:
+
+```bash
+git clone https://github.com/dyoshikawa/rulesync # Should be your fork repository url actually
+cd rulesync
+pnpm i
+pnpm cicheck # Run code style check, type check, and tests
+
+# Manual test using current code
+pnpm dev generate -t claudecode -f "*"
+pnpm dev import -t claudecode -f "*"
+```

package/dist/index.cjs

@@ -3656,6 +3656,11 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
       relativeDirPath: ".claude/agents"
     };
   }
+  static getSettablePathsGlobal() {
+    return {
+      relativeDirPath: (0, import_node_path35.join)(".claude", "agents")
+    };
+  }
   getFrontmatter() {
     return this.frontmatter;
   }
@@ -3675,9 +3680,10 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
     };
     const fileContent = stringifyFrontmatter(this.body, rulesyncFrontmatter);
     return new RulesyncSubagent({
+      baseDir: ".",
+      // RulesyncCommand baseDir is always the project root directory
       frontmatter: rulesyncFrontmatter,
       body: this.body,
-      baseDir: this.baseDir,
       relativeDirPath: ".rulesync/subagents",
       relativeFilePath: this.getRelativeFilePath(),
       fileContent,
@@ -3687,7 +3693,8 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
   static fromRulesyncSubagent({
     baseDir = ".",
     rulesyncSubagent,
-    validate = true
+    validate = true,
+    global = false
   }) {
     const rulesyncFrontmatter = rulesyncSubagent.getFrontmatter();
     const claudecodeFrontmatter = {
@@ -3697,11 +3704,12 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
     };
     const body = rulesyncSubagent.getBody();
     const fileContent = stringifyFrontmatter(body, claudecodeFrontmatter);
+    const paths = global ? this.getSettablePathsGlobal() : this.getSettablePaths();
     return new _ClaudecodeSubagent({
       baseDir,
       frontmatter: claudecodeFrontmatter,
       body,
-      relativeDirPath: ".claude/agents",
+      relativeDirPath: paths.relativeDirPath,
       relativeFilePath: rulesyncSubagent.getRelativeFilePath(),
       fileContent,
       validate
@@ -3727,17 +3735,20 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
   static async fromFile({
     baseDir = ".",
     relativeFilePath,
-    validate = true
+    validate = true,
+    global = false
   }) {
-    const fileContent = await readFileContent((0, import_node_path35.join)(baseDir, ".claude/agents", relativeFilePath));
+    const paths = global ? this.getSettablePathsGlobal() : this.getSettablePaths();
+    const filePath = (0, import_node_path35.join)(baseDir, paths.relativeDirPath, relativeFilePath);
+    const fileContent = await readFileContent(filePath);
     const { frontmatter, body: content } = parseFrontmatter(fileContent);
     const result = ClaudecodeSubagentFrontmatterSchema.safeParse(frontmatter);
     if (!result.success) {
-      throw new Error(`Invalid frontmatter in ${relativeFilePath}: ${result.error.message}`);
+      throw new Error(`Invalid frontmatter in ${filePath}: ${result.error.message}`);
     }
     return new _ClaudecodeSubagent({
       baseDir,
-      relativeDirPath: ".claude/agents",
+      relativeDirPath: paths.relativeDirPath,
       relativeFilePath,
       frontmatter: result.data,
       body: content.trim(),
@@ -3765,15 +3776,19 @@ var subagentsProcessorToolTargetsSimulated = [
   "geminicli",
   "roo"
 ];
+var subagentsProcessorToolTargetsGlobal = ["claudecode"];
 var SubagentsProcessorToolTargetSchema = import_mini15.z.enum(subagentsProcessorToolTargets);
 var SubagentsProcessor = class extends FeatureProcessor {
   toolTarget;
+  global;
   constructor({
     baseDir = ".",
-    toolTarget
+    toolTarget,
+    global = false
   }) {
     super({ baseDir });
     this.toolTarget = SubagentsProcessorToolTargetSchema.parse(toolTarget);
+    this.global = global;
   }
   async convertRulesyncFilesToToolFiles(rulesyncFiles) {
     const rulesyncSubagents = rulesyncFiles.filter(
@@ -3797,7 +3812,8 @@ var SubagentsProcessor = class extends FeatureProcessor {
           return ClaudecodeSubagent.fromRulesyncSubagent({
             baseDir: this.baseDir,
             relativeDirPath: RulesyncSubagent.getSettablePaths().relativeDirPath,
-            rulesyncSubagent
+            rulesyncSubagent,
+            global: this.global
           });
         case "copilot":
           if (!CopilotSubagent.isTargetedByRulesyncSubagent(rulesyncSubagent)) {
@@ -3871,7 +3887,7 @@ var SubagentsProcessor = class extends FeatureProcessor {
    * Load and parse rulesync subagent files from .rulesync/subagents/ directory
    */
   async loadRulesyncFiles() {
-    const subagentsDir = (0, import_node_path36.join)(this.baseDir, RulesyncSubagent.getSettablePaths().relativeDirPath);
+    const subagentsDir = (0, import_node_path36.join)(RulesyncSubagent.getSettablePaths().relativeDirPath);
     const dirExists = await directoryExists(subagentsDir);
     if (!dirExists) {
       logger.debug(`Rulesync subagents directory not found: ${subagentsDir}`);
@@ -3946,9 +3962,14 @@ var SubagentsProcessor = class extends FeatureProcessor {
    * Load Claude Code subagent configurations from .claude/agents/ directory
    */
   async loadClaudecodeSubagents() {
+    const paths = this.global ? ClaudecodeSubagent.getSettablePathsGlobal() : ClaudecodeSubagent.getSettablePaths();
     return await this.loadToolSubagentsDefault({
-      relativeDirPath: ClaudecodeSubagent.getSettablePaths().relativeDirPath,
-      fromFile: (relativeFilePath) => ClaudecodeSubagent.fromFile({ relativeFilePath })
+      relativeDirPath: paths.relativeDirPath,
+      fromFile: (relativeFilePath) => ClaudecodeSubagent.fromFile({
+        baseDir: this.baseDir,
+        relativeFilePath,
+        global: this.global
+      })
     });
   }
   /**
@@ -4022,6 +4043,9 @@ var SubagentsProcessor = class extends FeatureProcessor {
   static getToolTargetsSimulated() {
     return subagentsProcessorToolTargetsSimulated;
   }
+  static getToolTargetsGlobal() {
+    return subagentsProcessorToolTargetsGlobal;
+  }
 };
 
 // src/rules/agentsmd-rule.ts
@@ -6630,22 +6654,20 @@ async function generateSubagents(config) {
     logger.debug("Skipping subagent file generation (not in --features)");
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
-    logger.debug("Skipping subagent file generation (not supported in global mode)");
-    return 0;
-  }
   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)(
+    config.getTargets(),
+    SubagentsProcessor.getToolTargets({
+      includeSimulated: config.getExperimentalSimulateSubagents()
+    })
+  );
   for (const baseDir of config.getBaseDirs()) {
-    for (const toolTarget of (0, import_es_toolkit2.intersection)(
-      config.getTargets(),
-      SubagentsProcessor.getToolTargets({
-        includeSimulated: config.getExperimentalSimulateSubagents()
-      })
-    )) {
+    for (const toolTarget of toolTargets) {
       const processor = new SubagentsProcessor({
         baseDir,
-        toolTarget
+        toolTarget,
+        global: config.getExperimentalGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6869,17 +6891,14 @@ async function importSubagents(config, tool) {
   if (!config.getFeatures().includes("subagents")) {
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
-    logger.debug("Skipping subagent file import (not supported in global mode)");
-    return 0;
-  }
   const supportedTargets = SubagentsProcessor.getToolTargets({ includeSimulated: false });
   if (!supportedTargets.includes(tool)) {
     return 0;
   }
   const subagentsProcessor = new SubagentsProcessor({
     baseDir: config.getBaseDirs()[0] ?? ".",
-    toolTarget: tool
+    toolTarget: tool,
+    global: config.getExperimentalGlobal()
   });
   const toolFiles = await subagentsProcessor.loadToolFiles();
   if (toolFiles.length === 0) {
@@ -6978,7 +6997,7 @@ globs: ["**/*"]
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.3.0";
+var getVersion = () => "3.4.0";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();

package/dist/index.js

@@ -3633,6 +3633,11 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
       relativeDirPath: ".claude/agents"
     };
   }
+  static getSettablePathsGlobal() {
+    return {
+      relativeDirPath: join34(".claude", "agents")
+    };
+  }
   getFrontmatter() {
     return this.frontmatter;
   }
@@ -3652,9 +3657,10 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
     };
     const fileContent = stringifyFrontmatter(this.body, rulesyncFrontmatter);
     return new RulesyncSubagent({
+      baseDir: ".",
+      // RulesyncCommand baseDir is always the project root directory
       frontmatter: rulesyncFrontmatter,
       body: this.body,
-      baseDir: this.baseDir,
       relativeDirPath: ".rulesync/subagents",
       relativeFilePath: this.getRelativeFilePath(),
       fileContent,
@@ -3664,7 +3670,8 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
   static fromRulesyncSubagent({
     baseDir = ".",
     rulesyncSubagent,
-    validate = true
+    validate = true,
+    global = false
   }) {
     const rulesyncFrontmatter = rulesyncSubagent.getFrontmatter();
     const claudecodeFrontmatter = {
@@ -3674,11 +3681,12 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
     };
     const body = rulesyncSubagent.getBody();
     const fileContent = stringifyFrontmatter(body, claudecodeFrontmatter);
+    const paths = global ? this.getSettablePathsGlobal() : this.getSettablePaths();
     return new _ClaudecodeSubagent({
       baseDir,
       frontmatter: claudecodeFrontmatter,
       body,
-      relativeDirPath: ".claude/agents",
+      relativeDirPath: paths.relativeDirPath,
       relativeFilePath: rulesyncSubagent.getRelativeFilePath(),
       fileContent,
       validate
@@ -3704,17 +3712,20 @@ var ClaudecodeSubagent = class _ClaudecodeSubagent extends ToolSubagent {
   static async fromFile({
     baseDir = ".",
     relativeFilePath,
-    validate = true
+    validate = true,
+    global = false
   }) {
-    const fileContent = await readFileContent(join34(baseDir, ".claude/agents", relativeFilePath));
+    const paths = global ? this.getSettablePathsGlobal() : this.getSettablePaths();
+    const filePath = join34(baseDir, paths.relativeDirPath, relativeFilePath);
+    const fileContent = await readFileContent(filePath);
     const { frontmatter, body: content } = parseFrontmatter(fileContent);
     const result = ClaudecodeSubagentFrontmatterSchema.safeParse(frontmatter);
     if (!result.success) {
-      throw new Error(`Invalid frontmatter in ${relativeFilePath}: ${result.error.message}`);
+      throw new Error(`Invalid frontmatter in ${filePath}: ${result.error.message}`);
     }
     return new _ClaudecodeSubagent({
       baseDir,
-      relativeDirPath: ".claude/agents",
+      relativeDirPath: paths.relativeDirPath,
       relativeFilePath,
       frontmatter: result.data,
       body: content.trim(),
@@ -3742,15 +3753,19 @@ var subagentsProcessorToolTargetsSimulated = [
   "geminicli",
   "roo"
 ];
+var subagentsProcessorToolTargetsGlobal = ["claudecode"];
 var SubagentsProcessorToolTargetSchema = z15.enum(subagentsProcessorToolTargets);
 var SubagentsProcessor = class extends FeatureProcessor {
   toolTarget;
+  global;
   constructor({
     baseDir = ".",
-    toolTarget
+    toolTarget,
+    global = false
   }) {
     super({ baseDir });
     this.toolTarget = SubagentsProcessorToolTargetSchema.parse(toolTarget);
+    this.global = global;
   }
   async convertRulesyncFilesToToolFiles(rulesyncFiles) {
     const rulesyncSubagents = rulesyncFiles.filter(
@@ -3774,7 +3789,8 @@ var SubagentsProcessor = class extends FeatureProcessor {
           return ClaudecodeSubagent.fromRulesyncSubagent({
             baseDir: this.baseDir,
             relativeDirPath: RulesyncSubagent.getSettablePaths().relativeDirPath,
-            rulesyncSubagent
+            rulesyncSubagent,
+            global: this.global
           });
         case "copilot":
           if (!CopilotSubagent.isTargetedByRulesyncSubagent(rulesyncSubagent)) {
@@ -3848,7 +3864,7 @@ var SubagentsProcessor = class extends FeatureProcessor {
    * Load and parse rulesync subagent files from .rulesync/subagents/ directory
    */
   async loadRulesyncFiles() {
-    const subagentsDir = join35(this.baseDir, RulesyncSubagent.getSettablePaths().relativeDirPath);
+    const subagentsDir = join35(RulesyncSubagent.getSettablePaths().relativeDirPath);
     const dirExists = await directoryExists(subagentsDir);
     if (!dirExists) {
       logger.debug(`Rulesync subagents directory not found: ${subagentsDir}`);
@@ -3923,9 +3939,14 @@ var SubagentsProcessor = class extends FeatureProcessor {
    * Load Claude Code subagent configurations from .claude/agents/ directory
    */
   async loadClaudecodeSubagents() {
+    const paths = this.global ? ClaudecodeSubagent.getSettablePathsGlobal() : ClaudecodeSubagent.getSettablePaths();
     return await this.loadToolSubagentsDefault({
-      relativeDirPath: ClaudecodeSubagent.getSettablePaths().relativeDirPath,
-      fromFile: (relativeFilePath) => ClaudecodeSubagent.fromFile({ relativeFilePath })
+      relativeDirPath: paths.relativeDirPath,
+      fromFile: (relativeFilePath) => ClaudecodeSubagent.fromFile({
+        baseDir: this.baseDir,
+        relativeFilePath,
+        global: this.global
+      })
     });
   }
   /**
@@ -3999,6 +4020,9 @@ var SubagentsProcessor = class extends FeatureProcessor {
   static getToolTargetsSimulated() {
     return subagentsProcessorToolTargetsSimulated;
   }
+  static getToolTargetsGlobal() {
+    return subagentsProcessorToolTargetsGlobal;
+  }
 };
 
 // src/rules/agentsmd-rule.ts
@@ -6607,22 +6631,20 @@ async function generateSubagents(config) {
     logger.debug("Skipping subagent file generation (not in --features)");
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
-    logger.debug("Skipping subagent file generation (not supported in global mode)");
-    return 0;
-  }
   let totalSubagentOutputs = 0;
   logger.info("Generating subagent files...");
+  const toolTargets = config.getExperimentalGlobal() ? intersection(config.getTargets(), SubagentsProcessor.getToolTargetsGlobal()) : intersection(
+    config.getTargets(),
+    SubagentsProcessor.getToolTargets({
+      includeSimulated: config.getExperimentalSimulateSubagents()
+    })
+  );
   for (const baseDir of config.getBaseDirs()) {
-    for (const toolTarget of intersection(
-      config.getTargets(),
-      SubagentsProcessor.getToolTargets({
-        includeSimulated: config.getExperimentalSimulateSubagents()
-      })
-    )) {
+    for (const toolTarget of toolTargets) {
       const processor = new SubagentsProcessor({
         baseDir,
-        toolTarget
+        toolTarget,
+        global: config.getExperimentalGlobal()
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFilesToDelete();
@@ -6846,17 +6868,14 @@ async function importSubagents(config, tool) {
   if (!config.getFeatures().includes("subagents")) {
     return 0;
   }
-  if (config.getExperimentalGlobal()) {
-    logger.debug("Skipping subagent file import (not supported in global mode)");
-    return 0;
-  }
   const supportedTargets = SubagentsProcessor.getToolTargets({ includeSimulated: false });
   if (!supportedTargets.includes(tool)) {
     return 0;
   }
   const subagentsProcessor = new SubagentsProcessor({
     baseDir: config.getBaseDirs()[0] ?? ".",
-    toolTarget: tool
+    toolTarget: tool,
+    global: config.getExperimentalGlobal()
   });
   const toolFiles = await subagentsProcessor.loadToolFiles();
   if (toolFiles.length === 0) {
@@ -6955,7 +6974,7 @@ globs: ["**/*"]
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.3.0";
+var getVersion = () => "3.4.0";
 var main = async () => {
   const program = new Command();
   const version = getVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "keywords": [
     "ai",
@@ -46,37 +46,37 @@
     "js-yaml": "4.1.0",
     "micromatch": "4.0.8",
     "smol-toml": "1.4.2",
-    "zod": "4.1.11"
+    "zod": "4.1.12"
   },
   "devDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.1.8",
+    "@anthropic-ai/claude-agent-sdk": "0.1.9",
     "@biomejs/biome": "2.2.5",
     "@eslint/js": "9.37.0",
     "@secretlint/secretlint-rule-preset-recommend": "11.2.4",
     "@tsconfig/node24": "24.0.1",
     "@types/js-yaml": "4.0.9",
     "@types/micromatch": "4.0.9",
-    "@types/node": "24.6.2",
-    "@typescript/native-preview": "7.0.0-dev.20251004.1",
+    "@types/node": "24.7.0",
+    "@typescript/native-preview": "7.0.0-dev.20251006.1",
     "@vitest/coverage-v8": "3.2.4",
     "cspell": "9.2.1",
     "eslint": "9.37.0",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-no-type-assertion": "1.3.0",
-    "eslint-plugin-oxlint": "1.19.0",
+    "eslint-plugin-oxlint": "1.20.0",
     "eslint-plugin-strict-dependencies": "1.3.26",
     "eslint-plugin-zod-import": "0.3.0",
-    "knip": "5.64.1",
+    "knip": "5.64.2",
     "lint-staged": "16.2.3",
     "o3-search-mcp": "0.0.9",
-    "oxlint": "1.19.0",
+    "oxlint": "1.20.0",
     "secretlint": "11.2.4",
     "simple-git-hooks": "2.13.1",
     "sort-package-json": "3.4.0",
     "tsup": "8.5.0",
     "tsx": "4.20.6",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.45.0",
+    "typescript-eslint": "8.46.0",
     "vitest": "3.2.4"
   },
   "engines": {