rulesync 0.54.0 → 0.55.0

package/dist/index.js

@@ -435,6 +435,36 @@ function mergeWithCliOptions(config, cliOptions) {
   return merged;
 }
 
+// src/utils/error.ts
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function formatErrorWithContext(error, context) {
+  const errorMessage = getErrorMessage(error);
+  return `${context}: ${errorMessage}`;
+}
+function createErrorResult(error, context) {
+  const errorMessage = context ? formatErrorWithContext(error, context) : getErrorMessage(error);
+  return {
+    success: false,
+    error: errorMessage
+  };
+}
+function createSuccessResult(result) {
+  return {
+    success: true,
+    result
+  };
+}
+async function safeAsyncOperation(operation, errorContext) {
+  try {
+    const result = await operation();
+    return createSuccessResult(result);
+  } catch (error) {
+    return createErrorResult(error, errorContext);
+  }
+}
+
 // src/utils/file.ts
 import { mkdir as mkdir2, readdir, readFile, rm, stat, writeFile as writeFile2 } from "fs/promises";
 import { dirname, join as join2 } from "path";
@@ -445,6 +475,9 @@ async function ensureDir(dirPath) {
     await mkdir2(dirPath, { recursive: true });
   }
 }
+function resolvePath(relativePath, baseDir) {
+  return baseDir ? join2(baseDir, relativePath) : relativePath;
+}
 async function readFileContent(filepath) {
   return readFile(filepath, "utf-8");
 }
