rulesync 0.53.0 → 0.54.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)
@@ -1672,6 +1743,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"
   }
 };
 
@@ -2016,6 +2216,37 @@ async function generateClineConfig(rules, config, baseDir) {
   );
 }
 
+// src/generators/rules/codexcli.ts
+async function generateCodexConfig(rules, config, baseDir) {
+  const generatorConfig = {
+    tool: "codexcli",
+    fileExtension: ".md",
+    ignoreFileName: ".codexignore",
+    generateContent: generateCodexInstructionsMarkdown,
+    pathResolver: (rule, outputDir) => {
+      if (rule.frontmatter.root === true) {
+        return `${outputDir}/codex.md`;
+      }
+      return `${outputDir}/${rule.filename}.md`;
+    }
+  };
+  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("");
+    }
+  }
+  const content = rule.content.trim();
+  if (content) {
+    lines.push(content);
+  }
+  return lines.join("\n");
+}
+
 // src/generators/rules/copilot.ts
 var import_node_path8 = require("path");
 async function generateCopilotConfig(rules, config, baseDir) {
@@ -2280,6 +2511,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 +2643,7 @@ var path4 = __toESM(require("path"), 1);
 init_augmentcode();
 init_claudecode();
 init_cline();
+init_codexcli();
 init_copilot();
 init_cursor();
 init_geminicli();
@@ -2483,6 +2717,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 +2757,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 +2982,8 @@ var gitignoreCommand = async () => {
     "**/.clineignore",
     "**/CLAUDE.md",
     "**/.claude/memories/",
+    "**/codex.md",
+    "**/.codexignore",
     "**/.roo/rules/",
     "**/.rooignore",
     "**/.copilotignore",
@@ -2761,6 +3002,7 @@ var gitignoreCommand = async () => {
     "**/.cursor/mcp.json",
     "**/.cline/mcp.json",
     "**/.vscode/mcp.json",
+    "**/.codex/mcp-config.json",
     "**/.gemini/settings.json",
     "**/.roo/mcp.json"
   ];
@@ -2793,7 +3035,7 @@ ${linesToAdd.join("\n")}
 };
 
 // src/core/importer.ts
-var import_node_path19 = require("path");
+var import_node_path20 = require("path");
 var import_gray_matter5 = __toESM(require("gray-matter"), 1);
 
 // src/parsers/augmentcode.ts
@@ -3218,6 +3460,9 @@ async function parseClineConfiguration(baseDir = process.cwd()) {
   });
 }
 
