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

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

@@ -26,7 +26,7 @@ public sealed class TaskUpdateTool : IAgentTool
 
     public Task<ToolResult> ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct = default)
     {
-        if (!args.TryGetProperty("id", out var idEl))
+        if (!args.SafeTryGetProperty("id", out var idEl))
             return Task.FromResult(ToolResult.Fail("id is required."));
         if (string.IsNullOrWhiteSpace(context.WorkFolder) || !Directory.Exists(context.WorkFolder))
             return Task.FromResult(ToolResult.Fail("valid WorkFolder is required."));
@@ -37,27 +37,27 @@ public sealed class TaskUpdateTool : IAgentTool
         if (task == null)
             return Task.FromResult(ToolResult.Fail($"Task #{id} not found."));
 
-        if (args.TryGetProperty("status", out var statusEl))
+        if (args.SafeTryGetProperty("status", out var statusEl))
         {
-            var status = (statusEl.GetString() ?? "").Trim().ToLowerInvariant();
+            var status = (statusEl.SafeGetString() ?? "").Trim().ToLowerInvariant();
             if (!TaskBoardStore.IsValidStatus(status))
                 return Task.FromResult(ToolResult.Fail("Invalid status."));
             task.Status = status;
         }
 
-        if (args.TryGetProperty("title", out var titleEl))
+        if (args.SafeTryGetProperty("title", out var titleEl))
         {
-            var title = (titleEl.GetString() ?? "").Trim();
+            var title = (titleEl.SafeGetString() ?? "").Trim();
             if (!string.IsNullOrWhiteSpace(title))
                 task.Title = title;
         }
 
-        if (args.TryGetProperty("description", out var descEl))
-            task.Description = (descEl.GetString() ?? "").Trim();
+        if (args.SafeTryGetProperty("description", out var descEl))
+            task.Description = (descEl.SafeGetString() ?? "").Trim();
 
-        if (args.TryGetProperty("priority", out var priEl))
+        if (args.SafeTryGetProperty("priority", out var priEl))
         {
-            var priority = (priEl.GetString() ?? "").Trim().ToLowerInvariant();
+            var priority = (priEl.SafeGetString() ?? "").Trim().ToLowerInvariant();
             if (!TaskBoardStore.IsValidPriority(priority))
                 return Task.FromResult(ToolResult.Fail("Invalid priority."));
             task.Priority = priority;