@lnai/core 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 
 declare const UNIFIED_DIR = ".ai";
-declare const TOOL_IDS: readonly ["claudeCode", "opencode", "cursor", "copilot", "windsurf", "gemini"];
+declare const TOOL_IDS: readonly ["claudeCode", "opencode", "cursor", "copilot", "windsurf", "gemini", "codex"];
 type ToolId = (typeof TOOL_IDS)[number];
 declare const CONFIG_FILES: {
     readonly config: "config.json";
@@ -69,6 +69,7 @@ declare const toolIdSchema: z.ZodEnum<{
     copilot: "copilot";
     windsurf: "windsurf";
     gemini: "gemini";
+    codex: "codex";
 }>;
 /** Settings configuration (Claude format as source of truth) */
 declare const settingsSchema: z.ZodObject<{
@@ -116,6 +117,10 @@ declare const configSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             versionControl: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         }, z.core.$strip>>;
+        codex: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            versionControl: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /** Skill frontmatter (name and description required) */
@@ -249,6 +254,18 @@ interface Plugin {
  */
 declare const claudeCodePlugin: Plugin;
 
+/**
+ * Codex plugin for exporting to .codex/ format
+ *
+ * Output structure:
+ * - AGENTS.md (symlink -> .ai/AGENTS.md) [at project root]
+ * - <dir>/AGENTS.md (generated from .ai/rules/*.md, per glob directory)
+ * - .codex/skills/<name>/ (symlink -> ../../.ai/skills/<name>)
+ * - .codex/config.toml (generated from settings.mcpServers)
+ * - .codex/<path> (symlink -> ../.ai/.codex/<path>) for override files
+ */
+declare const codexPlugin: Plugin;
+
 /**
  * OpenCode plugin for exporting to opencode.json format
  *
@@ -320,4 +337,4 @@ declare function initUnifiedConfig(options: InitOptions): Promise<InitResult>;
 declare function hasUnifiedConfig(rootDir: string): Promise<boolean>;
 declare function generateDefaultConfig(tools?: ToolId[], versionControl?: Record<ToolId, boolean>): Config;
 
-export { CONFIG_DIRS, CONFIG_FILES, type ChangeResult, type Config, FileNotFoundError, type InitOptions, type InitResult, LnaiError, type MarkdownFile, type MarkdownFrontmatter, type McpServer, type OutputFile, ParseError, type PermissionLevel, type Permissions, type Plugin, PluginError, type RuleFrontmatter, type Settings, type SkillFrontmatter, type SkippedFeatureDetail, type SyncOptions, type SyncResult, TOOL_IDS, TOOL_OUTPUT_DIRS, type ToolConfig, type ToolId, UNIFIED_DIR, type UnifiedState, ValidationError, type ValidationErrorDetail, type ValidationResult, type ValidationWarningDetail, WriteError, type WriterOptions, claudeCodePlugin, computeHash, configSchema, generateDefaultConfig, hasUnifiedConfig, initUnifiedConfig, mcpServerSchema, opencodePlugin, parseFrontmatter, parseUnifiedConfig, permissionsSchema, pluginRegistry, ruleFrontmatterSchema, runSyncPipeline, settingsSchema, skillFrontmatterSchema, toolConfigSchema, toolIdSchema, updateGitignore, validateConfig, validateSettings, validateUnifiedState, writeFiles };
+export { CONFIG_DIRS, CONFIG_FILES, type ChangeResult, type Config, FileNotFoundError, type InitOptions, type InitResult, LnaiError, type MarkdownFile, type MarkdownFrontmatter, type McpServer, type OutputFile, ParseError, type PermissionLevel, type Permissions, type Plugin, PluginError, type RuleFrontmatter, type Settings, type SkillFrontmatter, type SkippedFeatureDetail, type SyncOptions, type SyncResult, TOOL_IDS, TOOL_OUTPUT_DIRS, type ToolConfig, type ToolId, UNIFIED_DIR, type UnifiedState, ValidationError, type ValidationErrorDetail, type ValidationResult, type ValidationWarningDetail, WriteError, type WriterOptions, claudeCodePlugin, codexPlugin, computeHash, configSchema, generateDefaultConfig, hasUnifiedConfig, initUnifiedConfig, mcpServerSchema, opencodePlugin, parseFrontmatter, parseUnifiedConfig, permissionsSchema, pluginRegistry, ruleFrontmatterSchema, runSyncPipeline, settingsSchema, skillFrontmatterSchema, toolConfigSchema, toolIdSchema, updateGitignore, validateConfig, validateSettings, validateUnifiedState, writeFiles };

package/dist/index.js

@@ -12,7 +12,8 @@ var TOOL_IDS = [
   "cursor",
   "copilot",
   "windsurf",
-  "gemini"
+  "gemini",
+  "codex"
 ];
 var CONFIG_FILES = {
   config: "config.json",
@@ -30,7 +31,8 @@ var TOOL_OUTPUT_DIRS = {
   cursor: ".cursor",
   copilot: ".github",
   windsurf: ".windsurf",
-  gemini: ".gemini"
+  gemini: ".gemini",
+  codex: ".codex"
 };
 var OVERRIDE_DIRS = {
   claudeCode: ".claude",
@@ -38,7 +40,8 @@ var OVERRIDE_DIRS = {
   cursor: ".cursor",
   copilot: ".copilot",
   windsurf: ".windsurf",
-  gemini: ".gemini"
+  gemini: ".gemini",
+  codex: ".codex"
 };
 
 // src/errors.ts
@@ -124,7 +127,8 @@ var toolIdSchema = z.enum([
   "cursor",
   "copilot",
   "windsurf",
-  "gemini"
+  "gemini",
+  "codex"
 ]);
 var settingsSchema = z.object({
   permissions: permissionsSchema.optional(),
@@ -137,7 +141,8 @@ var configSchema = z.object({
     cursor: toolConfigSchema,
     copilot: toolConfigSchema,
     windsurf: toolConfigSchema,
-    gemini: toolConfigSchema
+    gemini: toolConfigSchema,
+    codex: toolConfigSchema
   }).partial().optional()
 });
 var skillFrontmatterSchema = z.object({
@@ -501,6 +506,183 @@ var claudeCodePlugin = {
     return { valid: true, errors: [], warnings, skipped: [] };
   }
 };
+function getDirFromGlob(glob) {
+  const cleanPath = glob.replace(/(\*\*|\*|\{.*,.*\}).*$/, "");
+  const dir = cleanPath.replace(/\/$/, "");
+  if (dir === glob) {
+    const dirname4 = path.dirname(dir);
+    return dirname4 === "." && !dir.includes("/") ? "." : dirname4;
+  }
+  if (!dir) {
+    return ".";
+  }
+  return dir;
+}
+function groupRulesByDirectory(rules) {
+  const rulesMap = /* @__PURE__ */ new Map();
+  const addedRules = /* @__PURE__ */ new Map();
+  for (const rule of rules) {
+    for (const pathGlob of rule.frontmatter.paths) {
+      const dir = getDirFromGlob(pathGlob);
+      if (!rulesMap.has(dir)) {
+        rulesMap.set(dir, []);
+        addedRules.set(dir, /* @__PURE__ */ new Set());
+      }
+      if (addedRules.get(dir)?.has(rule.path)) {
+        continue;
+      }
+      addedRules.get(dir)?.add(rule.path);
+      const content = `## ${rule.path}
+
+${rule.content}
+`;
+      rulesMap.get(dir)?.push(content);
+    }
+  }
+  return rulesMap;
+}
+
+// src/plugins/codex/index.ts
+var codexPlugin = {
+  id: "codex",
+  name: "Codex",
+  async detect(_rootDir) {
+    return false;
+  },
+  async import(_rootDir) {
+    return null;
+  },
+  async export(state, rootDir) {
+    const files = [];
+    const outputDir = TOOL_OUTPUT_DIRS.codex;
+    if (state.agents) {
+      files.push({
+        path: "AGENTS.md",
+        type: "symlink",
+        target: `${UNIFIED_DIR}/AGENTS.md`
+      });
+    }
+    const rulesMap = groupRulesByDirectory(state.rules);
+    for (const [dir, contents] of rulesMap.entries()) {
+      if (dir === ".") {
+        continue;
+      }
+      const combinedContent = contents.join("\n---\n\n");
+      files.push({
+        path: `${dir}/AGENTS.md`,
+        type: "text",
+        content: combinedContent
+      });
+    }
+    for (const skill of state.skills) {
+      files.push({
+        path: `${outputDir}/skills/${skill.path}`,
+        type: "symlink",
+        target: `../../${UNIFIED_DIR}/skills/${skill.path}`
+      });
+    }
+    const configToml = buildCodexConfigToml(state.settings?.mcpServers);
+    if (configToml) {
+      files.push({
+        path: `${outputDir}/config.toml`,
+        type: "text",
+        content: configToml
+      });
+    }
+    return applyFileOverrides(files, rootDir, "codex");
+  },
+  validate(state) {
+    const warnings = [];
+    const skipped = [];
+    if (!state.agents) {
+      warnings.push({
+        path: ["AGENTS.md"],
+        message: "No AGENTS.md found - root AGENTS.md will not be created"
+      });
+    }
+    const rulesMap = groupRulesByDirectory(state.rules);
+    if (rulesMap.has(".")) {
+      warnings.push({
+        path: ["rules"],
+        message: "Rules with root globs are not exported - Codex only receives subdirectory AGENTS.md files"
+      });
+    }
+    const mcpServers = state.settings?.mcpServers;
+    if (mcpServers) {
+      for (const [name, server] of Object.entries(mcpServers)) {
+        if (!server.command && !server.url) {
+          warnings.push({
+            path: ["settings", "mcpServers", name],
+            message: `MCP server "${name}" has no command or url - it will be skipped`
+          });
+        }
+      }
+    }
+    if (state.settings?.permissions) {
+      const hasPermissions = (state.settings.permissions.allow?.length ?? 0) > 0 || (state.settings.permissions.ask?.length ?? 0) > 0 || (state.settings.permissions.deny?.length ?? 0) > 0;
+      if (hasPermissions) {
+        skipped.push({
+          feature: "permissions",
+          reason: "Codex rules are not generated from LNAI permissions"
+        });
+      }
+    }
+    return { valid: true, errors: [], warnings, skipped };
+  }
+};
+function buildCodexConfigToml(mcpServers) {
+  if (!mcpServers || Object.keys(mcpServers).length === 0) {
+    return void 0;
+  }
+  const lines = [];
+  for (const [name, server] of Object.entries(mcpServers)) {
+    const hasCommand = !!server.command;
+    const hasUrl = !!server.url;
+    if (!hasCommand && !hasUrl) {
+      continue;
+    }
+    lines.push(`[mcp_servers.${formatTomlKey(name)}]`);
+    if (server.command) {
+      lines.push(`command = ${formatTomlString(server.command)}`);
+      if (server.args && server.args.length > 0) {
+        lines.push(`args = ${formatTomlArray(server.args)}`);
+      }
+      if (server.env && Object.keys(server.env).length > 0) {
+        lines.push(`env = ${formatTomlInlineTable(server.env)}`);
+      }
+    }
+    if (server.url) {
+      lines.push(`url = ${formatTomlString(server.url)}`);
+      if (server.headers && Object.keys(server.headers).length > 0) {
+        lines.push(`http_headers = ${formatTomlInlineTable(server.headers)}`);
+      }
+    }
+    lines.push("");
+  }
+  if (lines.length === 0) {
+    return void 0;
+  }
+  return `${lines.join("\n").trimEnd()}
+`;
+}
+function formatTomlString(value) {
+  return JSON.stringify(value);
+}
+function formatTomlArray(values) {
+  return `[${values.map(formatTomlString).join(", ")}]`;
+}
+function formatTomlKey(key) {
+  if (/^[A-Za-z0-9_-]+$/.test(key)) {
+    return key;
+  }
+  return JSON.stringify(key);
+}
+function formatTomlInlineTable(values) {
+  const entries = Object.entries(values).map(
+    ([key, value]) => `${formatTomlKey(key)} = ${formatTomlString(value)}`
+  );
+  return `{ ${entries.join(", ")} }`;
+}
 
 // src/utils/transforms.ts
 var ENV_VAR_PATTERN = /\$\{([^}:]+)(:-[^}]*)?\}/g;
