ai-nexus 1.3.14 → 1.3.15

package/README.ko.md

@@ -90,7 +90,7 @@ npx ai-nexus install --rules github.com/your-org/team-rules
 |------|-----------|-----------|
 | **Claude Code** | 시맨틱 라우터가 프롬프트마다 동적으로 룰 교체 | 필요한 룰만 로딩 |
 | **Cursor** | 룰을 `.mdc` 형식으로 변환; Cursor 내장 검색이 필터링 | Cursor 검색에 의존 |
-| **Codex** | 정적 `AGENTS.md` (동적 로딩 없음) | 전체 룰 로딩 |
+| **Codex** | 집계된 `AGENTS.md` (개별 룰 병합) | 전체 룰 로딩 |
 
 ---
 
@@ -136,9 +136,9 @@ alwaysApply: false
 
 변환 후 룰 필터링은 **Cursor 내장 시맨틱 서치**가 처리합니다 — ai-nexus가 Cursor에서 라우터를 실행하지는 않습니다. 핵심 가치는 통합 룰 관리: 룰을 한 번 작성하면 Claude Code, Cursor, Codex에서 모두 사용할 수 있습니다.
 
-### Codex: 정적 룰
+### Codex: 룰 집계
 
-세션 시작 시 단일 `AGENTS.md` 파일이 로드됩니다. 동적 로딩 없음.
+개별 룰 파일들이 단일 `AGENTS.md` 파일로 자동 병합되며, 세션 시작 시 로드됩니다. 동적 로딩 없음.
 
 ---
 

package/README.md

@@ -90,7 +90,7 @@ npx ai-nexus install --rules github.com/your-org/team-rules
 |------|--------------|----------------|
 | **Claude Code** | Semantic Router dynamically swaps rules per prompt | Only relevant rules loaded |
 | **Cursor** | Converts rules to `.mdc` format; Cursor's built-in search handles filtering | Depends on Cursor's search |
-| **Codex** | Static `AGENTS.md` (no dynamic loading) | All rules loaded |
+| **Codex** | Aggregated `AGENTS.md` (rules merged into single file) | All rules loaded |
 
 ---
 
@@ -136,9 +136,9 @@ alwaysApply: false
 
 After conversion, **Cursor's built-in semantic search** handles rule filtering — ai-nexus does not run a router for Cursor. The value is unified rule management: write rules once, use them across Claude Code, Cursor, and Codex.
 
-### Codex: Static Rules
+### Codex: Aggregated Rules
 
-A single `AGENTS.md` file is loaded at session start. No dynamic loading.
+Individual rule files are aggregated into a single `AGENTS.md` file, which is loaded at session start. No dynamic loading.
 
 ---
 

package/dist/commands/init-interactive.js

@@ -5,7 +5,7 @@ import { createRequire } from 'module';
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import ora from 'ora';
-import { getTargetDir, getConfigPath, ensureDir, createSymlink, scanDir, computeFileHashes, } from '../utils/files.js';
+import { getTargetDir, getConfigPath, ensureDir, createSymlink, scanDir, computeFileHashes, aggregateToAgentsMd, } from '../utils/files.js';
 import { scanConfigDir } from '../utils/config-scanner.js';
 // Convert .md to .mdc format for Cursor
 function convertToMdc(content, filename) {
@@ -376,13 +376,13 @@ async function install(selections) {
                 }
             }
         }
-        // Copy AGENTS.md for Codex
+        // Generate aggregated AGENTS.md for Codex
         if (tool === 'codex') {
-            const agentsFile = path.join(builtinConfigDir, 'codex', 'AGENTS.md');
             const destAgents = path.join(toolDir, 'AGENTS.md');
             // Local priority: skip if file exists
-            if (!fs.existsSync(destAgents) && fs.existsSync(agentsFile)) {
-                fs.copyFileSync(agentsFile, destAgents);
+            if (!fs.existsSync(destAgents)) {
+                const content = aggregateToAgentsMd(configDir, selectedFiles);
+                fs.writeFileSync(destAgents, content);
             }
         }
     }

package/dist/commands/update.js

@@ -3,7 +3,7 @@ import path from 'path';
 import os from 'os';
 import chalk from 'chalk';
 import inquirer from 'inquirer';
-import { detectInstall, scanDir, compareConfigs, ensureDir, computeFileHashes } from '../utils/files.js';
+import { detectInstall, scanDir, compareConfigs, ensureDir, computeFileHashes, aggregateToAgentsMd } from '../utils/files.js';
 import crypto from 'crypto';
 import { updateRepo } from '../utils/git.js';
 export async function update(options = {}) {
@@ -184,6 +184,32 @@ export async function update(options = {}) {
             hasChanges = true;
         }
     }
