rulesync 0.5.0 → 0.10.0

package/README.md

@@ -11,6 +11,7 @@ A Node.js CLI tool that automatically generates configuration files for various
 - **Cursor Project Rules** (`.cursor/rules/*.mdc`) 
 - **Cline Rules** (`.clinerules/*.md`)
 - **Claude Code Memory** (`./CLAUDE.md` + `.claude/memories/*.md`)
+- **Roo Code Rules** (`.roo/rules/*.md`)
 
 ## Installation
 
@@ -165,7 +166,7 @@ Define metadata in front matter for each Markdown file:
 ```markdown
 ---
 root: true # or false
-targets: ["*"] # or [copilot, cursor, cline, claudecode]
+targets: ["*"] # or [copilot, cursor, cline, claude, roo]
 description: "TypeScript coding rules"
 globs: ["**/*.ts", "**/*.tsx"]
 ---
@@ -197,6 +198,7 @@ Each AI tool handles rule levels differently:
 | **Cursor** | `ruletype: always` | `ruletype: autoattached` | Detail rules without globs use `ruletype: agentrequested` |
 | **GitHub Copilot** | Standard format | Standard format | All rules use same format with frontmatter |
 | **Cline** | Standard format | Standard format | All rules use plain Markdown format |
+| **Roo Code** | Standard format | Standard format | All rules use plain Markdown format with description header |
 
 ### 3. Generate Configuration Files
 
@@ -209,6 +211,7 @@ rulesync generate --copilot
 rulesync generate --cursor  
 rulesync generate --cline
 rulesync generate --claude
+rulesync generate --roo
 
 # Clean build (delete existing files first)
 rulesync generate --delete
@@ -225,7 +228,7 @@ rulesync generate --delete --verbose
 
 - `--delete`: Remove all existing generated files before creating new ones
 - `--verbose`: Show detailed output during generation process
-- `--copilot`, `--cursor`, `--cline`, `--claude`: Generate only for specified tools
+- `--copilot`, `--cursor`, `--cline`, `--claude`, `--roo`: Generate only for specified tools
 
 ### 4. Other Commands
 
@@ -291,7 +294,7 @@ This project follows TypeScript-first development with clean architecture princi
 ```markdown
 ---
 root: false
-targets: ["copilot", "cursor"]
+targets: ["copilot", "cursor", "roo"]
 description: "TypeScript coding standards"
 globs: ["**/*.ts", "**/*.tsx"]
 ---
@@ -311,6 +314,7 @@ globs: ["**/*.ts", "**/*.tsx"]
 | **Cursor** | `.cursor/rules/*.mdc` | MDC (YAML header + Markdown) | Root: `ruletype: always`<br>Non-root: `ruletype: autoattached`<br>Non-root without globs: `ruletype: agentrequested` |
 | **Cline** | `.clinerules/*.md` | Plain Markdown | Both levels use same format |
 | **Claude Code** | `./CLAUDE.md` (root)<br>`.claude/memories/*.md` (non-root) | Plain Markdown | Root goes to CLAUDE.md<br>Non-root go to separate memory files<br>CLAUDE.md includes `@filename` references |
+| **Roo Code** | `.roo/rules/*.md` | Plain Markdown | Both levels use same format with description header |
 
 ## Validation
 

package/dist/index.js

