aiexecode 1.0.94 → 1.0.96

package/src/frontend/utils/toolUIFormatter.js

@@ -0,0 +1,261 @@
+/**
+ * Tool UI Formatter
+ * 도구 스키마에서 UI 포맷팅 로직을 분리하여 tools → frontend 의존성을 제거합니다.
+ */
+
+import { theme } from '../design/themeColors.js';
+import { toDisplayPath } from '../../util/path_helper.js';
+
+/**
+ * 도구별 UI 포맷터 정의
+ * 각 도구의 ui_display 설정을 중앙에서 관리합니다.
+ */
+export const toolUIFormatters = {
+    // ============================================
+    // File Reader
+    // ============================================
+    read_file: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Read',
+        format_tool_call: (args) => {
+            return `(${toDisplayPath(args.filePath)})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const lines = result.total_line_count || 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Read ', style: {} },
+                        { text: String(lines), style: { color: theme.brand.light, bold: true } },
+                        { text: ` line${lines !== 1 ? 's' : ''}`, style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Error reading file';
+        }
+    },
+
+    read_file_range: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Read',
+        format_tool_call: (args) => {
+            return `(${toDisplayPath(args.filePath)}, lines ${args.startLine}-${args.endLine})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const lineCount = result.file_content ? result.file_content.split('\n').length : 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Read ', style: {} },
+                        { text: String(lineCount), style: { color: theme.brand.light, bold: true } },
+                        { text: ` line${lineCount !== 1 ? 's' : ''}`, style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Error reading file';
+        }
+    },
+
+    // ============================================
+    // Code Editor
+    // ============================================
+    write_file: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Write',
+        format_tool_call: (args) => {
+            return `(${toDisplayPath(args.file_path)})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const lines = result.total_line_count || 0;
+                const action = result.file_existed ? 'Overwrote' : 'Created';
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: `${action} `, style: {} },
+                        { text: String(lines), style: { color: theme.brand.light, bold: true } },
+                        { text: ` line${lines !== 1 ? 's' : ''}`, style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Error writing file';
+        }
+    },
+
+    edit_file_replace: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Replace',
+        format_tool_call: (args) => {
+            return `(${toDisplayPath(args.file_path)})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const count = result.replacement_count || 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Replaced ', style: {} },
+                        { text: String(count), style: { color: theme.brand.light, bold: true } },
+                        { text: ` occurrence${count !== 1 ? 's' : ''}`, style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Error replacing string';
+        }
+    },
+
+    edit_file_range: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Edit',
+        format_tool_call: (args) => {
+            return `(${toDisplayPath(args.file_path)}, lines ${args.start_line}-${args.end_line})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const op = result.operation_type;
+                if (op === 'delete') {
+                    return `Deleted lines`;
+                } else if (op === 'insert') {
+                    return `Inserted lines`;
+                } else {
+                    return `Replaced lines`;
+                }
+            }
+            return result.error_message || 'Error editing file';
+        }
+    },
+
+    // ============================================
+    // Search Tools
+    // ============================================
+    glob_search: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Search',
+        format_tool_call: (args) => {
+            const pattern = args.pattern || '';
+            return `(${pattern})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const matches = result.total_matches || 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Found ', style: {} },
+                        { text: String(matches), style: { color: theme.brand.light, bold: true } },
+                        { text: ` match${matches !== 1 ? 'es' : ''}`, style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Search failed';
+        }
+    },
+
+    ripgrep: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Grep',
+        format_tool_call: (args) => {
+            const pattern = args.pattern || '';
+            const shortened = pattern.length > 30 ? pattern.substring(0, 27) + '...' : pattern;
+            return `(${shortened})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const matches = result.totalMatches || 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Found ', style: {} },
+                        { text: String(matches), style: { color: theme.brand.light, bold: true } },
+                        { text: ` match${matches !== 1 ? 'es' : ''}`, style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Search failed';
+        }
+    },
+
+    // ============================================
+    // Web Downloader
+    // ============================================
+    fetch_web_page: {
+        show_tool_call: true,
+        show_tool_result: true,
+        display_name: 'Fetch',
+        format_tool_call: (args) => {
+            const url = args.url || '';
+            const shortened = url.length > 50 ? url.substring(0, 47) + '...' : url;
+            return `(${shortened})`;
+        },
+        format_tool_result: (result) => {
+            if (result.operation_successful) {
+                const contentLength = result.content?.length || 0;
+                return {
+                    type: 'formatted',
+                    parts: [
+                        { text: 'Fetched ', style: {} },
+                        { text: String(contentLength), style: { color: theme.brand.light, bold: true } },
+                        { text: ' characters', style: {} }
+                    ]
+                };
+            }
+            return result.error_message || 'Fetch failed';
+        }
+    }
+};
+
+/**
+ * 도구 이름으로 UI 포맷터를 가져옵니다.
+ * @param {string} toolName - 도구 이름
+ * @returns {Object|null} UI 포맷터 또는 null
+ */
+export function getToolUIFormatter(toolName) {
+    return toolUIFormatters[toolName] || null;
+}
+
+/**
+ * 도구 호출을 포맷팅합니다.
+ * @param {string} toolName - 도구 이름
+ * @param {Object} args - 도구 인자
+ * @returns {string} 포맷팅된 문자열
+ */
+export function formatToolCall(toolName, args) {
+    const formatter = getToolUIFormatter(toolName);
+    if (formatter && formatter.format_tool_call) {
+        return formatter.format_tool_call(args);
+    }
+    return `(${JSON.stringify(args)})`;
+}
+
+/**
+ * 도구 결과를 포맷팅합니다.
+ * @param {string} toolName - 도구 이름
+ * @param {Object} result - 도구 실행 결과
+ * @returns {string|Object} 포맷팅된 결과
+ */
+export function formatToolResult(toolName, result) {
+    const formatter = getToolUIFormatter(toolName);
+    if (formatter && formatter.format_tool_result) {
+        return formatter.format_tool_result(result);
+    }
+    return result.operation_successful ? 'Success' : (result.error_message || 'Error');
+}
+
+/**
+ * 도구의 표시 이름을 가져옵니다.
+ * @param {string} toolName - 도구 이름
+ * @returns {string} 표시 이름
+ */
+export function getToolDisplayName(toolName) {
+    const formatter = getToolUIFormatter(toolName);
+    return formatter?.display_name || toolName;
+}

package/src/system/agents_loader.js

@@ -0,0 +1,289 @@
+/**
+ * AGENTS.md Loader
+ *
+ * AGENTS.md는 AI 코딩 에이전트를 위한 오픈 표준 포맷입니다.
+ * README.md가 인간을 위한 것이라면, AGENTS.md는 AI 에이전트를 위한 것입니다.
+ *
+ * 파일 위치 및 우선순위 (높은 순):
+ * 1. CWD/AGENTS.md - 현재 작업 디렉토리
+ * 2. CWD/.aiexe/AGENTS.md - 프로젝트별 설정
+ * 3. ~/.aiexe/AGENTS.md - 글로벌 설정
+ *
+ * 하위 디렉토리 지원:
+ * - 하위 디렉토리에 AGENTS.md가 있으면 해당 디렉토리 작업 시 추가로 로드
+ * - 가장 가까운 AGENTS.md가 우선순위를 가짐
+ *
+ * 참조: https://agents.md/
+ */
+
+import { join, dirname, resolve } from 'path';
+import { safeReadFile, safeAccess, safeStat } from '../util/safe_fs.js';
+import { CONFIG_DIR } from '../util/config.js';
+import { createDebugLogger } from '../util/debug_log.js';
+
+const debugLog = createDebugLogger('agents_loader.log', 'agents_loader');
+
+// AGENTS.md 파일명 (대소문자 구분)
+const AGENTS_MD_FILENAME = 'AGENTS.md';
+
+// 권장 최대 줄 수 (GitHub 분석 기반)
+const RECOMMENDED_MAX_LINES = 150;
+
+/**
+ * 파일이 존재하는지 확인합니다.
+ * @param {string} filePath - 확인할 파일 경로
+ * @returns {Promise<boolean>}
+ */
+async function fileExists(filePath) {
+    try {
+        await safeAccess(filePath);
+        const stat = await safeStat(filePath);
+        return stat.isFile();
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * AGENTS.md 파일을 로드합니다.
+ * @param {string} filePath - AGENTS.md 파일 경로
+ * @returns {Promise<{path: string, content: string}|null>}
+ */
+async function loadAgentsMd(filePath) {
+    try {
+        if (!await fileExists(filePath)) {
+            return null;
+        }
+        const content = await safeReadFile(filePath, 'utf8');
+        const trimmedContent = content.trim();
+        const lineCount = trimmedContent.split('\n').length;
+
+        debugLog(`[loadAgentsMd] Loaded: ${filePath} (${trimmedContent.length} chars, ${lineCount} lines)`);
+
+        // 권장 크기 초과 시 경고
+        if (lineCount > RECOMMENDED_MAX_LINES) {
+            debugLog(`[loadAgentsMd] WARNING: ${filePath} has ${lineCount} lines (recommended: <=${RECOMMENDED_MAX_LINES})`);
+        }
+
+        return {
+            path: filePath,
+            content: trimmedContent,
+            lineCount
+        };
+    } catch (error) {
+        debugLog(`[loadAgentsMd] Error loading ${filePath}: ${error.message}`);
+        return null;
+    }
+}
+
+/**
+ * 디렉토리에서 상위로 올라가며 AGENTS.md를 찾습니다.
+ * @param {string} startDir - 시작 디렉토리
+ * @param {string} [stopAt] - 여기까지만 탐색 (기본: 루트)
+ * @returns {Promise<{path: string, content: string}|null>}
+ */
+async function findAgentsMdUpward(startDir, stopAt = '/') {
+    let currentDir = resolve(startDir);
+    const stopDir = resolve(stopAt);
+
+    while (currentDir && currentDir !== stopDir) {
+        const agentsMdPath = join(currentDir, AGENTS_MD_FILENAME);
+
+        const result = await loadAgentsMd(agentsMdPath);
+        if (result) {
+            return result;
+        }
+
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            break; // 루트에 도달
+        }
+        currentDir = parentDir;
+    }
+
+    return null;
+}
+
+/**
+ * 모든 관련 AGENTS.md 파일을 수집합니다.
+ * 우선순위 순서로 반환 (높은 우선순위가 먼저)
+ *
+ * @param {string} [cwd] - 현재 작업 디렉토리 (기본: process.cwd())
+ * @returns {Promise<Array<{path: string, content: string, source: string}>>}
+ */
+export async function discoverAllAgentsMd(cwd = process.cwd()) {
+    debugLog(`[discoverAllAgentsMd] Starting discovery from: ${cwd}`);
+
+    const results = [];
+
+    // 1. CWD/AGENTS.md (최고 우선순위)
+    const cwdAgentsMd = await loadAgentsMd(join(cwd, AGENTS_MD_FILENAME));
+    if (cwdAgentsMd) {
+        results.push({
+            ...cwdAgentsMd,
+            source: 'project'
+        });
+    }
+
+    // 2. CWD/.aiexe/AGENTS.md (프로젝트별 설정)
+    const projectAgentsMd = await loadAgentsMd(join(cwd, '.aiexe', AGENTS_MD_FILENAME));
+    if (projectAgentsMd) {
+        results.push({
+            ...projectAgentsMd,
+            source: 'project-config'
+        });
+    }
+
+    // 3. 상위 디렉토리 탐색 (CWD가 아닌 상위에서)
+    const parentAgentsMd = await findAgentsMdUpward(dirname(cwd));
+    if (parentAgentsMd && !results.some(r => r.path === parentAgentsMd.path)) {
+        results.push({
+            ...parentAgentsMd,
+            source: 'parent'
+        });
+    }
+
+    // 4. ~/.aiexe/AGENTS.md (글로벌 설정 - 가장 낮은 우선순위)
+    const globalAgentsMd = await loadAgentsMd(join(CONFIG_DIR, AGENTS_MD_FILENAME));
+    if (globalAgentsMd && !results.some(r => r.path === globalAgentsMd.path)) {
+        results.push({
+            ...globalAgentsMd,
+            source: 'global'
+        });
+    }
+
+    debugLog(`[discoverAllAgentsMd] Found ${results.length} AGENTS.md files`);
+    return results;
+}
+
+/**
+ * 특정 파일/디렉토리에 가장 가까운 AGENTS.md를 찾습니다.
+ * 하위 디렉토리 작업 시 해당 디렉토리의 AGENTS.md를 우선 사용
+ *
+ * @param {string} targetPath - 대상 파일 또는 디렉토리 경로
+ * @returns {Promise<{path: string, content: string}|null>}
+ */
+export async function findNearestAgentsMd(targetPath) {
+    const resolvedPath = resolve(targetPath);
+
+    // 파일인지 디렉토리인지 확인
+    let startDir;
+    try {
+        const stat = await safeStat(resolvedPath);
+        startDir = stat.isDirectory() ? resolvedPath : dirname(resolvedPath);
+    } catch {
+        startDir = dirname(resolvedPath);
+    }
+
+    debugLog(`[findNearestAgentsMd] Searching from: ${startDir}`);
+    return await findAgentsMdUpward(startDir);
+}
+
+/**
+ * AGENTS.md 내용을 시스템 프롬프트용 텍스트로 포맷팅합니다.
+ * @param {Array<{path: string, content: string, source: string}>} agentsMdFiles
+ * @returns {string}
+ */
+export function formatAgentsMdForPrompt(agentsMdFiles) {
+    if (!agentsMdFiles || agentsMdFiles.length === 0) {
+        return '';
+    }
+
+    const sections = [];
+
+    for (const file of agentsMdFiles) {
+        const sourceLabel = {
+            'project': 'Project Root',
+            'project-config': 'Project Config (.aiexe/)',
+            'parent': 'Parent Directory',
+            'global': 'Global (~/.aiexe/)'
+        }[file.source] || file.source;
+
+        sections.push(`## AGENTS.md (${sourceLabel})\n**Path:** ${file.path}\n\n${file.content}`);
+    }
+
+    return `\n\n# Agent Instructions (AGENTS.md)\n\n` +
+           `The following instructions are from AGENTS.md files in the project.\n` +
+           `These provide project-specific guidance for AI coding agents.\n\n` +
+           sections.join('\n\n---\n\n') +
+           '\n';
+}
+
+/**
+ * 현재 프로젝트의 AGENTS.md를 로드하고 포맷팅합니다.
+ * 시스템 프롬프트에 추가할 때 사용
+ *
+ * @param {string} [cwd] - 현재 작업 디렉토리
+ * @returns {Promise<string>} 포맷팅된 AGENTS.md 내용 (없으면 빈 문자열)
+ */
+export async function loadAgentsMdForPrompt(cwd = process.cwd()) {
+    const agentsMdFiles = await discoverAllAgentsMd(cwd);
+    return formatAgentsMdForPrompt(agentsMdFiles);
+}
+
+/**
+ * AGENTS.md 정보를 요약하여 반환합니다.
+ * /agents 명령어용
+ *
+ * @param {string} [cwd] - 현재 작업 디렉토리
+ * @returns {Promise<string>}
+ */
+export async function formatAgentsMdSummary(cwd = process.cwd()) {
+    const agentsMdFiles = await discoverAllAgentsMd(cwd);
+
+    if (agentsMdFiles.length === 0) {
+        return [
+            'No AGENTS.md files found.',
+            '',
+            'AGENTS.md is an open standard for guiding AI coding agents.',
+            '',
+            'File locations (in priority order):',
+            '  1. CWD/AGENTS.md - Project root',
+            '  2. CWD/.aiexe/AGENTS.md - Project config',
+            '  3. ~/.aiexe/AGENTS.md - Global config',
+            '',
+            'Create an AGENTS.md file to provide project-specific instructions.',
+            '',
+            'Recommended sections:',
+            '  - Commands (build, test)',
+            '  - Testing guidelines',
+            '  - Project structure',
+            '  - Code style',
+            '  - Git workflow',
+            '  - Boundaries (what not to touch)',
+            '',
+            'Learn more: https://agents.md/'
+        ].join('\n');
+    }
+
+    const lines = ['AGENTS.md Files:', ''];
+
+    for (const file of agentsMdFiles) {
+        const sourceLabel = {
+            'project': 'Project Root',
+            'project-config': 'Project Config',
+            'parent': 'Parent Directory',
+            'global': 'Global'
+        }[file.source] || file.source;
+
+        const lineCount = file.lineCount || file.content.split('\n').length;
+        const charCount = file.content.length;
+        const sizeWarning = lineCount > RECOMMENDED_MAX_LINES
+            ? ` (exceeds recommended ${RECOMMENDED_MAX_LINES} lines)`
+            : '';
+
+        lines.push(`${sourceLabel}:`);
+        lines.push(`  Path: ${file.path}`);
+        lines.push(`  Size: ${lineCount} lines, ${charCount} chars${sizeWarning}`);
+
+        // 첫 3줄 미리보기
+        const preview = file.content.split('\n').slice(0, 3).join('\n');
+        lines.push(`  Preview:`);
+        lines.push(`    ${preview.replace(/\n/g, '\n    ')}`);
+        lines.push('');
+    }
+
+    lines.push('Use /agents <path> to view full content of a specific file.');
+
+    return lines.join('\n');
+}