rulesync 0.53.0 → 0.55.0

package/dist/index.js

@@ -1,39 +1,42 @@
 #!/usr/bin/env node
+import {
+  generateJunieMcp
+} from "./chunk-TJKD6LEW.js";
 import {
   generateKiroMcp
-} from "./chunk-QUJMXHNR.js";
+} from "./chunk-QVPD6ENS.js";
 import {
   generateRooMcp
-} from "./chunk-FFW6TGCM.js";
+} from "./chunk-BEPSWIZC.js";
 import {
   generateAugmentcodeMcp
-} from "./chunk-OPZOVKIL.js";
+} from "./chunk-ORNO5MOO.js";
 import {
   generateClaudeMcp
-} from "./chunk-FNL2KPM3.js";
+} from "./chunk-OY6BYYIX.js";
 import {
   generateClineMcp
-} from "./chunk-HMMTSS5E.js";
-import "./chunk-YPIFCGAP.js";
+} from "./chunk-UHANRG2O.js";
+import {
+  generateCodexMcp
+} from "./chunk-D7XQ4OHK.js";
+import "./chunk-PPAQWVXX.js";
 import {
   generateCopilotMcp
-} from "./chunk-Y2XH4E5R.js";
+} from "./chunk-OXKDEZJK.js";
 import {
   generateCursorMcp
-} from "./chunk-TTHBLXOB.js";
+} from "./chunk-3PHMFVXP.js";
 import {
   generateGeminiCliMcp
-} from "./chunk-IXCMY24P.js";
-import {
-  generateJunieMcp
-} from "./chunk-Y26DXTAT.js";
+} from "./chunk-UZCJNUXO.js";
 import {
   ALL_TOOL_TARGETS,
   RulesyncTargetsSchema,
   ToolTargetSchema,
   ToolTargetsSchema,
   isToolTarget
-} from "./chunk-USKQYIZ2.js";
+} from "./chunk-VI6SBYFB.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -53,6 +56,7 @@ function getDefaultConfig() {
       cursor: ".cursor/rules",
       cline: ".clinerules",
       claudecode: ".",
+      codexcli: ".",
       roo: ".roo/rules",
       geminicli: ".gemini/memories",
       kiro: ".kiro/steering",
