rulesync 0.61.0 → 0.63.0

package/README.md

@@ -3,7 +3,7 @@
 [![CI](https://github.com/dyoshikawa/rulesync/actions/workflows/ci.yml/badge.svg)](https://github.com/dyoshikawa/rulesync/actions/workflows/ci.yml)
 [![npm version](https://badge.fury.io/js/rulesync.svg)](https://www.npmjs.com/package/rulesync)
 
-A Node.js CLI tool that automatically generates configuration files for various AI development tools from unified AI rule files (`.rulesync/*.md`). Also imports existing AI tool configurations into the unified format.
+A Node.js CLI tool that automatically generates configuration files for various AI development tools from unified AI rule files. Uses the recommended `.rulesync/rules/*.md` structure, with backward compatibility for legacy `.rulesync/*.md` layouts. Also imports existing AI tool configurations into the unified format.
 
 ## Installation
 
@@ -21,11 +21,17 @@ yarn global add rulesync
 
 1. **Initialize your project:**
    ```bash
+   # Recommended: Use new organized structure
    npx rulesync init
+   
+   # Legacy: Use backward-compatible structure
+   npx rulesync init --legacy
    ```
 
-2. **Edit the generated rule files** in `.rulesync/` directory to match your project needs
-
+2. **Edit the generated rule files:**
+   - **Recommended**: Edit files in `.rulesync/rules/` directory
+   - **Legacy**: Edit files in `.rulesync/` directory
+   
 3. **Generate tool-specific configuration files:**
    ```bash
    npx rulesync generate
@@ -36,11 +42,16 @@ yarn global add rulesync
 If you already have AI tool configurations:
 
 ```bash
-# Import existing configurations
+# Import existing configurations (to recommended structure)
 npx rulesync import --claudecode  # From CLAUDE.md
 npx rulesync import --cursor      # From .cursorrules
 npx rulesync import --copilot     # From .github/copilot-instructions.md
 
+# Import to legacy structure (for existing projects)
+npx rulesync import --claudecode --legacy
+npx rulesync import --cursor --legacy
+npx rulesync import --copilot --legacy
+
 # Generate unified configurations
 npx rulesync generate
 ```
@@ -83,24 +94,36 @@ Avoid vendor lock-in completely. If you decide to stop using rulesync, you can c
 ### 🎯 **Consistency Across Tools**
 Apply consistent rules across all AI tools, improving code quality and development experience for the entire team.
 
+### 📁 **Organized Structure**
+New organized directory structure (`.rulesync/rules/`) keeps rules well-organized, while maintaining full backward compatibility with legacy layouts (`.rulesync/*.md`) for existing projects.
+
 ## Quick Commands
 
 ```bash
-# Initialize new project
+# Initialize new project (recommended: organized rules structure)
 npx rulesync init
 
-# Add new rule file
+# Initialize with legacy layout (backward compatibility)
+npx rulesync init --legacy
+
+# Add new rule file to recommended location
 npx rulesync add typescript-rules
 
+# Add rule file to legacy location (for existing projects)
+npx rulesync add typescript-rules --legacy
+
+# Import existing configurations (to .rulesync/rules/ by default)
+npx rulesync import --cursor
+
+# Import to legacy location (for existing projects)
+npx rulesync import --cursor --legacy
+
 # Validate rules
 npx rulesync validate
 
 # Generate configurations
 npx rulesync generate
 
-# Import from existing tools
-npx rulesync import --cursor
-
 # Watch for changes
 npx rulesync watch
 

package/dist/{chunk-C5LFJFPS.js → chunk-2CW2KFB3.js}

@@ -1,7 +1,7 @@
 import {
   generateMcpConfig,
   generateMcpConfigurationFiles
-} from "./chunk-2KYIOT5S.js";
+} from "./chunk-GQTMTBX4.js";
 
 // src/generators/mcp/codexcli.ts
 function generateCodexMcp(config) {

package/dist/{chunk-DA3XULAD.js → chunk-4PSTOKKD.js}

@@ -1,6 +1,6 @@
 import {
   cursorMcpGenerator
-} from "./chunk-2KYIOT5S.js";
+} from "./chunk-GQTMTBX4.js";
 
 // src/generators/mcp/cursor.ts
 var generateCursorMcp = cursorMcpGenerator.generateMcp;

package/dist/{chunk-2KYIOT5S.js → chunk-GQTMTBX4.js}

@@ -259,7 +259,8 @@ function generateMcpConfigurationFilesFromRegistry(tool, mcpServers, baseDir = "
   return generateMcpConfigurationFiles(mcpServers, generatorConfig, baseDir);
 }
 function generateJunieMcpConfigurationFiles(mcpServers, baseDir = "") {
-  const filepath = baseDir ? `${baseDir}/.junie/mcp-config.json` : ".junie/mcp-config.json";
+  const junieMcpPath = ".junie/mcp/mcp.json";
+  const filepath = baseDir ? `${baseDir}/${junieMcpPath}` : junieMcpPath;
   const config = {
     mcpServers: {}
   };

package/dist/{chunk-U63N3YDS.js → chunk-M7NL7G7A.js}

@@ -1,7 +1,7 @@
 import {
   generateMcpConfigurationFilesFromRegistry,
   generateMcpFromRegistry
-} from "./chunk-2KYIOT5S.js";
+} from "./chunk-GQTMTBX4.js";
 
 // src/generators/mcp/junie.ts
 function generateJunieMcp(config) {

package/dist/{chunk-LRYVNLH5.js → chunk-MDYDKNXQ.js}

@@ -2,7 +2,7 @@ import {
   configWrappers,
   generateMcpConfig,
   generateMcpConfigurationFiles
-} from "./chunk-2KYIOT5S.js";
+} from "./chunk-GQTMTBX4.js";
 
 // src/generators/mcp/geminicli.ts
 function generateGeminiCliMcp(config) {

package/dist/{chunk-ICMPPX55.js → chunk-NETSYSMD.js}

@@ -1,7 +1,7 @@
 import {
   generateMcpConfigurationFilesFromRegistry,
   generateMcpFromRegistry
-} from "./chunk-2KYIOT5S.js";
+} from "./chunk-GQTMTBX4.js";
 
 // src/generators/mcp/windsurf.ts
 function generateWindsurfMcp(config) {

package/dist/{chunk-3ZLMXJTX.js → chunk-U4PLVMCG.js}

@@ -1,7 +1,7 @@
 import {
   generateMcpConfigurationFilesFromRegistry,
   generateMcpFromRegistry
-} from "./chunk-2KYIOT5S.js";
+} from "./chunk-GQTMTBX4.js";
 
 // src/generators/mcp/claudecode.ts
 function generateClaudeMcp(config) {

package/dist/{chunk-74TYZWHJ.js → chunk-UEAYL4NT.js}

@@ -1,6 +1,6 @@
 import {
   clineMcpGenerator
-} from "./chunk-2KYIOT5S.js";
+} from "./chunk-GQTMTBX4.js";
 
 // src/generators/mcp/cline.ts
 var generateClineMcp = clineMcpGenerator.generateMcp;

package/dist/{claudecode-XKHMZT7R.js → claudecode-YTEFACCT.js}

@@ -1,8 +1,8 @@
 import {
   generateClaudeMcp,
   generateClaudeMcpConfiguration
-} from "./chunk-3ZLMXJTX.js";
-import "./chunk-2KYIOT5S.js";
+} from "./chunk-U4PLVMCG.js";
+import "./chunk-GQTMTBX4.js";
 import "./chunk-AUUSMVCT.js";
 export {
   generateClaudeMcp,

package/dist/{cline-FNWPJ7K4.js → cline-CKNUDEA3.js}

@@ -1,8 +1,8 @@
 import {
   generateClineMcp,
   generateClineMcpConfiguration
-} from "./chunk-74TYZWHJ.js";
-import "./chunk-2KYIOT5S.js";
+} from "./chunk-UEAYL4NT.js";
+import "./chunk-GQTMTBX4.js";
 import "./chunk-AUUSMVCT.js";
 export {
   generateClineMcp,

package/dist/{codexcli-FDFHY66P.js → codexcli-7SDGYI7D.js}

@@ -1,8 +1,8 @@
 import {
   generateCodexMcp,
   generateCodexMcpConfiguration
-} from "./chunk-C5LFJFPS.js";
-import "./chunk-2KYIOT5S.js";
+} from "./chunk-2CW2KFB3.js";
+import "./chunk-GQTMTBX4.js";
 import "./chunk-AUUSMVCT.js";
 export {
   generateCodexMcp,

package/dist/{cursor-WWHUW5AD.js → cursor-YJGH7W24.js}

@@ -1,8 +1,8 @@
 import {
   generateCursorMcp,
   generateCursorMcpConfiguration
-} from "./chunk-DA3XULAD.js";
-import "./chunk-2KYIOT5S.js";
+} from "./chunk-4PSTOKKD.js";
+import "./chunk-GQTMTBX4.js";
 import "./chunk-AUUSMVCT.js";
 export {
   generateCursorMcp,

package/dist/{geminicli-7TIDQ62D.js → geminicli-E7KZTZ2G.js}

@@ -1,8 +1,8 @@
 import {
   generateGeminiCliMcp,
   generateGeminiCliMcpConfiguration
-} from "./chunk-LRYVNLH5.js";
-import "./chunk-2KYIOT5S.js";
+} from "./chunk-MDYDKNXQ.js";
+import "./chunk-GQTMTBX4.js";
 import "./chunk-AUUSMVCT.js";
 export {
   generateGeminiCliMcp,