+// src/parsers/codexcli.ts
+var import_node_path17 = require("path");
+
 // src/parsers/copilot.ts
 async function parseCopilotConfiguration(baseDir = process.cwd()) {
   return parseConfigurationFiles(baseDir, {
@@ -3239,7 +3484,7 @@ async function parseCopilotConfiguration(baseDir = process.cwd()) {
 }
 
 // src/parsers/cursor.ts
-var import_node_path17 = require("path");
+var import_node_path18 = require("path");
 var import_gray_matter4 = __toESM(require("gray-matter"), 1);
 var import_js_yaml = require("js-yaml");
 var import_mini7 = require("zod/mini");
@@ -3364,7 +3609,7 @@ async function parseCursorConfiguration(baseDir = process.cwd()) {
   const rules = [];
   let ignorePatterns;
   let mcpServers;
-  const cursorFilePath = (0, import_node_path17.join)(baseDir, ".cursorrules");
+  const cursorFilePath = (0, import_node_path18.join)(baseDir, ".cursorrules");
   if (await fileExists(cursorFilePath)) {
     try {
       const rawContent = await readFileContent(cursorFilePath);
@@ -3385,20 +3630,20 @@ async function parseCursorConfiguration(baseDir = process.cwd()) {
       errors.push(`Failed to parse .cursorrules file: ${errorMessage}`);
     }
   }
-  const cursorRulesDir = (0, import_node_path17.join)(baseDir, ".cursor", "rules");
+  const cursorRulesDir = (0, import_node_path18.join)(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 = (0, import_node_path17.join)(cursorRulesDir, file);
+          const filePath = (0, import_node_path18.join)(cursorRulesDir, file);
           try {
             const rawContent = await readFileContent(filePath);
             const parsed = (0, import_gray_matter4.default)(rawContent, customMatterOptions);
             const content = parsed.content.trim();
             if (content) {
-              const filename = (0, import_node_path17.basename)(file, ".mdc");
+              const filename = (0, import_node_path18.basename)(file, ".mdc");
               const frontmatter = convertCursorMdcFrontmatter(parsed.data, filename);
               rules.push({
                 frontmatter,
@@ -3421,7 +3666,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 = (0, import_node_path17.join)(baseDir, ".cursorignore");
+  const cursorIgnorePath = (0, import_node_path18.join)(baseDir, ".cursorignore");
   if (await fileExists(cursorIgnorePath)) {
     try {
       const content = await readFileContent(cursorIgnorePath);
@@ -3434,7 +3679,7 @@ async function parseCursorConfiguration(baseDir = process.cwd()) {
       errors.push(`Failed to parse .cursorignore: ${errorMessage}`);
     }
   }
-  const cursorMcpPath = (0, import_node_path17.join)(baseDir, ".cursor", "mcp.json");
+  const cursorMcpPath = (0, import_node_path18.join)(baseDir, ".cursor", "mcp.json");
   if (await fileExists(cursorMcpPath)) {
     try {
       const content = await readFileContent(cursorMcpPath);
@@ -3483,11 +3728,11 @@ async function parseGeminiConfiguration(baseDir = process.cwd()) {
 }
 
 // src/parsers/junie.ts
-var import_node_path18 = require("path");
+var import_node_path19 = require("path");
 async function parseJunieConfiguration(baseDir = process.cwd()) {
   const errors = [];
   const rules = [];
-  const guidelinesPath = (0, import_node_path18.join)(baseDir, ".junie", "guidelines.md");
+  const guidelinesPath = (0, import_node_path19.join)(baseDir, ".junie", "guidelines.md");
   if (!await fileExists(guidelinesPath)) {
     errors.push(".junie/guidelines.md file not found");
     return { rules, errors };
@@ -3622,7 +3867,7 @@ async function importConfiguration(options) {
   if (rules.length === 0 && !ignorePatterns && !mcpServers) {
     return { success: false, rulesCreated: 0, errors };
   }
-  const rulesDirPath = (0, import_node_path19.join)(baseDir, rulesDir);
+  const rulesDirPath = (0, import_node_path20.join)(baseDir, rulesDir);
   try {
     const { mkdir: mkdir3 } = await import("fs/promises");
     await mkdir3(rulesDirPath, { recursive: true });
@@ -3636,7 +3881,7 @@ async function importConfiguration(options) {
     try {
       const baseFilename = rule.filename;
       const filename = await generateUniqueFilename(rulesDirPath, baseFilename);
-      const filePath = (0, import_node_path19.join)(rulesDirPath, `${filename}.md`);
+      const filePath = (0, import_node_path20.join)(rulesDirPath, `${filename}.md`);
       const content = generateRuleFileContent(rule);
       await writeFileContent(filePath, content);
       rulesCreated++;
@@ -3651,7 +3896,7 @@ async function importConfiguration(options) {
   let ignoreFileCreated = false;
   if (ignorePatterns && ignorePatterns.length > 0) {
     try {
-      const rulesyncignorePath = (0, import_node_path19.join)(baseDir, ".rulesyncignore");
+      const rulesyncignorePath = (0, import_node_path20.join)(baseDir, ".rulesyncignore");
       const ignoreContent = `${ignorePatterns.join("\n")}
 `;
       await writeFileContent(rulesyncignorePath, ignoreContent);
@@ -3667,7 +3912,7 @@ async function importConfiguration(options) {
   let mcpFileCreated = false;
   if (mcpServers && Object.keys(mcpServers).length > 0) {
     try {
-      const mcpPath = (0, import_node_path19.join)(baseDir, rulesDir, ".mcp.json");
+      const mcpPath = (0, import_node_path20.join)(baseDir, rulesDir, ".mcp.json");
       const mcpContent = `${JSON.stringify({ mcpServers }, null, 2)}
 `;
       await writeFileContent(mcpPath, mcpContent);
@@ -3695,7 +3940,7 @@ function generateRuleFileContent(rule) {
 async function generateUniqueFilename(rulesDir, baseFilename) {
   let filename = baseFilename;
   let counter = 1;
-  while (await fileExists((0, import_node_path19.join)(rulesDir, `${filename}.md`))) {
+  while (await fileExists((0, import_node_path20.join)(rulesDir, `${filename}.md`))) {
     filename = `${baseFilename}-${counter}`;
     counter++;
   }
@@ -3762,7 +4007,7 @@ async function importCommand(options = {}) {
 }
 
 // src/cli/commands/init.ts
-var import_node_path20 = require("path");
+var import_node_path21 = require("path");
 async function initCommand() {
   const aiRulesDir = ".rulesync";
   console.log("Initializing rulesync...");
@@ -3809,7 +4054,7 @@ globs: ["**/*"]
 - Follow single responsibility principle
 `
   };
-  const filepath = (0, import_node_path20.join)(aiRulesDir, sampleFile.filename);
+  const filepath = (0, import_node_path21.join)(aiRulesDir, sampleFile.filename);
   if (!await fileExists(filepath)) {
     await writeFileContent(filepath, sampleFile.content);
     console.log(`Created ${filepath}`);
@@ -3953,12 +4198,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.54.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 +4213,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");