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

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

@@ -49,8 +49,8 @@ public class ZipTool : IAgentTool
 
     public Task<ToolResult> ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct = default)
     {
-        var action  = args.GetProperty("action").GetString() ?? "";
-        var zipPath = args.GetProperty("zip_path").GetString() ?? "";
+        var action  = args.GetProperty("action").SafeGetString() ?? "";
+        var zipPath = args.GetProperty("zip_path").SafeGetString() ?? "";
 
         if (!Path.IsPathRooted(zipPath))
             zipPath = Path.Combine(context.WorkFolder, zipPath);
@@ -73,10 +73,10 @@ public class ZipTool : IAgentTool
 
     private static ToolResult Compress(JsonElement args, string zipPath, AgentContext context)
     {
-        if (!args.TryGetProperty("source_path", out var sp))
+        if (!args.SafeTryGetProperty("source_path", out var sp))
             return ToolResult.Fail("'source_path' is required for compress action");
 
-        var sourcePath = sp.GetString() ?? "";
+        var sourcePath = sp.SafeGetString() ?? "";
         if (!Path.IsPathRooted(sourcePath))
             sourcePath = Path.Combine(context.WorkFolder, sourcePath);
 
@@ -107,8 +107,8 @@ public class ZipTool : IAgentTool
         if (!File.Exists(zipPath))
             return ToolResult.Fail($"Zip file not found: {zipPath}");
 
-        var destPath = args.TryGetProperty("dest_path", out var dp)
-            ? dp.GetString() ?? "" : "";
+        var destPath = args.SafeTryGetProperty("dest_path", out var dp)
+            ? dp.SafeGetString() ?? "" : "";
         if (string.IsNullOrEmpty(destPath))
             destPath = Path.Combine(Path.GetDirectoryName(zipPath) ?? context.WorkFolder,
                 Path.GetFileNameWithoutExtension(zipPath));