@@ -139,6 +143,7 @@ var OutputPathsSchema = z3.object({
   cursor: z3.optional(z3.string()),
   cline: z3.optional(z3.string()),
   claudecode: z3.optional(z3.string()),
+  codexcli: z3.optional(z3.string()),
   roo: z3.optional(z3.string()),
   geminicli: z3.optional(z3.string()),
   kiro: z3.optional(z3.string()),
@@ -201,7 +206,8 @@ var McpServerBaseSchema = z4.object({
   alwaysAllow: z4.optional(z4.array(z4.string())),
   tools: z4.optional(z4.array(z4.string())),
   kiroAutoApprove: z4.optional(z4.array(z4.string())),
-  kiroAutoBlock: z4.optional(z4.array(z4.string()))
+  kiroAutoBlock: z4.optional(z4.array(z4.string())),
+  headers: z4.optional(z4.record(z4.string(), z4.string()))
 });
 var RulesyncMcpServerSchema = z4.extend(McpServerBaseSchema, {
   targets: z4.optional(RulesyncTargetsSchema)
@@ -429,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";
@@ -439,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");
 }
@@ -1160,6 +1199,135 @@ var ignoreConfigs = {
       }
       return augmentPatterns;
     }
+  },
+  codexcli: {
+    tool: "codexcli",
+    filename: ".codexignore",
+    header: [
+      "# Generated by rulesync - OpenAI Codex CLI ignore file",
+      "# This file controls which files are excluded from Codex CLI's AI context",
+      "# Note: .codexignore is a community-requested feature (GitHub Issue #205)",
+      "# Currently using proposed syntax based on .gitignore patterns"
+    ],
+    corePatterns: [
+      "# \u2500\u2500\u2500\u2500\u2500 Security & Credentials (Critical) \u2500\u2500\u2500\u2500\u2500",
+      "# Environment files",
+      ".env",
+      ".env.*",
+      "!.env.example",
+      "",
+      "# Private keys and certificates",
+      "*.key",
+      "*.pem",
+      "*.p12",
+      "*.pfx",
+      "*.der",
+      "*.crt",
+      "",
+      "# SSH keys",
+      "id_rsa*",
+      "id_dsa*",
+      "*.ppk",
+      "",
+      "# API keys and secrets",
+      "api-keys.json",
+      "credentials.json",
+      "secrets.json",
+      "**/apikeys/",
+      "**/*_token*",
+      "**/*_secret*",
+      "**/*api_key*",
+      "",
+      "# Cloud provider credentials",
+      "aws-credentials.json",
+      "gcp-service-account*.json",
+      "azure-credentials.json",
+      ".aws/",
+      "",
+      "# \u2500\u2500\u2500\u2500\u2500 Database & Infrastructure Secrets \u2500\u2500\u2500\u2500\u2500",
+      "# Database configuration",
+      "*.db",
+      "*.sqlite",
+      "*.sqlite3",
+      "database.yml",
+      "**/database/config.*",
+      "",
+      "# Infrastructure as Code secrets",
+      "*.tfstate",
+      "*.tfstate.*",
+      "terraform.tfvars",
+      "secrets.auto.tfvars",
+      ".terraform/",
+      "",
+      "# Kubernetes secrets",
+      "**/k8s/**/secret*.yaml",
+      "**/kubernetes/**/secret*.yaml",
+      "",
+      "# \u2500\u2500\u2500\u2500\u2500 Business Sensitive Data \u2500\u2500\u2500\u2500\u2500",
+      "# Sensitive directories",
+      "secrets/",
+      "private/",
+      "confidential/",
+      "internal-docs/",
+      "company-secrets/",
+      "",
+      "# Customer and personal data",
+      "customer-data/",
+      "pii/",
+      "personal-data/",
+      "**/*customer*.csv",
+      "**/*personal*.json",
+      "",
+      "# \u2500\u2500\u2500\u2500\u2500 Build Artifacts & Large Files \u2500\u2500\u2500\u2500\u2500",
+      "# Build outputs (may contain embedded secrets)",
+      "dist/",
+      "build/",
+      "out/",
+      ".next/",
+      ".nuxt/",
+      "",
+      "# Large files that slow down AI processing",
+      "*.zip",
+      "*.tar.gz",
+      "*.rar",
+      "**/*.{mp4,avi,mov,mkv}",
+      "**/*.{pdf,doc,docx}",
+      "",
+      "# Data files",
+      "*.csv",
+      "*.tsv",
+      "*.xlsx",
+      "data/",
+      "datasets/",
+      "",
+      "# \u2500\u2500\u2500\u2500\u2500 Development Environment \u2500\u2500\u2500\u2500\u2500",
+      "# Personal IDE settings",
+      ".vscode/settings.json",
+      ".idea/workspace.xml",
+      "",
+      "# Temporary files",
+      "*.swp",
+      "*.swo",
+      "*~",
+      "*.tmp",
+      "",
+      "# Test data with sensitive content",
+      "test-data/sensitive/",
+      "tests/fixtures/real-data/**",
+      "",
+      "# \u2500\u2500\u2500\u2500\u2500 Logs & Runtime Data \u2500\u2500\u2500\u2500\u2500",
+      "*.log",
+      "logs/",
+      ".cache/",
+      "",
+      "# \u2500\u2500\u2500\u2500\u2500 Re-include Important Files \u2500\u2500\u2500\u2500\u2500",
+      "# Allow configuration examples and documentation",
+      "!secrets/README.md",
+      "!config/*.example.*",
+      "!docs/**/*.md"
+    ],
+    includeCommonPatterns: false,
+    projectPatternsHeader: "# \u2500\u2500\u2500\u2500\u2500 Project-specific patterns from rulesync rules \u2500\u2500\u2500\u2500\u2500"
   }
 };
 
@@ -1237,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 [];
@@ -1264,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,
@@ -1282,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,
@@ -1292,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,
@@ -1301,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,
@@ -1406,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 = [];
@@ -1489,23 +1652,222 @@ async function updateClaudeSettings(settingsPath, ignorePatterns) {
   console.log(`\u2705 Updated Claude Code settings: ${settingsPath}`);
 }
 
