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

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

@@ -42,8 +42,8 @@ public class Base64Tool : IAgentTool
 
     public Task<ToolResult> ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct = default)
     {
-        var action = args.GetProperty("action").GetString() ?? "";
-        var text = args.TryGetProperty("text", out var t) ? t.GetString() ?? "" : "";
+        var action = args.GetProperty("action").SafeGetString() ?? "";
+        var text = args.SafeTryGetProperty("text", out var t) ? t.SafeGetString() ?? "" : "";
 
         try
         {
@@ -69,9 +69,9 @@ public class Base64Tool : IAgentTool
 
     private static ToolResult EncodeFile(JsonElement args, AgentContext context)
     {
-        if (!args.TryGetProperty("file_path", out var fp))
+        if (!args.SafeTryGetProperty("file_path", out var fp))
             return ToolResult.Fail("'file_path' is required for b64file action");
-        var path = fp.GetString() ?? "";
+        var path = fp.SafeGetString() ?? "";
         if (!Path.IsPathRooted(path)) path = Path.Combine(context.WorkFolder, path);
         if (!File.Exists(path)) return ToolResult.Fail($"File not found: {path}");