rulesync 0.2.0 → 0.4.0

package/dist/index.mjs

@@ -3,196 +3,178 @@
 // src/cli/index.ts
 import { Command } from "commander";
 
-// src/generators/cline.ts
+// src/generators/claude.ts
 import { join } from "path";
-async function generateClineConfig(rules, config) {
-  const sortedRules = rules.sort((a, b) => {
-    if (a.frontmatter.priority !== b.frontmatter.priority) {
-      return a.frontmatter.priority === "high" ? -1 : 1;
-    }
-    return a.filename.localeCompare(b.filename);
+async function generateClaudeConfig(rules, config) {
+  const outputs = [];
+  const overviewRules = rules.filter((r) => r.frontmatter.ruleLevel === "overview");
+  const detailRules = rules.filter((r) => r.frontmatter.ruleLevel === "detail");
+  const claudeMdContent = generateClaudeMarkdown(overviewRules, detailRules);
+  outputs.push({
+    tool: "claude",
+    filepath: join(config.outputPaths.claude, "CLAUDE.md"),
+    content: claudeMdContent
   });
-  const content = generateClineMarkdown(sortedRules);
-  const filepath = join(config.outputPaths.cline, "01-ai-rules.md");
-  return {
-    tool: "cline",
-    filepath,
-    content
-  };
+  for (const rule of detailRules) {
+    const memoryContent = generateMemoryFile(rule);
+    outputs.push({
+      tool: "claude",
+      filepath: join(config.outputPaths.claude, ".claude", "memories", `${rule.filename}.md`),
+      content: memoryContent
+    });
+  }
+  return outputs;
 }
-function generateClineMarkdown(rules) {
+function generateClaudeMarkdown(overviewRules, detailRules) {
   const lines = [];
-  lines.push("# Cline AI Assistant Rules");
-  lines.push("");
-  lines.push("Configuration rules for Cline AI Assistant. Generated from ai-rules configuration.");
-  lines.push("");
-  lines.push("These rules provide project-specific guidance for AI-assisted development.");
-  lines.push("");
-  const highPriorityRules = rules.filter((r) => r.frontmatter.priority === "high");
-  const lowPriorityRules = rules.filter((r) => r.frontmatter.priority === "low");
-  if (highPriorityRules.length > 0) {
-    lines.push("## High Priority Guidelines");
-    lines.push("");
-    lines.push("These are critical rules that should always be followed:");
-    lines.push("");
-    for (const rule of highPriorityRules) {
-      lines.push(...formatRuleForCline(rule));
+  if (detailRules.length > 0) {
+    for (const rule of detailRules) {
+      lines.push(`@${rule.filename}`);
     }
-  }
-  if (lowPriorityRules.length > 0) {
-    lines.push("## Standard Guidelines");
-    lines.push("");
-    lines.push("These are recommended practices for this project:");
     lines.push("");
-    for (const rule of lowPriorityRules) {
-      lines.push(...formatRuleForCline(rule));
+  }
+  lines.push("# Claude Code Memory - Project Instructions");
+  lines.push("");
+  lines.push(
+    "Generated from rulesync configuration. These instructions guide Claude Code's behavior for this project."
+  );
+  lines.push("");
+  if (overviewRules.length > 0) {
+    for (const rule of overviewRules) {
+      lines.push(...formatRuleForClaude(rule));
     }
   }
   return lines.join("\n");
 }
-function formatRuleForCline(rule) {
+function formatRuleForClaude(rule) {
   const lines = [];
   lines.push(`### ${rule.filename}`);
   lines.push("");
-  lines.push(`**Description:** ${rule.frontmatter.description}`);
-  lines.push("");
-  if (rule.frontmatter.globs.length > 0) {
-    lines.push(`**Applies to files:** ${rule.frontmatter.globs.join(", ")}`);
+  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("**Guidelines:**");
-  lines.push("");
   lines.push(rule.content);
   lines.push("");
-  lines.push("---");
-  lines.push("");
   return lines;
 }
-
-// src/generators/copilot.ts
-import { join as join2 } from "path";
-async function generateCopilotConfig(rules, config) {
-  const sortedRules = rules.sort((a, b) => {
-    if (a.frontmatter.priority !== b.frontmatter.priority) {
-      return a.frontmatter.priority === "high" ? -1 : 1;
-    }
-    return a.filename.localeCompare(b.filename);
-  });
-  const content = generateCopilotMarkdown(sortedRules);
-  const filepath = join2(config.outputPaths.copilot, "ai-rules.instructions.md");
-  return {
-    tool: "copilot",
-    filepath,
-    content
-  };
-}
-function generateCopilotMarkdown(rules) {
+function generateMemoryFile(rule) {
   const lines = [];
-  lines.push("---");
-  lines.push('description: "AI rules configuration for GitHub Copilot"');
-  lines.push('applyTo: "**"');
-  lines.push("---");
+  lines.push("Please also refer to the following files as needed:");
   lines.push("");
-  lines.push("# GitHub Copilot Instructions");
+  lines.push("---");
   lines.push("");
-  lines.push(
-    "Generated from ai-rules configuration. These instructions guide GitHub Copilot's code suggestions."
-  );
+  lines.push(`# ${rule.filename}`);
   lines.push("");
-  const highPriorityRules = rules.filter((r) => r.frontmatter.priority === "high");
-  const lowPriorityRules = rules.filter((r) => r.frontmatter.priority === "low");
-  if (highPriorityRules.length > 0) {
-    lines.push("## High Priority Rules");
+  if (rule.frontmatter.description) {
+    lines.push(`**Description:** ${rule.frontmatter.description}`);
     lines.push("");
-    for (const rule of highPriorityRules) {
-      lines.push(...formatRuleForCopilot(rule));
-    }
   }
-  if (lowPriorityRules.length > 0) {
-    lines.push("## Standard Rules");
+  if (rule.frontmatter.globs && rule.frontmatter.globs.length > 0) {
+    lines.push(`**File patterns:** ${rule.frontmatter.globs.join(", ")}`);
     lines.push("");
-    for (const rule of lowPriorityRules) {
-      lines.push(...formatRuleForCopilot(rule));
-    }
   }
+  lines.push(rule.content);
   return lines.join("\n");
 }
-function formatRuleForCopilot(rule) {
+
+// src/generators/cline.ts
+import { join as join2 } from "path";
+async function generateClineConfig(rules, config) {
+  const outputs = [];
+  for (const rule of rules) {
+    const content = generateClineMarkdown(rule);
+    const filepath = join2(config.outputPaths.cline, `${rule.filename}.md`);
+    outputs.push({
+      tool: "cline",
+      filepath,
+      content
+    });
+  }
+  return outputs;
+}
+function generateClineMarkdown(rule) {
   const lines = [];
-  lines.push(`### ${rule.filename}`);
-  lines.push("");
-  lines.push(`**Description:** ${rule.frontmatter.description}`);
+  lines.push(`# ${rule.frontmatter.description}`);
   lines.push("");
   if (rule.frontmatter.globs.length > 0) {
-    lines.push(`**Applies to:** ${rule.frontmatter.globs.join(", ")}`);
+    lines.push(`**Applies to files:** ${rule.frontmatter.globs.join(", ")}`);
     lines.push("");
   }
   lines.push(rule.content);
-  lines.push("");
-  return lines;
+  return lines.join("\n");
 }
 
-// src/generators/cursor.ts
+// src/generators/copilot.ts
 import { join as join3 } from "path";
-async function generateCursorConfig(rules, config) {
-  const sortedRules = rules.sort((a, b) => {
-    if (a.frontmatter.priority !== b.frontmatter.priority) {
-      return a.frontmatter.priority === "high" ? -1 : 1;
-    }
-    return a.filename.localeCompare(b.filename);
-  });
-  const content = generateCursorMarkdown(sortedRules);
-  const filepath = join3(config.outputPaths.cursor, "ai-rules.md");
-  return {
-    tool: "cursor",
-    filepath,
-    content
-  };
+async function generateCopilotConfig(rules, config) {
+  const outputs = [];
+  for (const rule of rules) {
+    const content = generateCopilotMarkdown(rule);
+    const baseFilename = rule.filename.replace(/\.md$/, "");
+    const filepath = join3(config.outputPaths.copilot, `${baseFilename}.instructions.md`);
+    outputs.push({
+      tool: "copilot",
+      filepath,
+      content
+    });
+  }
+  return outputs;
 }
-function generateCursorMarkdown(rules) {
+function generateCopilotMarkdown(rule) {
   const lines = [];
   lines.push("---");
-  lines.push("description: AI rules configuration for Cursor IDE");
-  lines.push("alwaysApply: true");
+  lines.push(`description: "${rule.frontmatter.description}"`);
+  if (rule.frontmatter.globs.length > 0) {
+    lines.push(`applyTo: "${rule.frontmatter.globs.join(", ")}"`);
+  } else {
+    lines.push('applyTo: "**"');
+  }
   lines.push("---");
   lines.push("");
-  lines.push("# Cursor IDE Rules");
-  lines.push("");
-  lines.push("These rules configure Cursor IDE's AI assistant behavior.");
-  lines.push("");
+  lines.push(rule.content);
+  return lines.join("\n");
+}
+
+// src/generators/cursor.ts
+import { join as join4 } from "path";
+async function generateCursorConfig(rules, config) {
+  const outputs = [];
   for (const rule of rules) {
-    lines.push(...formatRuleForCursor(rule));
+    const content = generateCursorMarkdown(rule);
+    const filepath = join4(config.outputPaths.cursor, `${rule.filename}.md`);
+    outputs.push({
+      tool: "cursor",
+      filepath,
+      content
+    });
   }
-  return lines.join("\n");
+  return outputs;
 }
-function formatRuleForCursor(rule) {
+function generateCursorMarkdown(rule) {
   const lines = [];
-  const priorityBadge = rule.frontmatter.priority === "high" ? "\u{1F534} HIGH" : "\u{1F7E1} STANDARD";
   lines.push("---");
   lines.push(`description: ${rule.frontmatter.description}`);
   if (rule.frontmatter.globs.length > 0) {
     lines.push(`globs: [${rule.frontmatter.globs.map((g) => `"${g}"`).join(", ")}]`);
   }
-  lines.push(`alwaysApply: ${rule.frontmatter.priority === "high"}`);
-  lines.push("---");
-  lines.push("");
-  lines.push(`## ${rule.filename} ${priorityBadge}`);
-  lines.push("");
-  lines.push(`**Priority:** ${rule.frontmatter.priority.toUpperCase()}`);
-  lines.push("");
-  if (rule.frontmatter.globs.length > 0) {
-    lines.push("**File Patterns:**");
-    for (const glob of rule.frontmatter.globs) {
-      lines.push(`- \`${glob}\``);
-    }
-    lines.push("");
+  let ruletype;
+  if (rule.frontmatter.ruleLevel === "overview") {
+    ruletype = "always";
+  } else if (rule.frontmatter.ruleLevel === "detail" && rule.frontmatter.globs.length === 0) {
+    ruletype = "agentrequested";
+  } else {
+    ruletype = "autoattached";
   }
-  lines.push("**Rule:**");
-  lines.push(rule.content);
-  lines.push("");
+  lines.push(`ruletype: ${ruletype}`);
   lines.push("---");
   lines.push("");
-  return lines;
+  lines.push(rule.content);
+  return lines.join("\n");
 }
 
 // src/utils/config.ts
@@ -202,10 +184,11 @@ function getDefaultConfig() {
     outputPaths: {
       copilot: ".github/instructions",
       cursor: ".cursor/rules",
-      cline: ".clinerules"
+      cline: ".clinerules",
+      claude: "."
     },
     watchEnabled: false,
-    defaultTargets: ["copilot", "cursor", "cline"]
+    defaultTargets: ["copilot", "cursor", "cline", "claude"]
   };
 }
 function resolveTargets(targets, config) {
@@ -216,8 +199,8 @@ function resolveTargets(targets, config) {
 }
 
 // src/utils/file.ts
-import { mkdir, readdir, readFile, stat, writeFile } from "fs/promises";
-import { dirname, join as join4 } from "path";
+import { mkdir, readdir, readFile, rm, stat, writeFile } from "fs/promises";
+import { dirname, join as join5 } from "path";
 async function ensureDir(dirPath) {
   try {
     await stat(dirPath);
@@ -235,7 +218,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) => join4(dir, file));
+    return files.filter((file) => file.endsWith(extension)).map((file) => join5(dir, file));
   } catch {
     return [];
   }
@@ -248,6 +231,15 @@ async function fileExists(filepath) {
     return false;
   }
 }
+async function removeDirectory(dirPath) {
+  try {
+    if (await fileExists(dirPath)) {
+      await rm(dirPath, { recursive: true, force: true });
+    }
+  } catch (error) {
+    console.warn(`Failed to remove directory ${dirPath}:`, error);
+  }
+}
 
 // src/core/generator.ts
 async function generateConfigurations(rules, config, targetTools) {
@@ -259,9 +251,9 @@ async function generateConfigurations(rules, config, targetTools) {
       console.warn(`No rules found for tool: ${tool}`);
       continue;
     }
-    const output = await generateForTool(tool, relevantRules, config);
-    if (output) {
-      outputs.push(output);
+    const toolOutputs = await generateForTool(tool, relevantRules, config);
+    if (toolOutputs) {
+      outputs.push(...toolOutputs);
     }
   }
   return outputs;
@@ -280,6 +272,8 @@ async function generateForTool(tool, rules, config) {
       return generateCursorConfig(rules, config);
     case "cline":
       return generateClineConfig(rules, config);
+    case "claude":
+      return await generateClaudeConfig(rules, config);
     default:
       console.warn(`Unknown tool: ${tool}`);
       return null;
@@ -320,8 +314,8 @@ function validateFrontmatter(data, filepath) {
     throw new Error(`Invalid frontmatter in ${filepath}: must be an object`);
   }
   const obj = data;
-  if (!obj.priority || !["high", "low"].includes(obj.priority)) {
-    throw new Error(`Invalid priority in ${filepath}: must be "high" or "low"`);
+  if (!obj.ruleLevel || !["overview", "detail"].includes(obj.ruleLevel)) {
+    throw new Error(`Invalid ruleLevel in ${filepath}: must be "overview" or "detail"`);
   }
   if (!Array.isArray(obj.targets)) {
     throw new Error(`Invalid targets in ${filepath}: must be an array`);
@@ -358,6 +352,10 @@ async function validateRules(rules) {
     }
     filenames.add(rule.filename);
   }
+  const overviewRules = rules.filter((rule) => rule.frontmatter.ruleLevel === "overview");
+  if (overviewRules.length > 1) {
+    errors.push(`Multiple overview rules found: ${overviewRules.map((r) => r.filename).join(", ")}. Only one overview rule is allowed.`);
+  }
   for (const rule of rules) {
     const ruleValidation = await validateRule(rule);
     errors.push(...ruleValidation.errors);
@@ -411,6 +409,33 @@ async function generateCommand(options = {}) {
     if (options.verbose) {
       console.log(`Found ${rules.length} rule(s)`);
     }
+    if (options.delete) {
+      if (options.verbose) {
+        console.log("Deleting existing output directories...");
+      }
+      const targetTools = options.tools || config.defaultTargets;
+      const deleteTasks = [];
+      for (const tool of targetTools) {
+        switch (tool) {
+          case "copilot":
+            deleteTasks.push(removeDirectory(config.outputPaths.copilot));
+            break;
+          case "cursor":
+            deleteTasks.push(removeDirectory(config.outputPaths.cursor));
+            break;
+          case "cline":
+            deleteTasks.push(removeDirectory(config.outputPaths.cline));
+            break;
+          case "claude":
+            deleteTasks.push(removeDirectory(config.outputPaths.claude));
+            break;
+        }
+      }
+      await Promise.all(deleteTasks);
+      if (options.verbose) {
+        console.log("Deleted existing output directories");
+      }
+    }
     const outputs = await generateConfigurations(rules, config, options.tools);
     if (outputs.length === 0) {
       console.warn("\u26A0\uFE0F  No configurations generated");
@@ -428,17 +453,57 @@ async function generateCommand(options = {}) {
   }
 }
 
+// src/cli/commands/gitignore.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join as join6 } from "path";
+var gitignoreCommand = async () => {
+  const gitignorePath = join6(process.cwd(), ".gitignore");
+  const rulesFilesToIgnore = [
+    "# Generated by rulesync - AI tool configuration files",
+    ".github/instructions/",
+    ".cursor/rules/",
+    ".clinerules/",
+    "CLAUDE.md"
+  ];
+  let gitignoreContent = "";
+  if (existsSync(gitignorePath)) {
+    gitignoreContent = readFileSync(gitignorePath, "utf-8");
+  }
+  const linesToAdd = [];
+  for (const rule of rulesFilesToIgnore) {
+    if (!gitignoreContent.includes(rule)) {
+      linesToAdd.push(rule);
+    }
+  }
+  if (linesToAdd.length === 0) {
+    console.log("\u2705 .gitignore\u306F\u65E2\u306B\u6700\u65B0\u3067\u3059");
+    return;
+  }
+  const newContent = gitignoreContent ? `${gitignoreContent.trimEnd()}
+
+${linesToAdd.join("\n")}
+` : `${linesToAdd.join("\n")}
+`;
+  writeFileSync(gitignorePath, newContent);
+  console.log(`\u2705 .gitignore\u306B${linesToAdd.length}\u500B\u306E\u30EB\u30FC\u30EB\u3092\u8FFD\u52A0\u3057\u307E\u3057\u305F:`);
+  for (const line of linesToAdd) {
+    if (!line.startsWith("#")) {
+      console.log(`  ${line}`);
+    }
+  }
+};
+
 // src/cli/commands/init.ts
-import { join as join5 } from "path";
+import { join as join7 } from "path";
 async function initCommand() {
   const aiRulesDir = ".rulesync";
-  console.log("Initializing ai-rules...");
+  console.log("Initializing rulesync...");
   await ensureDir(aiRulesDir);
   await createSampleFiles(aiRulesDir);
-  console.log("\u2705 ai-rules initialized successfully!");
+  console.log("\u2705 rulesync initialized successfully!");
   console.log("\nNext steps:");
   console.log("1. Edit rule files in .rulesync/");
-  console.log("2. Run 'ai-rules generate' to create configuration files");
+  console.log("2. Run 'rulesync generate' to create configuration files");
 }
 async function createSampleFiles(aiRulesDir) {
   const sampleFiles = [
@@ -519,7 +584,7 @@ globs: ["src/**/*.ts"]
     }
   ];
   for (const file of sampleFiles) {
-    const filepath = join5(aiRulesDir, file.filename);
+    const filepath = join7(aiRulesDir, file.filename);
     if (!await fileExists(filepath)) {
       await writeFileContent(filepath, file.content);
       console.log(`Created ${filepath}`);
@@ -534,10 +599,10 @@ async function statusCommand() {
   const config = getDefaultConfig();
   console.log("rulesync Status");
   console.log("===============");
-  const aiRulesExists = await fileExists(config.aiRulesDir);
+  const rulesyncExists = await fileExists(config.aiRulesDir);
   console.log(`
-\u{1F4C1} .rulesync directory: ${aiRulesExists ? "\u2705 Found" : "\u274C Not found"}`);
-  if (!aiRulesExists) {
+\u{1F4C1} .rulesync directory: ${rulesyncExists ? "\u2705 Found" : "\u274C Not found"}`);
+  if (!rulesyncExists) {
     console.log("\n\u{1F4A1} Run 'rulesync init' to get started");
     return;
   }
@@ -580,7 +645,7 @@ async function statusCommand() {
 // src/cli/commands/validate.ts
 async function validateCommand() {
   const config = getDefaultConfig();
-  console.log("Validating ai-rules configuration...");
+  console.log("Validating rulesync configuration...");
   if (!await fileExists(config.aiRulesDir)) {
     console.error("\u274C .rulesync directory not found. Run 'rulesync init' first.");
     process.exit(1);
@@ -588,7 +653,7 @@ async function validateCommand() {
   try {
     const rules = await parseRulesFromDirectory(config.aiRulesDir);
     if (rules.length === 0) {
-      console.warn("\u26A0\uFE0F  No rules found in .ai-rules directory");
+      console.warn("\u26A0\uFE0F  No rules found in .rulesync directory");
       return;
     }
     console.log(`Found ${rules.length} rule(s), validating...`);
@@ -660,22 +725,25 @@ async function watchCommand() {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("ai-rules").description("Unified AI rules management CLI tool").version("0.1.0");
-program.command("init").description("Initialize ai-rules in current directory").action(initCommand);
-program.command("generate").description("Generate configuration files for AI tools").option("--copilot", "Generate only for GitHub Copilot").option("--cursor", "Generate only for Cursor").option("--cline", "Generate only for Cline").option("-v, --verbose", "Verbose output").action(async (options) => {
+program.name("rulesync").description("Unified AI rules management CLI tool").version("0.1.0");
+program.command("init").description("Initialize rulesync in current directory").action(initCommand);
+program.command("gitignore").description("Add generated files to .gitignore").action(gitignoreCommand);
+program.command("generate").description("Generate configuration files for AI tools").option("--copilot", "Generate only for GitHub Copilot").option("--cursor", "Generate only for Cursor").option("--cline", "Generate only for Cline").option("--claude", "Generate only for Claude Code").option("--delete", "Delete all existing files in output directories before generating").option("-v, --verbose", "Verbose output").action(async (options) => {
   const tools = [];
   if (options.copilot) tools.push("copilot");
   if (options.cursor) tools.push("cursor");
   if (options.cline) tools.push("cline");
+  if (options.claude) tools.push("claude");
   const generateOptions = {
-    verbose: options.verbose
+    verbose: options.verbose,
+    delete: options.delete
   };
   if (tools.length > 0) {
     generateOptions.tools = tools;
   }
   await generateCommand(generateOptions);
 });
-program.command("validate").description("Validate ai-rules configuration").action(validateCommand);
-program.command("status").description("Show current status of ai-rules").action(statusCommand);
+program.command("validate").description("Validate rulesync configuration").action(validateCommand);
+program.command("status").description("Show current status of rulesync").action(statusCommand);
 program.command("watch").description("Watch for changes and auto-generate configurations").action(watchCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "0.2.0",
+  "version": "0.4.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",