에이전트 선택적 탐색 구조 개선과 경고 정리 반영

- claude-code 선택적 탐색 흐름을 참고해 Cowork/Code 시스템 프롬프트에서 folder_map 상시 선행 지시를 완화하고 glob/grep 기반 좁은 탐색을 우선하도록 조정함

- FolderMapTool 기본 depth를 2로, include_files 기본값을 false로 낮추고 MultiReadTool 최대 파일 수를 8개로 줄여 초기 과탐색 폭을 보수적으로 조정함

- AgentLoopExplorationPolicy partial을 추가해 탐색 범위 분류, broad-scan corrective hint, exploration_breadth 성능 로그를 연결함

- AgentLoopService에 탐색 범위 가이드 주입과 실행 중 탐색 폭 추적을 추가하고, 좁은 질문에서 반복적인 folder_map/대량 multi_read를 교정하도록 정리함

- DocxToHtmlConverter nullable 경고를 수정해 Release 빌드 경고 0 / 오류 0 기준을 다시 충족함

- README와 docs/DEVELOPMENT.md에 2026-04-09 10:36 (KST) 기준 개발 이력을 반영함

src/AxCopilot/Services/Agent/MemoryTool.cs

@@ -51,9 +51,9 @@ public class MemoryTool : IAgentTool
 
         memoryService.Load(context.WorkFolder);
 
-        if (!args.TryGetProperty("action", out var actionEl))
+        if (!args.SafeTryGetProperty("action", out var actionEl))
             return Task.FromResult(ToolResult.Fail("action이 필요합니다."));
-        var action = actionEl.GetString() ?? "";
+        var action = actionEl.SafeGetString() ?? "";
 
         return Task.FromResult(action switch
         {
@@ -70,8 +70,8 @@ public class MemoryTool : IAgentTool
 
     private static ToolResult ExecuteSave(JsonElement args, AgentMemoryService svc, AgentContext context)
     {
-        var type = args.TryGetProperty("type", out var t) ? t.GetString() ?? "fact" : "fact";
-        var content = args.TryGetProperty("content", out var c) ? c.GetString() ?? "" : "";
+        var type = args.SafeTryGetProperty("type", out var t) ? t.SafeGetString() ?? "fact" : "fact";
+        var content = args.SafeTryGetProperty("content", out var c) ? c.SafeGetString() ?? "" : "";
 
         if (string.IsNullOrWhiteSpace(content))
             return ToolResult.Fail("content가 필요합니다.");
@@ -87,7 +87,7 @@ public class MemoryTool : IAgentTool
 
     private static ToolResult ExecuteSearch(JsonElement args, AgentMemoryService svc)
     {
-        var query = args.TryGetProperty("query", out var q) ? q.GetString() ?? "" : "";
+        var query = args.SafeTryGetProperty("query", out var q) ? q.SafeGetString() ?? "" : "";
         if (string.IsNullOrWhiteSpace(query))
             return ToolResult.Fail("query가 필요합니다.");
 
@@ -150,7 +150,7 @@ public class MemoryTool : IAgentTool
 
     private static ToolResult ExecuteDelete(JsonElement args, AgentMemoryService svc)
     {
-        var id = args.TryGetProperty("id", out var i) ? i.GetString() ?? "" : "";
+        var id = args.SafeTryGetProperty("id", out var i) ? i.SafeGetString() ?? "" : "";
         if (string.IsNullOrWhiteSpace(id))
             return ToolResult.Fail("id가 필요합니다.");
 
@@ -161,8 +161,8 @@ public class MemoryTool : IAgentTool
 
     private static ToolResult ExecuteSaveScope(JsonElement args, AgentMemoryService svc, AgentContext context)
     {
-        var scope = args.TryGetProperty("scope", out var s) ? s.GetString() ?? "" : "";
-        var content = args.TryGetProperty("content", out var c) ? c.GetString() ?? "" : "";
+        var scope = args.SafeTryGetProperty("scope", out var s) ? s.SafeGetString() ?? "" : "";
+        var content = args.SafeTryGetProperty("content", out var c) ? c.SafeGetString() ?? "" : "";
         if (string.IsNullOrWhiteSpace(scope))
             return ToolResult.Fail("scope가 필요합니다. managed | user | project | local 중 선택하세요.");
         if (string.IsNullOrWhiteSpace(content))
@@ -176,8 +176,8 @@ public class MemoryTool : IAgentTool
 
     private static ToolResult ExecuteDeleteScope(JsonElement args, AgentMemoryService svc, AgentContext context)
     {
-        var scope = args.TryGetProperty("scope", out var s) ? s.GetString() ?? "" : "";
-        var query = args.TryGetProperty("query", out var q) ? q.GetString() ?? "" : "";
+        var scope = args.SafeTryGetProperty("scope", out var s) ? s.SafeGetString() ?? "" : "";
+        var query = args.SafeTryGetProperty("query", out var q) ? q.SafeGetString() ?? "" : "";
         if (string.IsNullOrWhiteSpace(scope))
             return ToolResult.Fail("scope가 필요합니다. managed | user | project | local 중 선택하세요.");
         if (string.IsNullOrWhiteSpace(query))
@@ -191,7 +191,7 @@ public class MemoryTool : IAgentTool
 
     private static ToolResult ExecuteShowScope(JsonElement args, AgentMemoryService svc, AgentContext context)
     {
-        var scope = args.TryGetProperty("scope", out var s) ? s.GetString() ?? "" : "";
+        var scope = args.SafeTryGetProperty("scope", out var s) ? s.SafeGetString() ?? "" : "";
         if (string.IsNullOrWhiteSpace(scope))
             return ToolResult.Fail("scope가 필요합니다. managed | user | project | local 중 선택하세요.");