@@ -1372,7 +1405,7 @@ function filterIgnoredFiles(files, ignorePatterns) {
 
 // src/generators/rules/shared-helpers.ts
 function resolveOutputDir(config, tool, baseDir) {
-  return baseDir ? join5(baseDir, config.outputPaths[tool]) : config.outputPaths[tool];
+  return resolvePath(config.outputPaths[tool], baseDir);
 }
 function createOutputsArray() {
   return [];
@@ -1399,7 +1432,7 @@ async function generateRulesConfig(rules, config, generatorConfig, baseDir) {
   }
   const ignorePatterns = await loadIgnorePatterns(baseDir);
   if (ignorePatterns.patterns.length > 0) {
-    const ignorePath = baseDir ? join5(baseDir, generatorConfig.ignoreFileName) : generatorConfig.ignoreFileName;
+    const ignorePath = resolvePath(generatorConfig.ignoreFileName, baseDir);
     const ignoreContent = generateIgnoreFile2(ignorePatterns.patterns, generatorConfig.tool);
     outputs.push({
       tool: generatorConfig.tool,
@@ -1417,7 +1450,10 @@ async function generateComplexRules(rules, config, generatorConfig, baseDir) {
   if (generatorConfig.generateDetailContent && generatorConfig.detailSubDir) {
     for (const rule of detailRules) {
       const content = generatorConfig.generateDetailContent(rule);
-      const filepath = baseDir ? join5(baseDir, generatorConfig.detailSubDir, `${rule.filename}.md`) : join5(generatorConfig.detailSubDir, `${rule.filename}.md`);
+      const filepath = resolvePath(
+        join5(generatorConfig.detailSubDir, `${rule.filename}.md`),
+        baseDir
+      );
       outputs.push({
         tool: generatorConfig.tool,
         filepath,
@@ -1427,7 +1463,7 @@ async function generateComplexRules(rules, config, generatorConfig, baseDir) {
   }
   if (generatorConfig.generateRootContent && generatorConfig.rootFilePath) {
     const rootContent = generatorConfig.generateRootContent(rootRule, detailRules, baseDir);
-    const rootFilepath = baseDir ? join5(baseDir, generatorConfig.rootFilePath) : generatorConfig.rootFilePath;
+    const rootFilepath = resolvePath(generatorConfig.rootFilePath, baseDir);
     outputs.push({
       tool: generatorConfig.tool,
       filepath: rootFilepath,
@@ -1436,7 +1472,7 @@ async function generateComplexRules(rules, config, generatorConfig, baseDir) {
   }
   const ignorePatterns = await loadIgnorePatterns(baseDir);
   if (ignorePatterns.patterns.length > 0) {
-    const ignorePath = baseDir ? join5(baseDir, generatorConfig.ignoreFileName) : generatorConfig.ignoreFileName;
+    const ignorePath = resolvePath(generatorConfig.ignoreFileName, baseDir);
     const ignoreContent = generateIgnoreFile2(ignorePatterns.patterns, generatorConfig.tool);
     outputs.push({
       tool: generatorConfig.tool,
@@ -1541,30 +1577,22 @@ function generateLegacyGuidelinesFile(allRules) {
 // src/generators/rules/claudecode.ts
 import { join as join7 } from "path";
 async function generateClaudecodeConfig(rules, config, baseDir) {
-  const outputs = [];
-  const rootRules = rules.filter((r) => r.frontmatter.root === true);
-  const detailRules = rules.filter((r) => r.frontmatter.root === false);
-  const claudeMdContent = generateClaudeMarkdown(rootRules, detailRules);
-  const claudeOutputDir = baseDir ? join7(baseDir, config.outputPaths.claudecode) : config.outputPaths.claudecode;
-  outputs.push({
+  const generatorConfig = {
     tool: "claudecode",
-    filepath: join7(claudeOutputDir, "CLAUDE.md"),
-    content: claudeMdContent
-  });
-  for (const rule of detailRules) {
-    const memoryContent = generateMemoryFile(rule);
-    outputs.push({
-      tool: "claudecode",
-      filepath: join7(claudeOutputDir, ".claude", "memories", `${rule.filename}.md`),
-      content: memoryContent
-    });
-  }
-  const ignorePatterns = await loadIgnorePatterns(baseDir);
-  if (ignorePatterns.patterns.length > 0) {
-    const settingsPath = baseDir ? join7(baseDir, ".claude", "settings.json") : join7(".claude", "settings.json");
-    await updateClaudeSettings(settingsPath, ignorePatterns.patterns);
-  }
-  return outputs;
+    fileExtension: ".md",
+    ignoreFileName: ".aiignore",
+    generateContent: generateMemoryFile,
+    generateRootContent: (rootRule, detailRules) => generateClaudeMarkdown(rootRule ? [rootRule] : [], detailRules),
+    rootFilePath: "CLAUDE.md",
+    generateDetailContent: generateMemoryFile,
+    detailSubDir: ".claude/memories",
+    updateAdditionalConfig: async (ignorePatterns, baseDir2) => {
+      const settingsPath = resolvePath(join7(".claude", "settings.json"), baseDir2);
+      await updateClaudeSettings(settingsPath, ignorePatterns);
+      return [];
+    }
+  };
+  return generateComplexRules(rules, config, generatorConfig, baseDir);
 }
 function generateClaudeMarkdown(rootRules, detailRules) {
   const lines = [];
@@ -1624,54 +1652,222 @@ async function updateClaudeSettings(settingsPath, ignorePatterns) {
   console.log(`\u2705 Updated Claude Code settings: ${settingsPath}`);
 }
 
-// src/generators/rules/cline.ts
-async function generateClineConfig(rules, config, baseDir) {
-  return generateRulesConfig(
-    rules,
-    config,
-    {
-      tool: "cline",
-      fileExtension: ".md",
-      ignoreFileName: ".clineignore",
-      generateContent: (rule) => rule.content.trim()
+// src/generators/rules/generator-registry.ts
+import { join as join8 } from "path";
+var GENERATOR_REGISTRY = {
+  // Simple generators - generate one file per rule
+  cline: {
+    type: "simple",
+    tool: "cline",
+    fileExtension: ".md",
+    ignoreFileName: ".clineignore",
+    generateContent: (rule) => rule.content.trim()
+  },
+  roo: {
+    type: "simple",
+    tool: "roo",
+    fileExtension: ".md",
+    ignoreFileName: ".rooignore",
+    generateContent: (rule) => rule.content.trim()
+  },
+  kiro: {
+    type: "simple",
+    tool: "kiro",
+    fileExtension: ".md",
+    ignoreFileName: ".kiroignore",
+    generateContent: (rule) => rule.content.trim()
+  },
+  augmentcode: {
+    type: "simple",
+    tool: "augmentcode",
+    fileExtension: ".md",
+    ignoreFileName: ".aiignore",
+    generateContent: (rule) => rule.content.trim()
+  },
+  "augmentcode-legacy": {
+    type: "simple",
+    tool: "augmentcode-legacy",
+    fileExtension: ".md",
+    ignoreFileName: ".aiignore",
+    generateContent: (rule) => rule.content.trim()
+  },
+  // Complex generators with custom content formatting
+  copilot: {
+    type: "simple",
+    tool: "copilot",
+    fileExtension: ".instructions.md",
+    ignoreFileName: ".copilotignore",
+    generateContent: (rule) => {
+      const lines = [];
+      lines.push("---");
+      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(rule.content);
+      return lines.join("\n");
     },
-    baseDir
-  );
-}
-
-// src/generators/rules/codexcli.ts
-async function generateCodexConfig(rules, config, baseDir) {
-  const generatorConfig = {
+    pathResolver: (rule, outputDir) => {
+      const baseFilename = rule.filename.replace(/\.md$/, "");
+      return join8(outputDir, `${baseFilename}.instructions.md`);
+    }
+  },
+  cursor: {
+    type: "simple",
+    tool: "cursor",
+    fileExtension: ".md",
+    ignoreFileName: ".cursorignore",
+    generateContent: (rule) => rule.content.trim()
+  },
+  codexcli: {
+    type: "simple",
     tool: "codexcli",
     fileExtension: ".md",
     ignoreFileName: ".codexignore",
-    generateContent: generateCodexInstructionsMarkdown,
-    pathResolver: (rule, outputDir) => {
-      if (rule.frontmatter.root === true) {
-        return `${outputDir}/codex.md`;
+    generateContent: (rule) => rule.content.trim()
+  },
+  // Complex generators with root + detail pattern
+  claudecode: {
+    type: "complex",
+    tool: "claudecode",
+    fileExtension: ".md",
+    ignoreFileName: ".aiignore",
+    generateContent: (rule) => {
+      const lines = [];
+      if (rule.frontmatter.description) {
+        lines.push(`# ${rule.frontmatter.description}
+`);
       }
-      return `${outputDir}/${rule.filename}.md`;
+      lines.push(rule.content.trim());
+      return lines.join("\n");
     }
-  };
-  return generateRulesConfig(rules, config, generatorConfig, baseDir);
-}
-function generateCodexInstructionsMarkdown(rule) {
-  const lines = [];
-  if (rule.frontmatter.root === false && rule.frontmatter.description && rule.frontmatter.description !== "Main instructions" && !rule.frontmatter.description.includes("Project-level Codex CLI instructions")) {
-    lines.push(`<!-- ${rule.frontmatter.description} -->`);
-    if (rule.content.trim()) {
-      lines.push("");
+    // NOTE: Claude Code specific logic is handled in the actual generator file
+    // due to complex settings.json manipulation requirements
+  },
+  geminicli: {
+    type: "complex",
+    tool: "geminicli",
+    fileExtension: ".md",
+    ignoreFileName: ".aiexclude",
+    generateContent: (rule) => {
+      const lines = [];
+      if (rule.frontmatter.description) {
+        lines.push(`# ${rule.frontmatter.description}
+`);
+      }
+      lines.push(rule.content.trim());
+      return lines.join("\n");
+    }
+    // Complex generation handled by existing generator
+  },
+  junie: {
+    type: "complex",
+    tool: "junie",
+    fileExtension: ".md",
+    ignoreFileName: ".aiignore",
+    generateContent: (rule) => {
+      const lines = [];
+      if (rule.frontmatter.description) {
+        lines.push(`# ${rule.frontmatter.description}
+`);
+      }
+      lines.push(rule.content.trim());
+      return lines.join("\n");
     }
+    // Complex generation handled by existing generator
   }
-  const content = rule.content.trim();
-  if (content) {
-    lines.push(content);
+};
+async function generateFromRegistry(tool, rules, config, baseDir) {
+  const generatorConfig = GENERATOR_REGISTRY[tool];
+  if (!generatorConfig) {
+    throw new Error(`No generator configuration found for tool: ${tool}`);
+  }
+  if (generatorConfig.type === "simple") {
+    const ruleConfig = {
+      tool: generatorConfig.tool,
+      fileExtension: generatorConfig.fileExtension,
+      ignoreFileName: generatorConfig.ignoreFileName,
+      generateContent: generatorConfig.generateContent,
+      ...generatorConfig.pathResolver && { pathResolver: generatorConfig.pathResolver }
+    };
+    return generateRulesConfig(rules, config, ruleConfig, baseDir);
+  } else {
+    const enhancedConfig = {
+      tool: generatorConfig.tool,
+      fileExtension: generatorConfig.fileExtension,
+      ignoreFileName: generatorConfig.ignoreFileName,
+      generateContent: generatorConfig.generateContent,
+      ...generatorConfig.generateRootContent && {
+        generateRootContent: generatorConfig.generateRootContent
+      },
+      ...generatorConfig.rootFilePath && { rootFilePath: generatorConfig.rootFilePath },
+      ...generatorConfig.generateDetailContent && {
+        generateDetailContent: generatorConfig.generateDetailContent
+      },
+      ...generatorConfig.detailSubDir && { detailSubDir: generatorConfig.detailSubDir },
+      ...generatorConfig.updateAdditionalConfig && {
+        updateAdditionalConfig: generatorConfig.updateAdditionalConfig
+      }
+    };
+    return generateComplexRules(rules, config, enhancedConfig, baseDir);
   }
-  return lines.join("\n");
+}
+
+// src/generators/rules/cline.ts
+async function generateClineConfig(rules, config, baseDir) {
+  return generateFromRegistry("cline", rules, config, baseDir);
+}
+
+// src/generators/rules/codexcli.ts
+async function generateCodexConfig(rules, config, baseDir) {
+  const outputs = [];
+  if (rules.length === 0) {
+    return outputs;
+  }
+  const sortedRules = [...rules].sort((a, b) => {
+    if (a.frontmatter.root === true && b.frontmatter.root !== true) return -1;
+    if (a.frontmatter.root !== true && b.frontmatter.root === true) return 1;
+    return 0;
+  });
+  const concatenatedContent = generateConcatenatedCodexContent(sortedRules);
+  if (concatenatedContent.trim()) {
+    const outputDir = resolveOutputDir(config, "codexcli", baseDir);
+    const filepath = `${outputDir}/codex.md`;
+    outputs.push({
+      tool: "codexcli",
+      filepath,
+      content: concatenatedContent
+    });
+  }
+  const ignorePatterns = await loadIgnorePatterns(baseDir);
+  if (ignorePatterns.patterns.length > 0) {
+    const ignorePath = resolvePath(".codexignore", baseDir);
+    const ignoreContent = generateIgnoreFile2(ignorePatterns.patterns, "codexcli");
+    outputs.push({
+      tool: "codexcli",
+      filepath: ignorePath,
+      content: ignoreContent
+    });
+  }
+  return outputs;
+}
+function generateConcatenatedCodexContent(rules) {
+  const sections = [];
+  for (const rule of rules) {
+    const content = rule.content.trim();
+    if (!content) {
+      continue;
+    }
+    sections.push(content);
+  }
+  return sections.join("\n\n---\n\n");
 }
 
 // src/generators/rules/copilot.ts
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 async function generateCopilotConfig(rules, config, baseDir) {
   return generateComplexRulesConfig(
     rules,
@@ -1683,7 +1879,7 @@ async function generateCopilotConfig(rules, config, baseDir) {
       generateContent: generateCopilotMarkdown,
       getOutputPath: (rule, outputDir) => {
         const baseFilename = rule.filename.replace(/\.md$/, "");
-        return join8(outputDir, `${baseFilename}.instructions.md`);
+        return join9(outputDir, `${baseFilename}.instructions.md`);
       }
     },
     baseDir
@@ -1704,7 +1900,7 @@ function generateCopilotMarkdown(rule) {
 }
 
 // src/generators/rules/cursor.ts
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 async function generateCursorConfig(rules, config, baseDir) {
   return generateComplexRulesConfig(
     rules,
@@ -1715,7 +1911,7 @@ async function generateCursorConfig(rules, config, baseDir) {
       ignoreFileName: ".cursorignore",
       generateContent: generateCursorMarkdown,
       getOutputPath: (rule, outputDir) => {
-        return join9(outputDir, `${rule.filename}.mdc`);
+        return join10(outputDir, `${rule.filename}.mdc`);
       }
     },
     baseDir
@@ -1844,38 +2040,13 @@ function generateGuidelinesMarkdown(rootRule, detailRules) {
 }
 
 // src/generators/rules/kiro.ts
-import { join as join10 } from "path";
 async function generateKiroConfig(rules, config, baseDir) {
-  const outputs = [];
-  for (const rule of rules) {
-    const content = generateKiroMarkdown(rule);
-    const outputDir = baseDir ? join10(baseDir, config.outputPaths.kiro) : config.outputPaths.kiro;
-    const filepath = join10(outputDir, `${rule.filename}.md`);
-    outputs.push({
-      tool: "kiro",
-      filepath,
-      content
-    });
-  }
-  return outputs;
-}
-function generateKiroMarkdown(rule) {
-  return rule.content.trim();
+  return generateFromRegistry("kiro", rules, config, baseDir);
 }
 
 // src/generators/rules/roo.ts
 async function generateRooConfig(rules, config, baseDir) {
-  return generateRulesConfig(
-    rules,
-    config,
-    {
-      tool: "roo",
-      fileExtension: ".md",
-      ignoreFileName: ".rooignore",
-      generateContent: (rule) => rule.content.trim()
-    },
-    baseDir
-  );
+  return generateFromRegistry("roo", rules, config, baseDir);
 }
 
 // src/core/generator.ts
@@ -2446,7 +2617,7 @@ ${linesToAdd.join("\n")}
 };
 
 // src/core/importer.ts
-import { join as join21 } from "path";
+import { join as join20 } from "path";
 import matter5 from "gray-matter";
 
 // src/parsers/augmentcode.ts
@@ -2472,36 +2643,63 @@ function addRules(result, rules) {
   }
   result.rules.push(...rules);
 }
-function handleParseError(error, context) {
-  const errorMessage = error instanceof Error ? error.message : String(error);
-  return `${context}: ${errorMessage}`;
-}
 async function safeReadFile(operation, errorContext) {
   try {
     const result = await operation();
-    return { success: true, result };
+    return createSuccessResult(result);
   } catch (error) {
-    return {
-      success: false,
-      error: handleParseError(error, errorContext)
-    };
+    return createErrorResult(error, errorContext);
   }
 }
 
 // src/parsers/augmentcode.ts
 async function parseAugmentcodeConfiguration(baseDir = process.cwd()) {
+  return parseUnifiedAugmentcode(baseDir, {
+    rulesDir: ".augment/rules",
+    targetName: "augmentcode",
+    filenamePrefix: "augmentcode"
+  });
+}
+async function parseAugmentcodeLegacyConfiguration(baseDir = process.cwd()) {
+  return parseUnifiedAugmentcode(baseDir, {
+    legacyFilePath: ".augment-guidelines",
+    targetName: "augmentcode-legacy",
+    filenamePrefix: "augmentcode-legacy"
+  });
+}
+async function parseUnifiedAugmentcode(baseDir, config) {
   const result = createParseResult();
-  const rulesDir = join15(baseDir, ".augment", "rules");
-  if (await fileExists(rulesDir)) {
-    const rulesResult = await parseAugmentRules(rulesDir);
-    addRules(result, rulesResult.rules);
-    result.errors.push(...rulesResult.errors);
-  } else {
-    addError(result, "No AugmentCode configuration found. Expected .augment/rules/ directory.");
+  if (config.rulesDir) {
+    const rulesDir = join15(baseDir, config.rulesDir);
+    if (await fileExists(rulesDir)) {
+      const rulesResult = await parseAugmentRules(rulesDir, config);
+      addRules(result, rulesResult.rules);
+      result.errors.push(...rulesResult.errors);
+    } else {
+      addError(
+        result,
+        `No AugmentCode configuration found. Expected ${config.rulesDir} directory.`
+      );
+    }
+  }
+  if (config.legacyFilePath) {
+    const legacyPath = join15(baseDir, config.legacyFilePath);
+    if (await fileExists(legacyPath)) {
+      const legacyResult = await parseAugmentGuidelines(legacyPath, config);
+      if (legacyResult.rule) {
+        addRule(result, legacyResult.rule);
+      }
+      result.errors.push(...legacyResult.errors);
+    } else {
+      addError(
+        result,
+        `No AugmentCode legacy configuration found. Expected ${config.legacyFilePath} file.`
+      );
+    }
   }
   return { rules: result.rules || [], errors: result.errors };
 }
-async function parseAugmentRules(rulesDir) {
+async function parseAugmentRules(rulesDir, config) {
   const rules = [];
   const errors = [];
   try {
@@ -2521,7 +2719,7 @@ async function parseAugmentRules(rulesDir) {
           const filename = basename2(file, file.endsWith(".mdc") ? ".mdc" : ".md");
           const frontmatter = {
             root: isRoot,
-            targets: ["augmentcode"],
+            targets: [config.targetName],
             description,
             globs: ["**/*"],
             // AugmentCode doesn't use specific globs in the same way
@@ -2530,7 +2728,7 @@ async function parseAugmentRules(rulesDir) {
           rules.push({
             frontmatter,
             content: parsed.content.trim(),
-            filename: `augmentcode-${ruleType}-${filename}`,
+            filename: `${config.filenamePrefix}-${ruleType}-${filename}`,
             filepath: filePath
           });
         } catch (error) {
@@ -2541,50 +2739,33 @@ async function parseAugmentRules(rulesDir) {
     }
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
-    errors.push(`Failed to read .augment/rules/ directory: ${errorMessage}`);
+    errors.push(`Failed to read ${config.rulesDir || rulesDir} directory: ${errorMessage}`);
   }
   return { rules, errors };
 }
-
-// src/parsers/augmentcode-legacy.ts
-import { join as join16 } from "path";
-async function parseAugmentcodeLegacyConfiguration(baseDir = process.cwd()) {
-  const result = createParseResult();
-  const guidelinesPath = join16(baseDir, ".augment-guidelines");
-  if (await fileExists(guidelinesPath)) {
-    const guidelinesResult = await parseAugmentGuidelines(guidelinesPath);
-    if (guidelinesResult.rule) {
-      addRule(result, guidelinesResult.rule);
-    }
-    result.errors.push(...guidelinesResult.errors);
-  } else {
-    addError(
-      result,
-      "No AugmentCode legacy configuration found. Expected .augment-guidelines file."
-    );
-  }
-  return { rules: result.rules || [], errors: result.errors };
-}
-async function parseAugmentGuidelines(guidelinesPath) {
-  const parseResult = await safeReadFile(async () => {
-    const content = await readFileContent(guidelinesPath);
-    if (content.trim()) {
-      const frontmatter = {
-        root: true,
-        // Legacy guidelines become root rules
-        targets: ["augmentcode-legacy"],
-        description: "Legacy AugmentCode guidelines",
-        globs: ["**/*"]
-      };
-      return {
-        frontmatter,
-        content: content.trim(),
-        filename: "augmentcode-legacy-guidelines",
-        filepath: guidelinesPath
-      };
-    }
-    return null;
-  }, "Failed to parse .augment-guidelines");
+async function parseAugmentGuidelines(guidelinesPath, config) {
+  const parseResult = await safeReadFile(
+    async () => {
+      const content = await readFileContent(guidelinesPath);
+      if (content.trim()) {
+        const frontmatter = {
+          root: true,
+          // Legacy guidelines become root rules
+          targets: [config.targetName],
+          description: "Legacy AugmentCode guidelines",
+          globs: ["**/*"]
+        };
+        return {
+          frontmatter,
+          content: content.trim(),
+          filename: `${config.filenamePrefix}-guidelines`,
+          filepath: guidelinesPath
+        };
+      }
+      return null;
+    },
+    `Failed to parse ${config.legacyFilePath || guidelinesPath}`
+  );
   if (parseResult.success) {
     return { rule: parseResult.result || null, errors: [] };
   } else {
@@ -2593,33 +2774,36 @@ async function parseAugmentGuidelines(guidelinesPath) {
 }
 
 // src/parsers/shared-helpers.ts
-import { basename as basename3, join as join17 } from "path";
+import { basename as basename3, join as join16 } from "path";
 import matter3 from "gray-matter";
 async function parseConfigurationFiles(baseDir = process.cwd(), config) {
   const errors = [];
   const rules = [];
   if (config.mainFile) {
-    const mainFilePath = join17(baseDir, config.mainFile.path);
+    const mainFile = config.mainFile;
+    const mainFilePath = resolvePath(mainFile.path, baseDir);
     if (await fileExists(mainFilePath)) {
-      try {
+      const result = await safeAsyncOperation(async () => {
         const rawContent = await readFileContent(mainFilePath);
         let content;
         let frontmatter;
-        if (config.mainFile.useFrontmatter) {
+        if (mainFile.useFrontmatter) {
           const parsed = matter3(rawContent);
           content = parsed.content.trim();
+          const parsedFrontmatter = parsed.data;
           frontmatter = {
-            root: false,
+            root: mainFile.isRoot ?? false,
             targets: [config.tool],
-            description: config.mainFile.description,
-            globs: ["**/*"]
+            description: parsedFrontmatter.description || mainFile.description,
+            globs: Array.isArray(parsedFrontmatter.globs) ? parsedFrontmatter.globs : ["**/*"],
+            ...parsedFrontmatter.tags && { tags: parsedFrontmatter.tags }
           };
         } else {
           content = rawContent.trim();
           frontmatter = {
-            root: false,
+            root: mainFile.isRoot ?? false,
             targets: [config.tool],
-            description: config.mainFile.description,
+            description: mainFile.description,
             globs: ["**/*"]
           };
         }
@@ -2627,43 +2811,52 @@ async function parseConfigurationFiles(baseDir = process.cwd(), config) {
           rules.push({
             frontmatter,
             content,
-            filename: "instructions",
+            filename: mainFile.filenameOverride || "instructions",
             filepath: mainFilePath
           });
         }
-      } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        errors.push(`Failed to parse ${config.mainFile.path}: ${errorMessage}`);
+      }, `Failed to parse ${mainFile.path}`);
+      if (!result.success) {
+        errors.push(result.error);
       }
     }
   }
   if (config.directories) {
     for (const dirConfig of config.directories) {
-      const dirPath = join17(baseDir, dirConfig.directory);
+      const dirPath = resolvePath(dirConfig.directory, baseDir);
       if (await fileExists(dirPath)) {
-        try {
+        const result = await safeAsyncOperation(async () => {
           const { readdir: readdir2 } = await import("fs/promises");
           const files = await readdir2(dirPath);
           for (const file of files) {
             if (file.endsWith(dirConfig.filePattern)) {
-              const filePath = join17(dirPath, file);
-              try {
+              const filePath = join16(dirPath, file);
+              const fileResult = await safeAsyncOperation(async () => {
                 const rawContent = await readFileContent(filePath);
                 let content;
+                let frontmatter;
+                const filename = file.replace(new RegExp(`\\${dirConfig.filePattern}$`), "");
                 if (dirConfig.filePattern === ".instructions.md") {
                   const parsed = matter3(rawContent);
                   content = parsed.content.trim();
+                  const parsedFrontmatter = parsed.data;
+                  frontmatter = {
+                    root: false,
+                    targets: [config.tool],
+                    description: parsedFrontmatter.description || `${dirConfig.description}: ${filename}`,
+                    globs: Array.isArray(parsedFrontmatter.globs) ? parsedFrontmatter.globs : ["**/*"],
+                    ...parsedFrontmatter.tags && { tags: parsedFrontmatter.tags }
+                  };
                 } else {
                   content = rawContent.trim();
-                }
-                if (content) {
-                  const filename = file.replace(new RegExp(`\\${dirConfig.filePattern}$`), "");
-                  const frontmatter = {
+                  frontmatter = {
                     root: false,
                     targets: [config.tool],
                     description: `${dirConfig.description}: ${filename}`,
                     globs: ["**/*"]
                   };
+                }
+                if (content) {
                   rules.push({
                     frontmatter,
                     content,
@@ -2671,15 +2864,15 @@ async function parseConfigurationFiles(baseDir = process.cwd(), config) {
                     filepath: filePath
                   });
                 }
-              } catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                errors.push(`Failed to parse ${filePath}: ${errorMessage}`);
+              }, `Failed to parse ${filePath}`);
+              if (!fileResult.success) {
+                errors.push(fileResult.error);
               }
             }
           }
-        } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : String(error);
-          errors.push(`Failed to parse ${dirConfig.directory} files: ${errorMessage}`);
+        }, `Failed to parse ${dirConfig.directory} files`);
+        if (!result.success) {
+          errors.push(result.error);
         }
       }
     }
@@ -2694,7 +2887,7 @@ async function parseMemoryBasedConfiguration(baseDir = process.cwd(), config) {
   const rules = [];
   let ignorePatterns;
   let mcpServers;
-  const mainFilePath = join17(baseDir, config.mainFileName);
+  const mainFilePath = resolvePath(config.mainFileName, baseDir);
   if (!await fileExists(mainFilePath)) {
     errors.push(`${config.mainFileName} file not found`);
     return { rules, errors };
@@ -2705,12 +2898,12 @@ async function parseMemoryBasedConfiguration(baseDir = process.cwd(), config) {
     if (mainRule) {
       rules.push(mainRule);
     }
-    const memoryDir = join17(baseDir, config.memoryDirPath);
+    const memoryDir = resolvePath(config.memoryDirPath, baseDir);
     if (await fileExists(memoryDir)) {
       const memoryRules = await parseMemoryFiles(memoryDir, config);
       rules.push(...memoryRules);
     }
-    const settingsPath = join17(baseDir, config.settingsPath);
+    const settingsPath = resolvePath(config.settingsPath, baseDir);
     if (await fileExists(settingsPath)) {
       const settingsResult = await parseSettingsFile(settingsPath, config.tool);
       if (settingsResult.ignorePatterns) {
@@ -2722,7 +2915,7 @@ async function parseMemoryBasedConfiguration(baseDir = process.cwd(), config) {
       errors.push(...settingsResult.errors);
     }
     if (config.additionalIgnoreFile) {
-      const additionalIgnorePath = join17(baseDir, config.additionalIgnoreFile.path);
+      const additionalIgnorePath = resolvePath(config.additionalIgnoreFile.path, baseDir);
       if (await fileExists(additionalIgnorePath)) {
         const additionalPatterns = await config.additionalIgnoreFile.parser(additionalIgnorePath);
         if (additionalPatterns.length > 0) {
@@ -2731,8 +2924,7 @@ async function parseMemoryBasedConfiguration(baseDir = process.cwd(), config) {
       }
     }
   } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    errors.push(`Failed to parse ${config.tool} configuration: ${errorMessage}`);
+    errors.push(`Failed to parse ${config.tool} configuration: ${getErrorMessage(error)}`);
   }
   return {
     rules,
@@ -2776,7 +2968,7 @@ async function parseMemoryFiles(memoryDir, config) {
     const files = await readdir2(memoryDir);
     for (const file of files) {
       if (file.endsWith(".md")) {
-        const filePath = join17(memoryDir, file);
+        const filePath = join16(memoryDir, file);
         const content = await readFileContent(filePath);
         if (content.trim()) {
           const filename = basename3(file, ".md");
@@ -2828,8 +3020,7 @@ async function parseSettingsFile(settingsPath, tool) {
       mcpServers = parseResult.data.mcpServers;
     }
   } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    errors.push(`Failed to parse settings.json: ${errorMessage}`);
+    errors.push(`Failed to parse settings.json: ${getErrorMessage(error)}`);
   }
   return {
     errors,
@@ -2872,7 +3063,7 @@ async function parseClineConfiguration(baseDir = process.cwd()) {
 }
 
 // src/parsers/codexcli.ts
-import { join as join18 } from "path";
+import { join as join17 } from "path";
 
 // src/parsers/copilot.ts
 async function parseCopilotConfiguration(baseDir = process.cwd()) {
@@ -2895,7 +3086,7 @@ async function parseCopilotConfiguration(baseDir = process.cwd()) {
 }
 
 // src/parsers/cursor.ts
-import { basename as basename4, join as join19 } from "path";
+import { basename as basename4, join as join18 } from "path";
 import matter4 from "gray-matter";
 import { DEFAULT_SCHEMA, FAILSAFE_SCHEMA, load } from "js-yaml";
 import { z as z6 } from "zod/mini";
@@ -3020,7 +3211,7 @@ async function parseCursorConfiguration(baseDir = process.cwd()) {
   const rules = [];
   let ignorePatterns;
   let mcpServers;
-  const cursorFilePath = join19(baseDir, ".cursorrules");
+  const cursorFilePath = join18(baseDir, ".cursorrules");
   if (await fileExists(cursorFilePath)) {
     try {
       const rawContent = await readFileContent(cursorFilePath);
@@ -3041,14 +3232,14 @@ async function parseCursorConfiguration(baseDir = process.cwd()) {
       errors.push(`Failed to parse .cursorrules file: ${errorMessage}`);
     }
   }
-  const cursorRulesDir = join19(baseDir, ".cursor", "rules");
+  const cursorRulesDir = join18(baseDir, ".cursor", "rules");
   if (await fileExists(cursorRulesDir)) {
     try {
       const { readdir: readdir2 } = await import("fs/promises");
       const files = await readdir2(cursorRulesDir);
       for (const file of files) {
         if (file.endsWith(".mdc")) {
-          const filePath = join19(cursorRulesDir, file);
+          const filePath = join18(cursorRulesDir, file);
           try {
             const rawContent = await readFileContent(filePath);
             const parsed = matter4(rawContent, customMatterOptions);
@@ -3077,7 +3268,7 @@ async function parseCursorConfiguration(baseDir = process.cwd()) {
   if (rules.length === 0) {
     errors.push("No Cursor configuration files found (.cursorrules or .cursor/rules/*.mdc)");
   }
-  const cursorIgnorePath = join19(baseDir, ".cursorignore");
+  const cursorIgnorePath = join18(baseDir, ".cursorignore");
   if (await fileExists(cursorIgnorePath)) {
     try {
       const content = await readFileContent(cursorIgnorePath);
@@ -3090,7 +3281,7 @@ async function parseCursorConfiguration(baseDir = process.cwd()) {
       errors.push(`Failed to parse .cursorignore: ${errorMessage}`);
     }
   }
-  const cursorMcpPath = join19(baseDir, ".cursor", "mcp.json");
+  const cursorMcpPath = join18(baseDir, ".cursor", "mcp.json");
   if (await fileExists(cursorMcpPath)) {
     try {
       const content = await readFileContent(cursorMcpPath);
@@ -3139,11 +3330,11 @@ async function parseGeminiConfiguration(baseDir = process.cwd()) {
 }
 
 // src/parsers/junie.ts
-import { join as join20 } from "path";
+import { join as join19 } from "path";
 async function parseJunieConfiguration(baseDir = process.cwd()) {
   const errors = [];
   const rules = [];
-  const guidelinesPath = join20(baseDir, ".junie", "guidelines.md");
+  const guidelinesPath = join19(baseDir, ".junie", "guidelines.md");
   if (!await fileExists(guidelinesPath)) {
     errors.push(".junie/guidelines.md file not found");
     return { rules, errors };
@@ -3278,7 +3469,7 @@ async function importConfiguration(options) {
   if (rules.length === 0 && !ignorePatterns && !mcpServers) {
     return { success: false, rulesCreated: 0, errors };
   }
-  const rulesDirPath = join21(baseDir, rulesDir);
+  const rulesDirPath = join20(baseDir, rulesDir);
   try {
     const { mkdir: mkdir3 } = await import("fs/promises");
     await mkdir3(rulesDirPath, { recursive: true });
@@ -3292,7 +3483,7 @@ async function importConfiguration(options) {
     try {
       const baseFilename = rule.filename;
       const filename = await generateUniqueFilename(rulesDirPath, baseFilename);
-      const filePath = join21(rulesDirPath, `${filename}.md`);
+      const filePath = join20(rulesDirPath, `${filename}.md`);
       const content = generateRuleFileContent(rule);
       await writeFileContent(filePath, content);
       rulesCreated++;
@@ -3307,7 +3498,7 @@ async function importConfiguration(options) {
   let ignoreFileCreated = false;
   if (ignorePatterns && ignorePatterns.length > 0) {
     try {
-      const rulesyncignorePath = join21(baseDir, ".rulesyncignore");
+      const rulesyncignorePath = join20(baseDir, ".rulesyncignore");
       const ignoreContent = `${ignorePatterns.join("\n")}
 `;
       await writeFileContent(rulesyncignorePath, ignoreContent);
@@ -3323,7 +3514,7 @@ async function importConfiguration(options) {
   let mcpFileCreated = false;
   if (mcpServers && Object.keys(mcpServers).length > 0) {
     try {
-      const mcpPath = join21(baseDir, rulesDir, ".mcp.json");
+      const mcpPath = join20(baseDir, rulesDir, ".mcp.json");
       const mcpContent = `${JSON.stringify({ mcpServers }, null, 2)}
 `;
       await writeFileContent(mcpPath, mcpContent);
@@ -3351,7 +3542,7 @@ function generateRuleFileContent(rule) {
 async function generateUniqueFilename(rulesDir, baseFilename) {
   let filename = baseFilename;
   let counter = 1;
-  while (await fileExists(join21(rulesDir, `${filename}.md`))) {
+  while (await fileExists(join20(rulesDir, `${filename}.md`))) {
     filename = `${baseFilename}-${counter}`;
     counter++;
   }
@@ -3418,7 +3609,7 @@ async function importCommand(options = {}) {
 }
 
 // src/cli/commands/init.ts
-import { join as join22 } from "path";
+import { join as join21 } from "path";
 async function initCommand() {
   const aiRulesDir = ".rulesync";
   console.log("Initializing rulesync...");
@@ -3465,7 +3656,7 @@ globs: ["**/*"]
 - Follow single responsibility principle
 `
   };
-  const filepath = join22(aiRulesDir, sampleFile.filename);
+  const filepath = join21(aiRulesDir, sampleFile.filename);
   if (!await fileExists(filepath)) {
     await writeFileContent(filepath, sampleFile.content);
     console.log(`Created ${filepath}`);
@@ -3609,7 +3800,7 @@ async function watchCommand() {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("rulesync").description("Unified AI rules management CLI tool").version("0.54.0");
+program.name("rulesync").description("Unified AI rules management CLI tool").version("0.55.0");
 program.command("init").description("Initialize rulesync in current directory").action(initCommand);
 program.command("add <filename>").description("Add a new rule file").action(addCommand);
 program.command("gitignore").description("Add generated files to .gitignore").action(gitignoreCommand);