rulesync 0.53.0 → 0.55.0

package/dist/index.cjs

@@ -43,6 +43,7 @@ var init_tool_targets = __esm({
       "cursor",
       "cline",
       "claudecode",
+      "codexcli",
       "roo",
       "geminicli",
       "kiro",
@@ -241,6 +242,73 @@ var init_cline = __esm({
   }
 });
 
+// src/generators/mcp/codexcli.ts
+function generateCodexMcp(config) {
+  return generateMcpConfig(config, {
+    target: "codexcli",
+    configPaths: [".codex/mcp-config.json"],
+    serverTransform: (server) => {
+      const codexServer = {};
+      if (server.command) {
+        codexServer.command = server.command;
+        if (server.args) codexServer.args = server.args;
+        codexServer.transport = server.transport || "stdio";
+      } else if (server.url || server.httpUrl) {
+        const url = server.httpUrl || server.url;
+        if (url) {
+          codexServer.url = url;
+        }
+        if (server.httpUrl) {
+          codexServer.transport = "http";
+        } else if (server.transport === "sse") {
+          codexServer.transport = "sse";
+        } else if (server.transport === "http") {
+          codexServer.transport = "http";
+        } else {
+          codexServer.transport = "stdio";
+        }
+      } else {
+        codexServer.transport = "stdio";
+      }
+      if (server.env) {
+        codexServer.env = { ...server.env };
+        if (!codexServer.env.CODEX_DEFAULT_MODEL) {
+          codexServer.env.CODEX_DEFAULT_MODEL = "gpt-4o-mini";
+        }
+      }
+      if (server.cwd) {
+        codexServer.cwd = server.cwd;
+        codexServer.workingDirectory = server.cwd;
+      }
+      if (server.timeout) {
+        codexServer.timeout = server.timeout;
+      }
+      if (server.headers) {
+        codexServer.headers = server.headers;
+      }
+      return codexServer;
+    },
+    configWrapper: (servers) => ({
+      // Configuration format for MCP wrapper servers that expose Codex CLI functionality
+      servers,
+      _comment: "Configuration for MCP wrapper servers like openai-codex-mcp that integrate with Codex CLI",
+      _usage: "This file is intended for use with third-party MCP servers that wrap Codex CLI functionality",
+      _examples: {
+        python_server: "python -m mcp_server or uvicorn codex_server:app",
+        nodejs_server: "node dist/server.js or npm start",
+        docker_server: "docker run -i --rm custom/codex-mcp:latest"
+      },
+      _security_note: "Store API keys in environment variables, not in this configuration file"
+    })
+  });
+}
+var init_codexcli = __esm({
+  "src/generators/mcp/codexcli.ts"() {
+    "use strict";
+    init_shared_factory();
+  }
+});
+
 // src/generators/mcp/copilot.ts
 function generateCopilotMcp(config, target) {
   const servers = {};
@@ -558,6 +626,7 @@ function getDefaultConfig() {
       cursor: ".cursor/rules",
       cline: ".clinerules",
       claudecode: ".",
+      codexcli: ".",
       roo: ".roo/rules",
       geminicli: ".gemini/memories",
       kiro: ".kiro/steering",
@@ -646,6 +715,7 @@ var OutputPathsSchema = import_mini4.z.object({
   cursor: import_mini4.z.optional(import_mini4.z.string()),
   cline: import_mini4.z.optional(import_mini4.z.string()),
   claudecode: import_mini4.z.optional(import_mini4.z.string()),
+  codexcli: import_mini4.z.optional(import_mini4.z.string()),
   roo: import_mini4.z.optional(import_mini4.z.string()),
   geminicli: import_mini4.z.optional(import_mini4.z.string()),
   kiro: import_mini4.z.optional(import_mini4.z.string()),
@@ -709,7 +779,8 @@ var McpServerBaseSchema = import_mini5.z.object({
   alwaysAllow: import_mini5.z.optional(import_mini5.z.array(import_mini5.z.string())),
   tools: import_mini5.z.optional(import_mini5.z.array(import_mini5.z.string())),
   kiroAutoApprove: import_mini5.z.optional(import_mini5.z.array(import_mini5.z.string())),
-  kiroAutoBlock: import_mini5.z.optional(import_mini5.z.array(import_mini5.z.string()))
+  kiroAutoBlock: import_mini5.z.optional(import_mini5.z.array(import_mini5.z.string())),
+  headers: import_mini5.z.optional(import_mini5.z.record(import_mini5.z.string(), import_mini5.z.string()))
 });
 var RulesyncMcpServerSchema = import_mini5.z.extend(McpServerBaseSchema, {
   targets: import_mini5.z.optional(RulesyncTargetsSchema)
@@ -941,6 +1012,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
 var import_promises2 = require("fs/promises");
 var import_node_path = require("path");
@@ -951,6 +1052,9 @@ async function ensureDir(dirPath) {
     await (0, import_promises2.mkdir)(dirPath, { recursive: true });
   }
 }
+function resolvePath(relativePath, baseDir) {
+  return baseDir ? (0, import_node_path.join)(baseDir, relativePath) : relativePath;
+}
 async function readFileContent(filepath) {
   return (0, import_promises2.readFile)(filepath, "utf-8");
 }
@@ -1672,6 +1776,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"
   }
 };
 
@@ -1749,7 +1982,7 @@ function filterIgnoredFiles(files, ignorePatterns) {
 
 // src/generators/rules/shared-helpers.ts
 function resolveOutputDir(config, tool, baseDir) {
-  return baseDir ? (0, import_node_path5.join)(baseDir, config.outputPaths[tool]) : config.outputPaths[tool];
+  return resolvePath(config.outputPaths[tool], baseDir);
 }
 function createOutputsArray() {
   return [];
@@ -1776,7 +2009,7 @@ async function generateRulesConfig(rules, config, generatorConfig, baseDir) {
   }
   const ignorePatterns = await loadIgnorePatterns(baseDir);
   if (ignorePatterns.patterns.length > 0) {
-    const ignorePath = baseDir ? (0, import_node_path5.join)(baseDir, generatorConfig.ignoreFileName) : generatorConfig.ignoreFileName;
+    const ignorePath = resolvePath(generatorConfig.ignoreFileName, baseDir);
     const ignoreContent = generateIgnoreFile2(ignorePatterns.patterns, generatorConfig.tool);
     outputs.push({
       tool: generatorConfig.tool,
@@ -1794,7 +2027,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 ? (0, import_node_path5.join)(baseDir, generatorConfig.detailSubDir, `${rule.filename}.md`) : (0, import_node_path5.join)(generatorConfig.detailSubDir, `${rule.filename}.md`);
+      const filepath = resolvePath(
+        (0, import_node_path5.join)(generatorConfig.detailSubDir, `${rule.filename}.md`),
+        baseDir
+      );
       outputs.push({
         tool: generatorConfig.tool,
         filepath,
@@ -1804,7 +2040,7 @@ async function generateComplexRules(rules, config, generatorConfig, baseDir) {
   }
   if (generatorConfig.generateRootContent && generatorConfig.rootFilePath) {
     const rootContent = generatorConfig.generateRootContent(rootRule, detailRules, baseDir);
-    const rootFilepath = baseDir ? (0, import_node_path5.join)(baseDir, generatorConfig.rootFilePath) : generatorConfig.rootFilePath;
+    const rootFilepath = resolvePath(generatorConfig.rootFilePath, baseDir);
     outputs.push({
       tool: generatorConfig.tool,
       filepath: rootFilepath,
@@ -1813,7 +2049,7 @@ async function generateComplexRules(rules, config, generatorConfig, baseDir) {
   }
   const ignorePatterns = await loadIgnorePatterns(baseDir);
   if (ignorePatterns.patterns.length > 0) {
-    const ignorePath = baseDir ? (0, import_node_path5.join)(baseDir, generatorConfig.ignoreFileName) : generatorConfig.ignoreFileName;
+    const ignorePath = resolvePath(generatorConfig.ignoreFileName, baseDir);
     const ignoreContent = generateIgnoreFile2(ignorePatterns.patterns, generatorConfig.tool);
     outputs.push({
       tool: generatorConfig.tool,
@@ -1918,30 +2154,22 @@ function generateLegacyGuidelinesFile(allRules) {
 // src/generators/rules/claudecode.ts
 var import_node_path7 = require("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 ? (0, import_node_path7.join)(baseDir, config.outputPaths.claudecode) : config.outputPaths.claudecode;
-  outputs.push({
+  const generatorConfig = {
     tool: "claudecode",
-    filepath: (0, import_node_path7.join)(claudeOutputDir, "CLAUDE.md"),
-    content: claudeMdContent
-  });
-  for (const rule of detailRules) {
-    const memoryContent = generateMemoryFile(rule);
-    outputs.push({
-      tool: "claudecode",
-      filepath: (0, import_node_path7.join)(claudeOutputDir, ".claude", "memories", `${rule.filename}.md`),
-      content: memoryContent
-    });
-  }
-  const ignorePatterns = await loadIgnorePatterns(baseDir);
-  if (ignorePatterns.patterns.length > 0) {
-    const settingsPath = baseDir ? (0, import_node_path7.join)(baseDir, ".claude", "settings.json") : (0, import_node_path7.join)(".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((0, import_node_path7.join)(".claude", "settings.json"), baseDir2);
+      await updateClaudeSettings(settingsPath, ignorePatterns);
+      return [];
+    }
+  };
+  return generateComplexRules(rules, config, generatorConfig, baseDir);
 }
 function generateClaudeMarkdown(rootRules, detailRules) {
   const lines = [];
@@ -2001,23 +2229,222 @@ async function updateClaudeSettings(settingsPath, ignorePatterns) {
   console.log(`\u2705 Updated Claude Code settings: ${settingsPath}`);
 }
 
+// src/generators/rules/generator-registry.ts
+var import_node_path8 = require("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 (0, import_node_path8.join)(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
-var import_node_path8 = require("path");
+var import_node_path9 = require("path");
 async function generateCopilotConfig(rules, config, baseDir) {
   return generateComplexRulesConfig(
     rules,
@@ -2029,7 +2456,7 @@ async function generateCopilotConfig(rules, config, baseDir) {
       generateContent: generateCopilotMarkdown,
       getOutputPath: (rule, outputDir) => {
         const baseFilename = rule.filename.replace(/\.md$/, "");
-        return (0, import_node_path8.join)(outputDir, `${baseFilename}.instructions.md`);
+        return (0, import_node_path9.join)(outputDir, `${baseFilename}.instructions.md`);
       }
     },
     baseDir
@@ -2050,7 +2477,7 @@ function generateCopilotMarkdown(rule) {
 }
 
 // src/generators/rules/cursor.ts
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 async function generateCursorConfig(rules, config, baseDir) {
   return generateComplexRulesConfig(
     rules,
@@ -2061,7 +2488,7 @@ async function generateCursorConfig(rules, config, baseDir) {
       ignoreFileName: ".cursorignore",
       generateContent: generateCursorMarkdown,
       getOutputPath: (rule, outputDir) => {
-        return (0, import_node_path9.join)(outputDir, `${rule.filename}.mdc`);
+        return (0, import_node_path10.join)(outputDir, `${rule.filename}.mdc`);
       }
     },
     baseDir
@@ -2190,38 +2617,13 @@ function generateGuidelinesMarkdown(rootRule, detailRules) {
 }
 
 // src/generators/rules/kiro.ts
-var import_node_path10 = require("path");
 async function generateKiroConfig(rules, config, baseDir) {
-  const outputs = [];
-  for (const rule of rules) {
-    const content = generateKiroMarkdown(rule);
-    const outputDir = baseDir ? (0, import_node_path10.join)(baseDir, config.outputPaths.kiro) : config.outputPaths.kiro;
-    const filepath = (0, import_node_path10.join)(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
@@ -2280,6 +2682,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":
@@ -2410,6 +2814,7 @@ var path4 = __toESM(require("path"), 1);
 init_augmentcode();
 init_claudecode();
 init_cline();
+init_codexcli();
 init_copilot();
 init_cursor();
 init_geminicli();
@@ -2483,6 +2888,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"),
@@ -2518,7 +2928,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,
@@ -2743,6 +3153,8 @@ var gitignoreCommand = async () => {
     "**/.clineignore",
     "**/CLAUDE.md",
     "**/.claude/memories/",
+    "**/codex.md",
+    "**/.codexignore",
     "**/.roo/rules/",
     "**/.rooignore",
     "**/.copilotignore",
@@ -2761,6 +3173,7 @@ var gitignoreCommand = async () => {
     "**/.cursor/mcp.json",
     "**/.cline/mcp.json",
     "**/.vscode/mcp.json",
+    "**/.codex/mcp-config.json",
     "**/.gemini/settings.json",
     "**/.roo/mcp.json"
   ];
@@ -2819,36 +3232,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 = (0, import_node_path14.join)(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 = (0, import_node_path14.join)(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 = (0, import_node_path14.join)(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 {
@@ -2868,7 +3308,7 @@ async function parseAugmentRules(rulesDir) {
           const filename = (0, import_node_path14.basename)(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
@@ -2877,7 +3317,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) {
@@ -2888,50 +3328,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
-var import_node_path15 = require("path");
-async function parseAugmentcodeLegacyConfiguration(baseDir = process.cwd()) {
-  const result = createParseResult();
-  const guidelinesPath = (0, import_node_path15.join)(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 {
@@ -2940,33 +3363,36 @@ async function parseAugmentGuidelines(guidelinesPath) {
 }
 
 // src/parsers/shared-helpers.ts
-var import_node_path16 = require("path");
+var import_node_path15 = require("path");
 var import_gray_matter3 = __toESM(require("gray-matter"), 1);
 async function parseConfigurationFiles(baseDir = process.cwd(), config) {
   const errors = [];
   const rules = [];
   if (config.mainFile) {
-    const mainFilePath = (0, import_node_path16.join)(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 = (0, import_gray_matter3.default)(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: ["**/*"]
           };
         }
@@ -2974,43 +3400,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 = (0, import_node_path16.join)(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 = (0, import_node_path16.join)(dirPath, file);
-              try {
+              const filePath = (0, import_node_path15.join)(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 = (0, import_gray_matter3.default)(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,
@@ -3018,15 +3453,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);
         }
       }
     }
@@ -3041,7 +3476,7 @@ async function parseMemoryBasedConfiguration(baseDir = process.cwd(), config) {
   const rules = [];
   let ignorePatterns;
   let mcpServers;
-  const mainFilePath = (0, import_node_path16.join)(baseDir, config.mainFileName);
+  const mainFilePath = resolvePath(config.mainFileName, baseDir);
   if (!await fileExists(mainFilePath)) {
     errors.push(`${config.mainFileName} file not found`);
     return { rules, errors };
@@ -3052,12 +3487,12 @@ async function parseMemoryBasedConfiguration(baseDir = process.cwd(), config) {
     if (mainRule) {
       rules.push(mainRule);
     }
-    const memoryDir = (0, import_node_path16.join)(baseDir, config.memoryDirPath);
+    const memoryDir = resolvePath(config.memoryDirPath, baseDir);
     if (await fileExists(memoryDir)) {
       const memoryRules = await parseMemoryFiles(memoryDir, config);
       rules.push(...memoryRules);
     }
-    const settingsPath = (0, import_node_path16.join)(baseDir, config.settingsPath);
+    const settingsPath = resolvePath(config.settingsPath, baseDir);
     if (await fileExists(settingsPath)) {
       const settingsResult = await parseSettingsFile(settingsPath, config.tool);
       if (settingsResult.ignorePatterns) {
@@ -3069,7 +3504,7 @@ async function parseMemoryBasedConfiguration(baseDir = process.cwd(), config) {
       errors.push(...settingsResult.errors);
     }
     if (config.additionalIgnoreFile) {
-      const additionalIgnorePath = (0, import_node_path16.join)(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) {
@@ -3078,8 +3513,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,
@@ -3123,10 +3557,10 @@ async function parseMemoryFiles(memoryDir, config) {
     const files = await readdir2(memoryDir);
     for (const file of files) {
       if (file.endsWith(".md")) {
-        const filePath = (0, import_node_path16.join)(memoryDir, file);
+        const filePath = (0, import_node_path15.join)(memoryDir, file);
         const content = await readFileContent(filePath);
         if (content.trim()) {
-          const filename = (0, import_node_path16.basename)(file, ".md");
+          const filename = (0, import_node_path15.basename)(file, ".md");
           const frontmatter = {
             root: false,
             targets: [config.tool],
@@ -3175,8 +3609,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,
@@ -3218,6 +3651,9 @@ async function parseClineConfiguration(baseDir = process.cwd()) {
   });
 }
 
+// src/parsers/codexcli.ts
+var import_node_path16 = require("path");
+
 // src/parsers/copilot.ts
 async function parseCopilotConfiguration(baseDir = process.cwd()) {
   return parseConfigurationFiles(baseDir, {
@@ -3953,12 +4389,12 @@ async function watchCommand() {
 
 // src/cli/index.ts
 var program = new import_commander.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) => {
@@ -3968,6 +4404,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");