+// 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");
+    },
+    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: (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}
+`);
+      }
+      lines.push(rule.content.trim());
+      return lines.join("\n");
+    }
+    // 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
+  }
+};
+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);
+  }
+}
+
 // 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()
-    },
-    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,
@@ -1517,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
@@ -1538,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,
@@ -1549,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
@@ -1678,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
@@ -1768,6 +2105,8 @@ async function generateForTool(tool, rules, config, baseDir) {
       return generateClineConfig(rules, config, baseDir);
     case "claudecode":
       return await generateClaudecodeConfig(rules, config, baseDir);
+    case "codexcli":
+      return generateCodexConfig(rules, config, baseDir);
     case "roo":
       return generateRooConfig(rules, config, baseDir);
     case "geminicli":
@@ -1960,6 +2299,11 @@ async function generateMcpConfigs(projectRoot, baseDir, targetTools) {
       path: path4.join(targetRoot, ".cline", "mcp.json"),
       generate: () => generateClineMcp(config)
     },
+    {
+      tool: "codexcli-project",
+      path: path4.join(targetRoot, ".codex", "mcp-config.json"),
+      generate: () => generateCodexMcp(config)
+    },
     {
       tool: "gemini-project",
       path: path4.join(targetRoot, ".gemini", "settings.json"),
@@ -1995,7 +2339,7 @@ async function generateMcpConfigs(projectRoot, baseDir, targetTools) {
     try {
       const content = generator.generate();
       const parsed = JSON.parse(content);
-      if (generator.tool.includes("augmentcode") || generator.tool.includes("claude") || generator.tool.includes("cline") || generator.tool.includes("cursor") || generator.tool.includes("gemini") || generator.tool.includes("junie") || generator.tool.includes("kiro") || generator.tool.includes("roo")) {
+      if (generator.tool.includes("augmentcode") || generator.tool.includes("claude") || generator.tool.includes("cline") || generator.tool.includes("codexcli") || generator.tool.includes("cursor") || generator.tool.includes("gemini") || generator.tool.includes("junie") || generator.tool.includes("kiro") || generator.tool.includes("roo")) {
         if (!parsed.mcpServers || Object.keys(parsed.mcpServers).length === 0) {
           results.push({
             tool: generator.tool,
@@ -2220,6 +2564,8 @@ var gitignoreCommand = async () => {
     "**/.clineignore",
     "**/CLAUDE.md",
     "**/.claude/memories/",
+    "**/codex.md",
+    "**/.codexignore",
     "**/.roo/rules/",
     "**/.rooignore",
     "**/.copilotignore",
@@ -2238,6 +2584,7 @@ var gitignoreCommand = async () => {
     "**/.cursor/mcp.json",
     "**/.cline/mcp.json",
     "**/.vscode/mcp.json",
+    "**/.codex/mcp-config.json",
     "**/.gemini/settings.json",
     "**/.roo/mcp.json"
   ];
@@ -2296,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 {
@@ -2345,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
@@ -2354,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) {
@@ -2365,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 {
@@ -2417,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: ["**/*"]
           };
         }
@@ -2451,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,
@@ -2495,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);
         }
       }
     }
@@ -2518,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 };
@@ -2529,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) {
@@ -2546,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) {
@@ -2555,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,
@@ -2600,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");
@@ -2652,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,
@@ -2695,6 +3062,9 @@ async function parseClineConfiguration(baseDir = process.cwd()) {
   });
 }
 
+// src/parsers/codexcli.ts
+import { join as join17 } from "path";
+
 // src/parsers/copilot.ts
 async function parseCopilotConfiguration(baseDir = process.cwd()) {
   return parseConfigurationFiles(baseDir, {
@@ -3430,12 +3800,12 @@ async function watchCommand() {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("rulesync").description("Unified AI rules management CLI tool").version("0.53.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);
 program.command("import").description("Import configurations from AI tools to rulesync format").option("--augmentcode", "Import from AugmentCode (.augment/rules/)").option("--augmentcode-legacy", "Import from AugmentCode legacy format (.augment-guidelines)").option("--claudecode", "Import from Claude Code (CLAUDE.md)").option("--cursor", "Import from Cursor (.cursorrules)").option("--copilot", "Import from GitHub Copilot (.github/copilot-instructions.md)").option("--cline", "Import from Cline (.cline/instructions.md)").option("--roo", "Import from Roo Code (.roo/instructions.md)").option("--geminicli", "Import from Gemini CLI (GEMINI.md)").option("--junie", "Import from JetBrains Junie (.junie/guidelines.md)").option("-v, --verbose", "Verbose output").action(importCommand);
-program.command("generate").description("Generate configuration files for AI tools").option("--augmentcode", "Generate only for AugmentCode").option("--augmentcode-legacy", "Generate only for AugmentCode legacy format").option("--copilot", "Generate only for GitHub Copilot").option("--cursor", "Generate only for Cursor").option("--cline", "Generate only for Cline").option("--claudecode", "Generate only for Claude Code").option("--roo", "Generate only for Roo Code").option("--geminicli", "Generate only for Gemini CLI").option("--junie", "Generate only for JetBrains Junie").option("--kiro", "Generate only for Kiro IDE").option("--delete", "Delete all existing files in output directories before generating").option(
+program.command("generate").description("Generate configuration files for AI tools").option("--augmentcode", "Generate only for AugmentCode").option("--augmentcode-legacy", "Generate only for AugmentCode legacy format").option("--copilot", "Generate only for GitHub Copilot").option("--cursor", "Generate only for Cursor").option("--cline", "Generate only for Cline").option("--codexcli", "Generate only for OpenAI Codex CLI").option("--claudecode", "Generate only for Claude Code").option("--roo", "Generate only for Roo Code").option("--geminicli", "Generate only for Gemini CLI").option("--junie", "Generate only for JetBrains Junie").option("--kiro", "Generate only for Kiro IDE").option("--delete", "Delete all existing files in output directories before generating").option(
   "-b, --base-dir <paths>",
   "Base directories to generate files (comma-separated for multiple paths)"
 ).option("-v, --verbose", "Verbose output").option("-c, --config <path>", "Path to configuration file").option("--no-config", "Disable configuration file loading").action(async (options) => {
@@ -3445,6 +3815,7 @@ program.command("generate").description("Generate configuration files for AI too
   if (options.copilot) tools.push("copilot");
   if (options.cursor) tools.push("cursor");
   if (options.cline) tools.push("cline");
+  if (options.codexcli) tools.push("codexcli");
   if (options.claudecode) tools.push("claudecode");
   if (options.roo) tools.push("roo");
   if (options.geminicli) tools.push("geminicli");