aiexecode 1.0.157

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,170 @@
+/**
+ * AGENTS.md Loader
+ *
+ * AGENTS.md는 AI 코딩 에이전트를 위한 오픈 표준 포맷입니다.
+ * README.md가 인간을 위한 것이라면, AGENTS.md는 AI 에이전트를 위한 것입니다.
+ *
+ * 파일 위치:
+ * - CWD/AGENTS.md - 작업 디렉토리 루트에만 위치
+ * - 시스템 프롬프트에 포함됨
+ *
+ * 참조: https://agents.md/
+ */
+
+import { join } from 'path';
+import { safeReadFile, safeAccess, safeStat } from '../util/safe_fs.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} [cwd] - 현재 작업 디렉토리 (기본: process.cwd())
+ * @returns {Promise<{path: string, content: string, lineCount: number}|null>}
+ */
+export async function loadProjectAgentsMd(cwd = process.cwd()) {
+    debugLog(`[loadProjectAgentsMd] Loading from: ${cwd}`);
+
+    const agentsMd = await loadAgentsMd(join(cwd, AGENTS_MD_FILENAME));
+    if (agentsMd) {
+        debugLog(`[loadProjectAgentsMd] Found AGENTS.md`);
+        return agentsMd;
+    }
+
+    debugLog(`[loadProjectAgentsMd] No AGENTS.md found`);
+    return null;
+}
+
+/**
+ * AGENTS.md 내용을 시스템 프롬프트용 텍스트로 포맷팅합니다.
+ * @param {{path: string, content: string}|null} agentsMd
+ * @returns {string}
+ */
+export function formatAgentsMdForPrompt(agentsMd) {
+    if (!agentsMd) {
+        return '';
+    }
+
+    return `\n\n# Agent Instructions (AGENTS.md)\n\n` +
+           `The following instructions are from AGENTS.md in the project root.\n` +
+           `These provide project-specific guidance for AI coding agents.\n\n` +
+           `${agentsMd.content}\n`;
+}
+
+/**
+ * 현재 프로젝트의 AGENTS.md를 로드하고 포맷팅합니다.
+ * 시스템 프롬프트에 추가할 때 사용
+ *
+ * @param {string} [cwd] - 현재 작업 디렉토리
+ * @returns {Promise<string>} 포맷팅된 AGENTS.md 내용 (없으면 빈 문자열)
+ */
+export async function loadAgentsMdForPrompt(cwd = process.cwd()) {
+    const agentsMd = await loadProjectAgentsMd(cwd);
+    return formatAgentsMdForPrompt(agentsMd);
+}
+
+/**
+ * AGENTS.md 정보를 요약하여 반환합니다.
+ * /agents 명령어용
+ *
+ * @param {string} [cwd] - 현재 작업 디렉토리
+ * @returns {Promise<string>}
+ */
+export async function formatAgentsMdSummary(cwd = process.cwd()) {
+    const agentsMd = await loadProjectAgentsMd(cwd);
+
+    if (!agentsMd) {
+        return [
+            'No AGENTS.md file found.',
+            '',
+            'AGENTS.md is an open standard for guiding AI coding agents.',
+            '',
+            'File location:',
+            '  CWD/AGENTS.md - Project root (included in system prompt)',
+            '',
+            '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 lineCount = agentsMd.lineCount || agentsMd.content.split('\n').length;
+    const charCount = agentsMd.content.length;
+    const sizeWarning = lineCount > RECOMMENDED_MAX_LINES
+        ? ` (exceeds recommended ${RECOMMENDED_MAX_LINES} lines)`
+        : '';
+
+    const lines = [
+        'AGENTS.md:',
+        '',
+        `  Path: ${agentsMd.path}`,
+        `  Size: ${lineCount} lines, ${charCount} chars${sizeWarning}`,
+        '',
+        '  Content:',
+        '  ' + agentsMd.content.replace(/\n/g, '\n  '),
+    ];
+
+    return lines.join('\n');
+}