rulesync 3.28.1 → 3.28.2

package/README.md

@@ -213,11 +213,28 @@ npx rulesync gitignore
 
 You can configure Rulesync by creating a `rulesync.jsonc` file in the root of your project.
 
+### JSON Schema Support
+
+Rulesync provides a JSON Schema for editor validation and autocompletion. Add the `$schema` property to your `rulesync.jsonc`:
+
+```jsonc
+// rulesync.jsonc
+{
+  "$schema": "https://raw.githubusercontent.com/dyoshikawa/rulesync/refs/heads/main/config-schema.json",
+  "targets": ["claudecode"],
+  "features": ["rules"]
+}
+```
+
+### Configuration Options
+
 Example:
 
 ```jsonc
 // rulesync.jsonc
 {
+  "$schema": "https://raw.githubusercontent.com/dyoshikawa/rulesync/refs/heads/main/config-schema.json",
+
   // List of tools to generate configurations for. You can specify "*" to generate all tools.
   "targets": ["cursor", "claudecode", "geminicli", "opencode", "codexcli"],
 

package/dist/index.cjs

@@ -290,6 +290,10 @@ var ConfigParamsSchema = import_mini3.z.object({
   experimentalSimulateSubagents: (0, import_mini3.optional)(import_mini3.z.boolean())
 });
 var PartialConfigParamsSchema = import_mini3.z.partial(ConfigParamsSchema);
+var ConfigFileSchema = import_mini3.z.object({
+  $schema: (0, import_mini3.optional)(import_mini3.z.string()),
+  ...import_mini3.z.partial(ConfigParamsSchema).shape
+});
 var RequiredConfigParamsSchema = import_mini3.z.required(ConfigParamsSchema);
 var Config = class {
   baseDirs;
@@ -419,7 +423,9 @@ var ConfigResolver = class {
       try {
         const fileContent = await readFileContent(validatedConfigPath);
         const jsonData = (0, import_jsonc_parser.parse)(fileContent);
-        configByFile = PartialConfigParamsSchema.parse(jsonData);
+        const parsed = ConfigFileSchema.parse(jsonData);
+        const { $schema: _schema, ...configParams2 } = parsed;
+        configByFile = configParams2;
       } catch (error) {
         logger.error(`Failed to load config file: ${formatError(error)}`);
         throw error;
@@ -665,6 +671,13 @@ var AiFile = class {
   setFileContent(newFileContent) {
     this.fileContent = newFileContent;
   }
+  /**
+   * Returns whether this file can be deleted by rulesync.
+   * Override in subclasses that should not be deleted (e.g., user-managed config files).
+   */
+  isDeletable() {
+    return true;
+  }
 };
 
 // src/features/commands/tool-command.ts
@@ -2324,6 +2337,13 @@ var ClaudecodeIgnore = class _ClaudecodeIgnore extends ToolIgnore {
       relativeFilePath: "settings.local.json"
     };
   }
+  /**
+   * ClaudecodeIgnore uses settings.local.json which is a user-managed config file.
+   * It should not be deleted by rulesync.
+   */
+  isDeletable() {
+    return false;
+  }
   toRulesyncIgnore() {
     const rulesyncPatterns = this.patterns.map((pattern) => {
       if (pattern.startsWith("Read(") && pattern.endsWith(")")) {
@@ -2814,7 +2834,7 @@ var IgnoreProcessor = class extends FeatureProcessor {
     try {
       const toolIgnores = await this.loadToolIgnores();
       if (forDeletion) {
-        return toolIgnores.filter((toolFile) => !(toolFile instanceof ClaudecodeIgnore));
+        return toolIgnores.filter((toolFile) => toolFile.isDeletable());
       }
       return toolIgnores;
     } catch (error) {
@@ -3316,6 +3336,14 @@ var ClaudecodeMcp = class _ClaudecodeMcp extends ToolMcp {
   getJson() {
     return this.json;
   }
+  /**
+   * In global mode, ~/.claude/.claude.json should not be deleted
+   * as it may contain other user settings.
+   * In local mode, .mcp.json can be safely deleted.
+   */
+  isDeletable() {
+    return !this.global;
+  }
   static getSettablePaths({ global } = {}) {
     if (global) {
       return {
@@ -3898,6 +3926,12 @@ var OpencodeMcp = class _OpencodeMcp extends ToolMcp {
   getJson() {
     return this.json;
   }
+  /**
+   * opencode.json may contain other settings, so it should not be deleted.
+   */
+  isDeletable() {
+    return false;
+  }
   static getSettablePaths({ global } = {}) {
     if (global) {
       return {
@@ -4182,11 +4216,7 @@ var McpProcessor = class extends FeatureProcessor {
       })();
       logger.info(`Successfully loaded ${toolMcps.length} ${this.toolTarget} MCP files`);
       if (forDeletion) {
-        let filteredMcps = toolMcps.filter((toolFile) => !(toolFile instanceof OpencodeMcp));
-        if (this.global) {
-          filteredMcps = filteredMcps.filter((toolFile) => !(toolFile instanceof ClaudecodeMcp));
-        }
-        return filteredMcps;
+        return toolMcps.filter((toolFile) => toolFile.isDeletable());
       }
       return toolMcps;
     } catch (error) {
@@ -4567,20 +4597,13 @@ var SimulatedSkill = class extends ToolSkill {
       name: rulesyncFrontmatter.name,
       description: rulesyncFrontmatter.description
     };
-    const otherFiles = rulesyncSkill.getOtherFiles();
-    if (otherFiles.length > 0) {
-      logger.warn(
-        `Skill "${rulesyncFrontmatter.name}" has ${otherFiles.length} additional file(s) that will be ignored for simulated skill generation.`
-      );
-    }
     return {
       baseDir: rulesyncSkill.getBaseDir(),
       relativeDirPath: this.getSettablePaths().relativeDirPath,
       dirName: rulesyncSkill.getDirName(),
       frontmatter: simulatedFrontmatter,
       body: rulesyncSkill.getBody(),
-      otherFiles: [],
-      // Simulated skills ignore otherFiles
+      otherFiles: rulesyncSkill.getOtherFiles(),
       validate
     };
   }
@@ -4602,14 +4625,19 @@ var SimulatedSkill = class extends ToolSkill {
     if (!result.success) {
       throw new Error(`Invalid frontmatter in ${skillFilePath}: ${formatError(result.error)}`);
     }
+    const otherFiles = await this.collectOtherFiles(
+      baseDir,
+      actualRelativeDirPath,
+      dirName,
+      SKILL_FILE_NAME
+    );
     return {
       baseDir,
       relativeDirPath: actualRelativeDirPath,
       dirName,
       frontmatter: result.data,
       body: content.trim(),
-      otherFiles: [],
-      // Simulated skills ignore otherFiles
+      otherFiles,
       validate: true
     };
   }
@@ -10240,7 +10268,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.28.1";
+var getVersion = () => "3.28.2";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();

package/dist/index.js

@@ -267,6 +267,10 @@ var ConfigParamsSchema = z3.object({
   experimentalSimulateSubagents: optional(z3.boolean())
 });
 var PartialConfigParamsSchema = z3.partial(ConfigParamsSchema);
+var ConfigFileSchema = z3.object({
+  $schema: optional(z3.string()),
+  ...z3.partial(ConfigParamsSchema).shape
+});
 var RequiredConfigParamsSchema = z3.required(ConfigParamsSchema);
 var Config = class {
   baseDirs;
@@ -396,7 +400,9 @@ var ConfigResolver = class {
       try {
         const fileContent = await readFileContent(validatedConfigPath);
         const jsonData = parseJsonc(fileContent);
-        configByFile = PartialConfigParamsSchema.parse(jsonData);
+        const parsed = ConfigFileSchema.parse(jsonData);
+        const { $schema: _schema, ...configParams2 } = parsed;
+        configByFile = configParams2;
       } catch (error) {
         logger.error(`Failed to load config file: ${formatError(error)}`);
         throw error;
@@ -642,6 +648,13 @@ var AiFile = class {
   setFileContent(newFileContent) {
     this.fileContent = newFileContent;
   }
+  /**
+   * Returns whether this file can be deleted by rulesync.
+   * Override in subclasses that should not be deleted (e.g., user-managed config files).
+   */
+  isDeletable() {
+    return true;
+  }
 };
 
 // src/features/commands/tool-command.ts
@@ -2301,6 +2314,13 @@ var ClaudecodeIgnore = class _ClaudecodeIgnore extends ToolIgnore {
       relativeFilePath: "settings.local.json"
     };
   }
+  /**
+   * ClaudecodeIgnore uses settings.local.json which is a user-managed config file.
+   * It should not be deleted by rulesync.
+   */
+  isDeletable() {
+    return false;
+  }
   toRulesyncIgnore() {
     const rulesyncPatterns = this.patterns.map((pattern) => {
       if (pattern.startsWith("Read(") && pattern.endsWith(")")) {
@@ -2791,7 +2811,7 @@ var IgnoreProcessor = class extends FeatureProcessor {
     try {
       const toolIgnores = await this.loadToolIgnores();
       if (forDeletion) {
-        return toolIgnores.filter((toolFile) => !(toolFile instanceof ClaudecodeIgnore));
+        return toolIgnores.filter((toolFile) => toolFile.isDeletable());
       }
       return toolIgnores;
     } catch (error) {
@@ -3293,6 +3313,14 @@ var ClaudecodeMcp = class _ClaudecodeMcp extends ToolMcp {
   getJson() {
     return this.json;
   }
+  /**
+   * In global mode, ~/.claude/.claude.json should not be deleted
+   * as it may contain other user settings.
+   * In local mode, .mcp.json can be safely deleted.
+   */
+  isDeletable() {
+    return !this.global;
+  }
   static getSettablePaths({ global } = {}) {
     if (global) {
       return {
@@ -3875,6 +3903,12 @@ var OpencodeMcp = class _OpencodeMcp extends ToolMcp {
   getJson() {
     return this.json;
   }
+  /**
+   * opencode.json may contain other settings, so it should not be deleted.
+   */
+  isDeletable() {
+    return false;
+  }
   static getSettablePaths({ global } = {}) {
     if (global) {
       return {
@@ -4159,11 +4193,7 @@ var McpProcessor = class extends FeatureProcessor {
       })();
       logger.info(`Successfully loaded ${toolMcps.length} ${this.toolTarget} MCP files`);
       if (forDeletion) {
-        let filteredMcps = toolMcps.filter((toolFile) => !(toolFile instanceof OpencodeMcp));
-        if (this.global) {
-          filteredMcps = filteredMcps.filter((toolFile) => !(toolFile instanceof ClaudecodeMcp));
-        }
-        return filteredMcps;
+        return toolMcps.filter((toolFile) => toolFile.isDeletable());
       }
       return toolMcps;
     } catch (error) {
@@ -4544,20 +4574,13 @@ var SimulatedSkill = class extends ToolSkill {
       name: rulesyncFrontmatter.name,
       description: rulesyncFrontmatter.description
     };
-    const otherFiles = rulesyncSkill.getOtherFiles();
-    if (otherFiles.length > 0) {
-      logger.warn(
-        `Skill "${rulesyncFrontmatter.name}" has ${otherFiles.length} additional file(s) that will be ignored for simulated skill generation.`
-      );
-    }
     return {
       baseDir: rulesyncSkill.getBaseDir(),
       relativeDirPath: this.getSettablePaths().relativeDirPath,
       dirName: rulesyncSkill.getDirName(),
       frontmatter: simulatedFrontmatter,
       body: rulesyncSkill.getBody(),
-      otherFiles: [],
-      // Simulated skills ignore otherFiles
+      otherFiles: rulesyncSkill.getOtherFiles(),
       validate
     };
   }
@@ -4579,14 +4602,19 @@ var SimulatedSkill = class extends ToolSkill {
     if (!result.success) {
       throw new Error(`Invalid frontmatter in ${skillFilePath}: ${formatError(result.error)}`);
     }
+    const otherFiles = await this.collectOtherFiles(
+      baseDir,
+      actualRelativeDirPath,
+      dirName,
+      SKILL_FILE_NAME
+    );
     return {
       baseDir,
       relativeDirPath: actualRelativeDirPath,
       dirName,
       frontmatter: result.data,
       body: content.trim(),
-      otherFiles: [],
-      // Simulated skills ignore otherFiles
+      otherFiles,
       validate: true
     };
   }
@@ -10217,7 +10245,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.28.1";
+var getVersion = () => "3.28.2";
 var main = async () => {
   const program = new Command();
   const version = getVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "3.28.1",
+  "version": "3.28.2",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "keywords": [
     "ai",
@@ -49,15 +49,15 @@
     "zod": "4.1.13"
   },
   "devDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.1.53",
-    "@biomejs/biome": "2.3.7",
+    "@anthropic-ai/claude-agent-sdk": "0.1.55",
+    "@biomejs/biome": "2.3.8",
     "@eslint/js": "9.39.1",
     "@secretlint/secretlint-rule-preset-recommend": "11.2.5",
     "@tsconfig/node24": "24.0.3",
     "@types/js-yaml": "4.0.9",
     "@types/node": "24.10.1",
-    "@typescript/native-preview": "7.0.0-dev.20251125.1",
-    "@vitest/coverage-v8": "4.0.13",
+    "@typescript/native-preview": "7.0.0-dev.20251130.1",
+    "@vitest/coverage-v8": "4.0.14",
     "cspell": "9.3.2",
     "eslint": "9.39.1",
     "eslint-plugin-import": "2.32.0",
@@ -70,12 +70,12 @@
     "oxlint": "1.30.0",
     "secretlint": "11.2.5",
     "simple-git-hooks": "2.13.1",
-    "sort-package-json": "3.4.0",
+    "sort-package-json": "3.5.0",
     "tsup": "8.5.1",
-    "tsx": "4.20.6",
+    "tsx": "4.21.0",
     "typescript": "5.9.3",
     "typescript-eslint": "8.48.0",
-    "vitest": "4.0.13"
+    "vitest": "4.0.14"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -98,6 +98,7 @@
     "eslint:fix": "eslint . --fix --max-warnings 0 --cache",
     "fix": "pnpm run bcheck:fix && pnpm run oxlint:fix && pnpm run eslint:fix",
     "generate": "pnpm run dev generate",
+    "generate:schema": "tsx scripts/generate-json-schema.ts",
     "knip": "knip",
     "oxlint": "oxlint . --max-warnings 0",
     "oxlint:fix": "oxlint . --fix --max-warnings 0",