@@ -51,8 +51,10 @@ async function generateClaudeConfig(rules, config) {
 function generateClaudeMarkdown(rootRules, detailRules) {
   const lines = [];
   if (detailRules.length > 0) {
+    lines.push("Please also reference the following documents as needed:");
+    lines.push("");
     for (const rule of detailRules) {
-      lines.push(`@${rule.filename}`);
+      lines.push(`@.claude/memories/${rule.filename}.md`);
     }
     lines.push("");
   }
@@ -71,38 +73,14 @@ function generateClaudeMarkdown(rootRules, detailRules) {
 }
 function formatRuleForClaude(rule) {
   const lines = [];
-  lines.push(`### ${rule.filename}`);
+  lines.push(`### ${rule.frontmatter.description}`);
   lines.push("");
-  if (rule.frontmatter.description) {
-    lines.push(`**Description:** ${rule.frontmatter.description}`);
-    lines.push("");
-  }
-  if (rule.frontmatter.globs && rule.frontmatter.globs.length > 0) {
-    lines.push(`**File patterns:** ${rule.frontmatter.globs.join(", ")}`);
-    lines.push("");
-  }
   lines.push(rule.content);
   lines.push("");
   return lines;
 }
 function generateMemoryFile(rule) {
-  const lines = [];
-  lines.push("Please also refer to the following files as needed:");
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push(`# ${rule.filename}`);
-  lines.push("");
-  if (rule.frontmatter.description) {
-    lines.push(`**Description:** ${rule.frontmatter.description}`);
-    lines.push("");
-  }
-  if (rule.frontmatter.globs && rule.frontmatter.globs.length > 0) {
-    lines.push(`**File patterns:** ${rule.frontmatter.globs.join(", ")}`);
-    lines.push("");
-  }
-  lines.push(rule.content);
-  return lines.join("\n");
+  return rule.content;
 }
 
 // src/generators/cline.ts
@@ -121,15 +99,7 @@ async function generateClineConfig(rules, config) {
   return outputs;
 }
 function generateClineMarkdown(rule) {
-  const lines = [];
-  lines.push(`# ${rule.frontmatter.description}`);
-  lines.push("");
-  if (rule.frontmatter.globs.length > 0) {
-    lines.push(`**Applies to files:** ${rule.frontmatter.globs.join(", ")}`);
-    lines.push("");
-  }
-  lines.push(rule.content);
-  return lines.join("\n");
+  return rule.content;
 }
 
 // src/generators/copilot.ts
@@ -158,7 +128,6 @@ function generateCopilotMarkdown(rule) {
     lines.push('applyTo: "**"');
   }
   lines.push("---");
-  lines.push("");
   lines.push(rule.content);
   return lines.join("\n");
 }
@@ -195,7 +164,27 @@ function generateCursorMarkdown(rule) {
   }
   lines.push(`ruletype: ${ruletype}`);
   lines.push("---");
-  lines.push("");
+  lines.push(rule.content);
+  return lines.join("\n");
+}
+
+// src/generators/roo.ts
+var import_node_path5 = require("path");
+async function generateRooConfig(rules, config) {
+  const outputs = [];
+  for (const rule of rules) {
+    const content = generateRooMarkdown(rule);
+    const filepath = (0, import_node_path5.join)(config.outputPaths.roo, `${rule.filename}.md`);
+    outputs.push({
+      tool: "roo",
+      filepath,
+      content
+    });
+  }
+  return outputs;
+}
+function generateRooMarkdown(rule) {
+  const lines = [];
   lines.push(rule.content);
   return lines.join("\n");
 }
@@ -208,10 +197,11 @@ function getDefaultConfig() {
       copilot: ".github/instructions",
       cursor: ".cursor/rules",
       cline: ".clinerules",
-      claude: "."
+      claude: ".",
+      roo: ".roo/rules"
     },
     watchEnabled: false,