@@ -907,18 +1089,6 @@ function buildCliContent(permissions) {
   }
   return { permissions: permissionsResult.permissions };
 }
-function getDirFromGlob(glob) {
-  const cleanPath = glob.replace(/(\*\*|\*|\{.*,.*\}).*$/, "");
-  const dir = cleanPath.replace(/\/$/, "");
-  if (dir === glob) {
-    const dirname4 = path.dirname(dir);
-    return dirname4 === "." && !dir.includes("/") ? "." : dirname4;
-  }
-  if (!dir) {
-    return ".";
-  }
-  return dir;
-}
 
 // src/plugins/gemini/transforms.ts
 function transformMcpToGemini(mcpServers) {
@@ -941,23 +1111,6 @@ function transformMcpToGemini(mcpServers) {
   }
   return Object.keys(geminiMcp).length > 0 ? geminiMcp : void 0;
 }
-function groupRulesByDirectory(rules) {
-  const rulesMap = /* @__PURE__ */ new Map();
-  for (const rule of rules) {
-    for (const pathGlob of rule.frontmatter.paths) {
-      const dir = getDirFromGlob(pathGlob);
-      if (!rulesMap.has(dir)) {
-        rulesMap.set(dir, []);
-      }
-      const content = `## ${rule.path}
-
-${rule.content}
-`;
-      rulesMap.get(dir)?.push(content);
-    }
-  }
-  return rulesMap;
-}
 
 // src/plugins/gemini/index.ts
 var geminiPlugin = {
@@ -1304,6 +1457,7 @@ var windsurfPlugin = {
 pluginRegistry.register(claudeCodePlugin);
 pluginRegistry.register(copilotPlugin);
 pluginRegistry.register(cursorPlugin);
+pluginRegistry.register(codexPlugin);
 pluginRegistry.register(opencodePlugin);
 pluginRegistry.register(windsurfPlugin);
 pluginRegistry.register(geminiPlugin);
@@ -1570,4 +1724,4 @@ function generateDefaultConfig(tools, versionControl) {
   return { tools: toolsConfig };
 }
 
-export { CONFIG_DIRS, CONFIG_FILES, FileNotFoundError, LnaiError, ParseError, PluginError, TOOL_IDS, TOOL_OUTPUT_DIRS, UNIFIED_DIR, ValidationError, WriteError, claudeCodePlugin, computeHash, configSchema, generateDefaultConfig, hasUnifiedConfig, initUnifiedConfig, mcpServerSchema, opencodePlugin, parseFrontmatter, parseUnifiedConfig, permissionsSchema, pluginRegistry, ruleFrontmatterSchema, runSyncPipeline, settingsSchema, skillFrontmatterSchema, toolConfigSchema, toolIdSchema, updateGitignore, validateConfig, validateSettings, validateUnifiedState, writeFiles };
+export { CONFIG_DIRS, CONFIG_FILES, FileNotFoundError, LnaiError, ParseError, PluginError, TOOL_IDS, TOOL_OUTPUT_DIRS, UNIFIED_DIR, ValidationError, WriteError, claudeCodePlugin, codexPlugin, computeHash, configSchema, generateDefaultConfig, hasUnifiedConfig, initUnifiedConfig, mcpServerSchema, opencodePlugin, parseFrontmatter, parseUnifiedConfig, permissionsSchema, pluginRegistry, ruleFrontmatterSchema, runSyncPipeline, settingsSchema, skillFrontmatterSchema, toolConfigSchema, toolIdSchema, updateGitignore, validateConfig, validateSettings, validateUnifiedState, writeFiles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lnai/core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Core library for LNAI - unified AI config management",
   "type": "module",
   "license": "MIT",