using System.IO;
using System.Text;
using System.Text.Json;
namespace AxCopilot.Services.Agent;
///
/// 프로젝트 개발 지침(AGENTS.md) 관리 도구.
/// 작업 폴더의 AGENTS.md 파일에 개발 규칙, 코딩 컨벤션, 설계 원칙을 읽고 쓸 수 있습니다.
/// 쓰기 시 사용자 승인을 받습니다.
///
public class ProjectRuleTool : IAgentTool
{
public string Name => "project_rules";
public string Description =>
"프로젝트 개발 지침(AGENTS.md) 및 규칙(.ax/rules/)을 관리합니다.\n" +
"- read: 현재 AGENTS.md 내용을 읽습니다\n" +
"- append: 새 규칙/지침을 AGENTS.md에 추가합니다 (사용자 승인 필요)\n" +
"- write: AGENTS.md를 새 내용으로 덮어씁니다 (사용자 승인 필요)\n" +
"- list_rules: .ax/rules/ 디렉토리의 프로젝트 규칙 파일 목록을 조회합니다\n" +
"- read_rule: .ax/rules/ 디렉토리의 특정 규칙 파일을 읽습니다\n" +
"사용자가 '개발 지침에 추가해', '규칙을 저장해', 'AGENTS.md에 기록해' 등을 요청하면 이 도구를 사용하세요.";
public ToolParameterSchema Parameters => new()
{
Properties = new()
{
["action"] = new ToolProperty
{
Type = "string",
Description = "read (AGENTS.md 읽기), append (추가), write (전체 덮어쓰기), list_rules (.ax/rules/ 목록), read_rule (규칙 파일 읽기)",
Enum = ["read", "append", "write", "list_rules", "read_rule"]
},
["rule_name"] = new ToolProperty
{
Type = "string",
Description = "read_rule 시 읽을 규칙 파일 이름 (확장자 제외). 예: 'coding-conventions'"
},
["content"] = new ToolProperty
{
Type = "string",
Description = "append/write 시 저장할 내용. 마크다운 형식을 권장합니다."
},
["section"] = new ToolProperty
{
Type = "string",
Description = "append 시 섹션 제목. 예: '코딩 컨벤션', '빌드 규칙'. 비어있으면 파일 끝에 추가."
},
},
Required = ["action"]
};
public async Task ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct = default)
{
var action = args.TryGetProperty("action", out var a) ? a.GetString() ?? "" : "";
var content = args.TryGetProperty("content", out var c) ? c.GetString() ?? "" : "";
var section = args.TryGetProperty("section", out var s) ? s.GetString() ?? "" : "";
var ruleName = args.TryGetProperty("rule_name", out var rn) ? rn.GetString() ?? "" : "";
if (string.IsNullOrEmpty(context.WorkFolder))
return ToolResult.Fail("작업 폴더가 설정되어 있지 않습니다.");
var axMdPath = FindAxMd(context.WorkFolder) ?? Path.Combine(context.WorkFolder, "AGENTS.md");
return action switch
{
"read" => ReadAxMd(axMdPath),
"append" => await AppendAxMdAsync(axMdPath, content, section, context),
"write" => await WriteAxMdAsync(axMdPath, content, context),
"list_rules" => ListRules(context.WorkFolder),
"read_rule" => ReadRule(context.WorkFolder, ruleName),
_ => ToolResult.Fail($"지원하지 않는 action: {action}. read, append, write, list_rules, read_rule 중 선택하세요.")
};
}
private static ToolResult ReadAxMd(string path)
{
if (!File.Exists(path))
return ToolResult.Ok($"AGENTS.md 파일이 없습니다.\n경로: {path}\n\n새로 생성하려면 append 또는 write 액션을 사용하세요.");
try
{
var content = File.ReadAllText(path, Encoding.UTF8);
if (string.IsNullOrWhiteSpace(content))
return ToolResult.Ok("AGENTS.md 파일이 비어 있습니다.");
return ToolResult.Ok($"[AGENTS.md 내용 ({content.Length}자)]\n\n{content}");
}
catch (Exception ex)
{
return ToolResult.Fail($"AGENTS.md 읽기 실패: {ex.Message}");
}
}
private static async Task AppendAxMdAsync(string path, string content, string section, AgentContext context)
{
if (string.IsNullOrWhiteSpace(content))
return ToolResult.Fail("추가할 content가 필요합니다.");
// 사용자 승인
var desc = $"AGENTS.md에 개발 지침을 추가합니다:\n{(content.Length > 200 ? content[..200] + "..." : content)}";
if (!await context.CheckWritePermissionAsync("project_rules", desc))
return ToolResult.Ok("사용자가 AGENTS.md 수정을 거부했습니다.");
try
{
var sb = new StringBuilder();
// 기존 내용 보존
if (File.Exists(path))
sb.Append(File.ReadAllText(path, Encoding.UTF8));
// 구분선 + 섹션 제목
if (sb.Length > 0 && !sb.ToString().EndsWith('\n'))
sb.AppendLine();
sb.AppendLine();
if (!string.IsNullOrEmpty(section))
sb.AppendLine($"## {section}");
sb.AppendLine(content.Trim());
File.WriteAllText(path, sb.ToString(), Encoding.UTF8);
return ToolResult.Ok($"AGENTS.md에 개발 지침이 추가되었습니다.\n경로: {path}\n추가된 내용 ({content.Length}자):\n{content}", path);
}
catch (Exception ex)
{
return ToolResult.Fail($"AGENTS.md 쓰기 실패: {ex.Message}");
}
}
private static async Task WriteAxMdAsync(string path, string content, AgentContext context)
{
if (string.IsNullOrWhiteSpace(content))
return ToolResult.Fail("저장할 content가 필요합니다.");
var desc = $"AGENTS.md를 전체 덮어씁니다 ({content.Length}자):\n{(content.Length > 200 ? content[..200] + "..." : content)}";
if (!await context.CheckWritePermissionAsync("project_rules", desc))
return ToolResult.Ok("사용자가 AGENTS.md 수정을 거부했습니다.");
try
{
File.WriteAllText(path, content, Encoding.UTF8);
return ToolResult.Ok($"AGENTS.md가 저장되었습니다.\n경로: {path}\n내용 ({content.Length}자)", path);
}
catch (Exception ex)
{
return ToolResult.Fail($"AGENTS.md 쓰기 실패: {ex.Message}");
}
}
private static ToolResult ListRules(string workFolder)
{
var rules = ProjectRulesService.LoadRules(workFolder);
if (rules.Count == 0)
{
var rulesDir = ProjectRulesService.FindRulesDirectory(workFolder);
var suggestedPath = rulesDir ?? Path.Combine(workFolder, ".ax", "rules");
return ToolResult.Ok(
$"프로젝트 규칙이 없습니다.\n" +
$"규칙 파일을 추가하려면 {suggestedPath} 디렉토리에 .md 파일을 생성하세요.\n\n" +
"예시 규칙 파일 형식:\n" +
"---\nname: 코딩 컨벤션\ndescription: C# 코딩 규칙\napplies-to: \"*.cs\"\nwhen: always\n---\n\n규칙 내용...");
}
var sb = new StringBuilder();
sb.AppendLine($"[프로젝트 규칙 {rules.Count}개]\n");
foreach (var rule in rules)
{
sb.AppendLine($" • {rule.Name}");
if (!string.IsNullOrEmpty(rule.Description))
sb.AppendLine($" 설명: {rule.Description}");
if (!string.IsNullOrEmpty(rule.AppliesTo))
sb.AppendLine($" 적용 대상: {rule.AppliesTo}");
sb.AppendLine($" 적용 시점: {rule.When}");
sb.AppendLine($" 파일: {rule.FilePath}");
sb.AppendLine();
}
return ToolResult.Ok(sb.ToString());
}
private static ToolResult ReadRule(string workFolder, string ruleName)
{
if (string.IsNullOrWhiteSpace(ruleName))
return ToolResult.Fail("rule_name 파라미터가 필요합니다.");
var rules = ProjectRulesService.LoadRules(workFolder);
var rule = rules.FirstOrDefault(r =>
r.Name.Equals(ruleName, StringComparison.OrdinalIgnoreCase) ||
Path.GetFileNameWithoutExtension(r.FilePath).Equals(ruleName, StringComparison.OrdinalIgnoreCase));
if (rule == null)
return ToolResult.Fail($"규칙 '{ruleName}'을(를) 찾을 수 없습니다. list_rules로 목록을 확인하세요.");
var sb = new StringBuilder();
sb.AppendLine($"[규칙: {rule.Name}]");
if (!string.IsNullOrEmpty(rule.Description)) sb.AppendLine($"설명: {rule.Description}");
if (!string.IsNullOrEmpty(rule.AppliesTo)) sb.AppendLine($"적용 대상: {rule.AppliesTo}");
sb.AppendLine($"적용 시점: {rule.When}");
sb.AppendLine($"파일: {rule.FilePath}");
sb.AppendLine();
sb.AppendLine(rule.Body);
return ToolResult.Ok(sb.ToString(), rule.FilePath);
}
/// AGENTS.md 파일을 작업 폴더에서 최대 3단계 상위까지 탐색합니다 (없으면 AX.md 폴백).
private static string? FindAxMd(string workFolder)
{
var dir = workFolder;
for (int i = 0; i < 3; i++)
{
if (string.IsNullOrEmpty(dir)) break;
var agentsPath = Path.Combine(dir, "AGENTS.md");
if (File.Exists(agentsPath)) return agentsPath;
var legacyPath = Path.Combine(dir, "AX.md");
if (File.Exists(legacyPath)) return legacyPath;
dir = Directory.GetParent(dir)?.FullName;
}
return null;
}
}