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

- 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/CheckpointTool.cs

@@ -66,9 +66,9 @@ public class CheckpointTool : IAgentTool
 
     public async Task<ToolResult> ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct = default)
     {
-        if (!args.TryGetProperty("action", out var actionEl))
+        if (!args.SafeTryGetProperty("action", out var actionEl))
             return ToolResult.Fail("action이 필요합니다.");
-        var action = actionEl.GetString() ?? "";
+        var action = actionEl.SafeGetString() ?? "";
 
         if (string.IsNullOrEmpty(context.WorkFolder))
             return ToolResult.Fail("작업 폴더가 설정되지 않았습니다.");
@@ -87,7 +87,7 @@ public class CheckpointTool : IAgentTool
 
     private async Task<ToolResult> CreateCheckpoint(JsonElement args, AgentContext context, string checkpointDir, CancellationToken ct)
     {
-        var name = args.TryGetProperty("name", out var n) ? n.GetString() ?? "unnamed" : "unnamed";
+        var name = args.SafeTryGetProperty("name", out var n) ? n.SafeGetString() ?? "unnamed" : "unnamed";
         // 이름에서 파일 시스템 비안전 문자 제거
         name = string.Join("_", name.Split(Path.GetInvalidFileNameChars()));
 
@@ -206,16 +206,16 @@ public class CheckpointTool : IAgentTool
         // ID 또는 이름으로 체크포인트 찾기
         string? targetDir = null;
 
-        if (args.TryGetProperty("id", out var idEl))
+        if (args.SafeTryGetProperty("id", out var idEl))
         {
-            var id = idEl.ValueKind == JsonValueKind.Number ? idEl.GetInt32() : int.TryParse(idEl.GetString(), out var parsed) ? parsed : -1;
+            var id = idEl.ValueKind == JsonValueKind.Number ? idEl.GetInt32() : int.TryParse(idEl.SafeGetString(), out var parsed) ? parsed : -1;
             if (id >= 0 && id < dirs.Count)
                 targetDir = dirs[id];
         }
 
-        if (targetDir == null && args.TryGetProperty("name", out var nameEl))
+        if (targetDir == null && args.SafeTryGetProperty("name", out var nameEl))
         {
-            var name = nameEl.GetString() ?? "";
+            var name = nameEl.SafeGetString() ?? "";
             targetDir = dirs.FirstOrDefault(d => Path.GetFileName(d).Contains(name, StringComparison.OrdinalIgnoreCase));
         }
 
@@ -276,10 +276,10 @@ public class CheckpointTool : IAgentTool
             .OrderByDescending(d => d)
             .ToList();
 
-        if (!args.TryGetProperty("id", out var idEl))
+        if (!args.SafeTryGetProperty("id", out var idEl))
             return ToolResult.Fail("삭제할 체크포인트 id가 필요합니다.");
 
-        var id = idEl.ValueKind == JsonValueKind.Number ? idEl.GetInt32() : int.TryParse(idEl.GetString(), out var parsed) ? parsed : -1;
+        var id = idEl.ValueKind == JsonValueKind.Number ? idEl.GetInt32() : int.TryParse(idEl.SafeGetString(), out var parsed) ? parsed : -1;
         if (id < 0 || id >= dirs.Count)
             return ToolResult.Fail($"잘못된 체크포인트 ID: {id}. 0~{dirs.Count - 1} 범위를 사용하세요.");