-    defaultTargets: ["copilot", "cursor", "cline", "claude"]
+    defaultTargets: ["copilot", "cursor", "cline", "claude", "roo"]
   };
 }
 function resolveTargets(targets, config) {
@@ -223,7 +213,7 @@ function resolveTargets(targets, config) {
 
 // src/utils/file.ts
 var import_promises = require("fs/promises");
-var import_node_path5 = require("path");
+var import_node_path6 = require("path");
 async function ensureDir(dirPath) {
   try {
     await (0, import_promises.stat)(dirPath);
@@ -235,13 +225,13 @@ async function readFileContent(filepath) {
   return (0, import_promises.readFile)(filepath, "utf-8");
 }
 async function writeFileContent(filepath, content) {
-  await ensureDir((0, import_node_path5.dirname)(filepath));
+  await ensureDir((0, import_node_path6.dirname)(filepath));
   await (0, import_promises.writeFile)(filepath, content, "utf-8");
 }
 async function findFiles(dir, extension = ".md") {
   try {
     const files = await (0, import_promises.readdir)(dir);
-    return files.filter((file) => file.endsWith(extension)).map((file) => (0, import_node_path5.join)(dir, file));
+    return files.filter((file) => file.endsWith(extension)).map((file) => (0, import_node_path6.join)(dir, file));
   } catch {
     return [];
   }
@@ -255,6 +245,11 @@ async function fileExists(filepath) {
   }
 }
 async function removeDirectory(dirPath) {
+  const dangerousPaths = [".", "/", "~", "src", "node_modules"];
+  if (dangerousPaths.includes(dirPath) || dirPath === "") {
+    console.warn(`Skipping deletion of dangerous path: ${dirPath}`);
+    return;
+  }
   try {
     if (await fileExists(dirPath)) {
       await (0, import_promises.rm)(dirPath, { recursive: true, force: true });
@@ -263,6 +258,25 @@ async function removeDirectory(dirPath) {
     console.warn(`Failed to remove directory ${dirPath}:`, error);
   }
 }
+async function removeFile(filepath) {
+  try {
+    if (await fileExists(filepath)) {
+      await (0, import_promises.rm)(filepath);
+    }
+  } catch (error) {
+    console.warn(`Failed to remove file ${filepath}:`, error);
+  }
+}
+async function removeClaudeGeneratedFiles() {
+  const filesToRemove = ["CLAUDE.md", ".claude/memories"];
+  for (const fileOrDir of filesToRemove) {
+    if (fileOrDir.endsWith("/memories")) {
+      await removeDirectory(fileOrDir);
+    } else {
+      await removeFile(fileOrDir);
+    }
+  }
+}
 
 // src/core/generator.ts
 async function generateConfigurations(rules, config, targetTools) {
@@ -297,6 +311,8 @@ async function generateForTool(tool, rules, config) {
       return generateClineConfig(rules, config);
     case "claude":
       return await generateClaudeConfig(rules, config);
+    case "roo":
+      return generateRooConfig(rules, config);
     default:
       console.warn(`Unknown tool: ${tool}`);
       return null;
@@ -304,7 +320,7 @@ async function generateForTool(tool, rules, config) {
 }
 
 // src/core/parser.ts
-var import_node_path6 = require("path");
+var import_node_path7 = require("path");
 var import_gray_matter = __toESM(require("gray-matter"));
 async function parseRulesFromDirectory(aiRulesDir) {
   const ruleFiles = await findFiles(aiRulesDir);
@@ -324,7 +340,7 @@ async function parseRuleFile(filepath) {
   const parsed = (0, import_gray_matter.default)(content);
   validateFrontmatter(parsed.data, filepath);
   const frontmatter = parsed.data;
-  const filename = (0, import_node_path6.basename)(filepath, ".md");
+  const filename = (0, import_node_path7.basename)(filepath, ".md");
   return {
     frontmatter,
     content: parsed.content,
@@ -452,7 +468,10 @@ async function generateCommand(options = {}) {
             deleteTasks.push(removeDirectory(config.outputPaths.cline));
             break;
           case "claude":
-            deleteTasks.push(removeDirectory(config.outputPaths.claude));
+            deleteTasks.push(removeClaudeGeneratedFiles());
+            break;
+          case "roo":
+            deleteTasks.push(removeDirectory(config.outputPaths.roo));
             break;
         }
       }
@@ -480,15 +499,18 @@ async function generateCommand(options = {}) {
 
 // src/cli/commands/gitignore.ts
 var import_node_fs = require("fs");
-var import_node_path7 = require("path");
+var import_node_path8 = require("path");
 var gitignoreCommand = async () => {
-  const gitignorePath = (0, import_node_path7.join)(process.cwd(), ".gitignore");
+  const gitignorePath = (0, import_node_path8.join)(process.cwd(), ".gitignore");
   const rulesFilesToIgnore = [
     "# Generated by rulesync - AI tool configuration files",
+    ".github/copilot-instructions.md",
     ".github/instructions/",
     ".cursor/rules/",
     ".clinerules/",
-    "CLAUDE.md"
+    "CLAUDE.md",
+    ".claude/memories/",
+    ".roo/rules/"
   ];
   let gitignoreContent = "";
   if ((0, import_node_fs.existsSync)(gitignorePath)) {
@@ -519,7 +541,7 @@ ${linesToAdd.join("\n")}
 };
 
 // src/cli/commands/init.ts
-var import_node_path8 = require("path");
+var import_node_path9 = require("path");
 async function initCommand() {
   const aiRulesDir = ".rulesync";
   console.log("Initializing rulesync...");
@@ -609,7 +631,7 @@ globs: ["src/**/*.ts"]
     }
   ];
   for (const file of sampleFiles) {
-    const filepath = (0, import_node_path8.join)(aiRulesDir, file.filename);
+    const filepath = (0, import_node_path9.join)(aiRulesDir, file.filename);
     if (!await fileExists(filepath)) {
       await writeFileContent(filepath, file.content);
       console.log(`Created ${filepath}`);

package/dist/index.mjs

@@ -28,8 +28,10 @@ async function generateClaudeConfig(rules, config) {
 function generateClaudeMarkdown(rootRules, detailRules) {
   const lines = [];
   if (detailRules.length > 0) {
+    lines.push("Please also reference the following documents as needed:");
+    lines.push("");
     for (const rule of detailRules) {
-      lines.push(`@${rule.filename}`);
+      lines.push(`@.claude/memories/${rule.filename}.md`);
     }
     lines.push("");
   }
@@ -48,38 +50,14 @@ function generateClaudeMarkdown(rootRules, detailRules) {
 }
 function formatRuleForClaude(rule) {
   const lines = [];
-  lines.push(`### ${rule.filename}`);
+  lines.push(`### ${rule.frontmatter.description}`);
   lines.push("");
-  if (rule.frontmatter.description) {
-    lines.push(`**Description:** ${rule.frontmatter.description}`);
-    lines.push("");
-  }
-  if (rule.frontmatter.globs && rule.frontmatter.globs.length > 0) {
-    lines.push(`**File patterns:** ${rule.frontmatter.globs.join(", ")}`);
-    lines.push("");
-  }
   lines.push(rule.content);
   lines.push("");
   return lines;
 }
 function generateMemoryFile(rule) {
-  const lines = [];
-  lines.push("Please also refer to the following files as needed:");
-  lines.push("");
-  lines.push("---");
-  lines.push("");
-  lines.push(`# ${rule.filename}`);
-  lines.push("");
-  if (rule.frontmatter.description) {
-    lines.push(`**Description:** ${rule.frontmatter.description}`);
-    lines.push("");
-  }
-  if (rule.frontmatter.globs && rule.frontmatter.globs.length > 0) {
-    lines.push(`**File patterns:** ${rule.frontmatter.globs.join(", ")}`);
-    lines.push("");
-  }
-  lines.push(rule.content);
-  return lines.join("\n");
+  return rule.content;
 }
 
 // src/generators/cline.ts
@@ -98,15 +76,7 @@ async function generateClineConfig(rules, config) {
   return outputs;
 }
 function generateClineMarkdown(rule) {
-  const lines = [];
-  lines.push(`# ${rule.frontmatter.description}`);
-  lines.push("");
-  if (rule.frontmatter.globs.length > 0) {
-    lines.push(`**Applies to files:** ${rule.frontmatter.globs.join(", ")}`);
-    lines.push("");
-  }
-  lines.push(rule.content);
-  return lines.join("\n");
+  return rule.content;
 }
 
 // src/generators/copilot.ts
@@ -135,7 +105,6 @@ function generateCopilotMarkdown(rule) {
     lines.push('applyTo: "**"');
   }
   lines.push("---");
-  lines.push("");
   lines.push(rule.content);
   return lines.join("\n");
 }
@@ -172,7 +141,27 @@ function generateCursorMarkdown(rule) {
   }
   lines.push(`ruletype: ${ruletype}`);
   lines.push("---");
-  lines.push("");
+  lines.push(rule.content);
+  return lines.join("\n");
+}
+
+// src/generators/roo.ts
+import { join as join5 } from "path";
+async function generateRooConfig(rules, config) {
+  const outputs = [];
+  for (const rule of rules) {
+    const content = generateRooMarkdown(rule);
+    const filepath = join5(config.outputPaths.roo, `${rule.filename}.md`);
+    outputs.push({
+      tool: "roo",
+      filepath,
+      content
+    });
+  }
+  return outputs;
+}
+function generateRooMarkdown(rule) {
+  const lines = [];
   lines.push(rule.content);
   return lines.join("\n");
 }
@@ -185,10 +174,11 @@ function getDefaultConfig() {
       copilot: ".github/instructions",
       cursor: ".cursor/rules",
       cline: ".clinerules",
-      claude: "."
+      claude: ".",
+      roo: ".roo/rules"
     },
     watchEnabled: false,
-    defaultTargets: ["copilot", "cursor", "cline", "claude"]
+    defaultTargets: ["copilot", "cursor", "cline", "claude", "roo"]
   };
 }
 function resolveTargets(targets, config) {
@@ -200,7 +190,7 @@ function resolveTargets(targets, config) {
 
 // src/utils/file.ts
 import { mkdir, readdir, readFile, rm, stat, writeFile } from "fs/promises";
-import { dirname, join as join5 } from "path";
+import { dirname, join as join6 } from "path";
 async function ensureDir(dirPath) {
   try {
     await stat(dirPath);
@@ -218,7 +208,7 @@ async function writeFileContent(filepath, content) {
 async function findFiles(dir, extension = ".md") {
   try {
     const files = await readdir(dir);
-    return files.filter((file) => file.endsWith(extension)).map((file) => join5(dir, file));
+    return files.filter((file) => file.endsWith(extension)).map((file) => join6(dir, file));
   } catch {
     return [];
   }
@@ -232,6 +222,11 @@ async function fileExists(filepath) {
   }
 }
 async function removeDirectory(dirPath) {
+  const dangerousPaths = [".", "/", "~", "src", "node_modules"];
+  if (dangerousPaths.includes(dirPath) || dirPath === "") {
+    console.warn(`Skipping deletion of dangerous path: ${dirPath}`);
+    return;
+  }
   try {
     if (await fileExists(dirPath)) {
       await rm(dirPath, { recursive: true, force: true });
@@ -240,6 +235,25 @@ async function removeDirectory(dirPath) {
     console.warn(`Failed to remove directory ${dirPath}:`, error);
   }
 }
+async function removeFile(filepath) {
+  try {
+    if (await fileExists(filepath)) {
+      await rm(filepath);
+    }
+  } catch (error) {
+    console.warn(`Failed to remove file ${filepath}:`, error);
+  }
+}
+async function removeClaudeGeneratedFiles() {
+  const filesToRemove = ["CLAUDE.md", ".claude/memories"];
+  for (const fileOrDir of filesToRemove) {
+    if (fileOrDir.endsWith("/memories")) {
+      await removeDirectory(fileOrDir);
+    } else {
+      await removeFile(fileOrDir);
+    }
+  }
+}
 
 // src/core/generator.ts
 async function generateConfigurations(rules, config, targetTools) {
@@ -274,6 +288,8 @@ async function generateForTool(tool, rules, config) {
       return generateClineConfig(rules, config);
     case "claude":
       return await generateClaudeConfig(rules, config);
+    case "roo":
+      return generateRooConfig(rules, config);
     default:
       console.warn(`Unknown tool: ${tool}`);
       return null;
@@ -429,7 +445,10 @@ async function generateCommand(options = {}) {
             deleteTasks.push(removeDirectory(config.outputPaths.cline));
             break;
           case "claude":
-            deleteTasks.push(removeDirectory(config.outputPaths.claude));
+            deleteTasks.push(removeClaudeGeneratedFiles());
+            break;
+          case "roo":
+            deleteTasks.push(removeDirectory(config.outputPaths.roo));
             break;
         }
       }
@@ -457,15 +476,18 @@ async function generateCommand(options = {}) {
 
 // src/cli/commands/gitignore.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 var gitignoreCommand = async () => {
-  const gitignorePath = join6(process.cwd(), ".gitignore");
+  const gitignorePath = join7(process.cwd(), ".gitignore");
   const rulesFilesToIgnore = [
     "# Generated by rulesync - AI tool configuration files",
+    ".github/copilot-instructions.md",
     ".github/instructions/",
     ".cursor/rules/",
     ".clinerules/",
-    "CLAUDE.md"
+    "CLAUDE.md",
+    ".claude/memories/",
+    ".roo/rules/"
   ];
   let gitignoreContent = "";
   if (existsSync(gitignorePath)) {
@@ -496,7 +518,7 @@ ${linesToAdd.join("\n")}
 };
 
 // src/cli/commands/init.ts
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 async function initCommand() {
   const aiRulesDir = ".rulesync";
   console.log("Initializing rulesync...");
@@ -586,7 +608,7 @@ globs: ["src/**/*.ts"]
     }
   ];
   for (const file of sampleFiles) {
-    const filepath = join7(aiRulesDir, file.filename);
+    const filepath = join8(aiRulesDir, file.filename);
     if (!await fileExists(filepath)) {
       await writeFileContent(filepath, file.content);
       console.log(`Created ${filepath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "0.5.0",
+  "version": "0.10.0",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "main": "dist/index.js",
   "module": "dist/index.mjs",