+    // Regenerate AGENTS.md for Codex
+    if (meta.tools && meta.tools.includes('codex')) {
+        const codexDir = path.join(targetDir, '.codex');
+        const destAgents = path.join(codexDir, 'AGENTS.md');
+        const content = aggregateToAgentsMd(configDir);
+        if (fs.existsSync(destAgents)) {
+            const existing = fs.readFileSync(destAgents, 'utf8');
+            if (existing !== content) {
+                if (options.force) {
+                    ensureDir(codexDir);
+                    fs.writeFileSync(destAgents, content);
+                    console.log(chalk.green('   ✓ Codex AGENTS.md regenerated'));
+                    hasChanges = true;
+                }
+                else {
+                    console.log(chalk.gray('   Codex AGENTS.md has changes (use --force to regenerate)'));
+                }
+            }
+        }
+        else {
+            ensureDir(codexDir);
+            fs.writeFileSync(destAgents, content);
+            console.log(chalk.green('   ✓ Codex AGENTS.md generated'));
+            hasChanges = true;
+        }
+    }
     // Update metadata (refresh file hashes for copy mode)
     meta.updatedAt = new Date().toISOString();
     if (meta.mode === 'copy') {

package/dist/utils/files.d.ts

@@ -15,6 +15,12 @@ export declare function getConfigPath(scope: 'project' | 'global'): string;
 export declare function ensureDir(dir: string): void;
 export declare function copyFile(src: string, dest: string): void;
 export declare function createSymlink(target: string, linkPath: string): void;
+/**
+ * Aggregate rule files into a single AGENTS.md content string.
+ * If selectedFiles is provided, only those files are included.
+ * Otherwise, all .md files in each category directory are included.
+ */
+export declare function aggregateToAgentsMd(configDir: string, selectedFiles?: Record<string, string[]>): string;
 export declare function detectInstall(): {
     configPath: string;
     scope: 'project' | 'global';

package/dist/utils/files.js

@@ -83,6 +83,56 @@ export function createSymlink(target, linkPath) {
     }
     fs.symlinkSync(target, linkPath);
 }
+const AGENTS_CATEGORIES = ['rules', 'commands', 'skills', 'agents', 'contexts'];
+const CATEGORY_LABELS = {
+    rules: 'Rules',
+    commands: 'Commands',
+    skills: 'Skills',
+    agents: 'Agents',
+    contexts: 'Contexts',
+};
+function stripFrontmatter(content) {
+    return content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n*/, '').trim();
+}
+/**
+ * Aggregate rule files into a single AGENTS.md content string.
+ * If selectedFiles is provided, only those files are included.
+ * Otherwise, all .md files in each category directory are included.
+ */
+export function aggregateToAgentsMd(configDir, selectedFiles) {
+    const sections = [];
+    sections.push('# AI Agent Guidelines\n');
+    sections.push('> Auto-generated by ai-nexus. Do not edit manually.\n');
+    for (const category of AGENTS_CATEGORIES) {
+        const catDir = path.join(configDir, category);
+        if (!fs.existsSync(catDir))
+            continue;
+        let files;
+        if (selectedFiles && selectedFiles[category]) {
+            files = selectedFiles[category];
+        }
+        else {
+            // Scan all .md files in the category directory
+            files = fs.readdirSync(catDir).filter(f => f.endsWith('.md'));
+        }
+        if (files.length === 0)
+            continue;
+        const label = CATEGORY_LABELS[category] || category;
+        sections.push(`## ${label}\n`);
+        for (const file of files) {
+            const filePath = path.join(catDir, file);
+            if (!fs.existsSync(filePath))
+                continue;
+            const raw = fs.readFileSync(filePath, 'utf8');
+            const body = stripFrontmatter(raw);
+            if (!body)
+                continue;
+            sections.push(body);
+            sections.push('');
+        }
+    }
+    return sections.join('\n').trim() + '\n';
+}
 export function detectInstall() {
     const projectPath = path.join(process.cwd(), '.ai-nexus');
     if (fs.existsSync(projectPath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-nexus",
-  "version": "1.3.14",
+  "version": "1.3.15",
   "description": "Unified rule manager for Claude Code, Cursor, and Codex - write once, use everywhere, save tokens",
   "main": "dist/index.js",
   "bin": {