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

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

@@ -47,7 +47,7 @@ public class EnvTool : IAgentTool
 
     public Task<ToolResult> ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct = default)
     {
-        var action = args.GetProperty("action").GetString() ?? "";
+        var action = args.GetProperty("action").SafeGetString() ?? "";
 
         try
         {
@@ -68,9 +68,9 @@ public class EnvTool : IAgentTool
 
     private static ToolResult Get(JsonElement args)
     {
-        if (!args.TryGetProperty("name", out var n))
+        if (!args.SafeTryGetProperty("name", out var n))
             return ToolResult.Fail("'name' parameter is required for get action");
-        var name = n.GetString() ?? "";
+        var name = n.SafeGetString() ?? "";
         var value = Environment.GetEnvironmentVariable(name);
         return value != null
             ? ToolResult.Ok($"{name}={value}")
@@ -79,20 +79,20 @@ public class EnvTool : IAgentTool
 
     private static ToolResult Set(JsonElement args)
     {
-        if (!args.TryGetProperty("name", out var n))
+        if (!args.SafeTryGetProperty("name", out var n))
             return ToolResult.Fail("'name' parameter is required for set action");
-        if (!args.TryGetProperty("value", out var v))
+        if (!args.SafeTryGetProperty("value", out var v))
             return ToolResult.Fail("'value' parameter is required for set action");
 
-        var name = n.GetString() ?? "";
-        var value = v.GetString() ?? "";
+        var name = n.SafeGetString() ?? "";
+        var value = v.SafeGetString() ?? "";
         Environment.SetEnvironmentVariable(name, value, EnvironmentVariableTarget.Process);
         return ToolResult.Ok($"✓ Set {name}={value} (process scope)");
     }
 
     private static ToolResult ListVars(JsonElement args)
     {
-        var filter = args.TryGetProperty("filter", out var f) ? f.GetString() ?? "" : "";
+        var filter = args.SafeTryGetProperty("filter", out var f) ? f.SafeGetString() ?? "" : "";
         var vars = Environment.GetEnvironmentVariables();
         var entries = new List<string>();
 
@@ -118,9 +118,9 @@ public class EnvTool : IAgentTool
 
     private static ToolResult Expand(JsonElement args)
     {
-        if (!args.TryGetProperty("value", out var v))
+        if (!args.SafeTryGetProperty("value", out var v))
             return ToolResult.Fail("'value' parameter is required for expand action");
-        var input = v.GetString() ?? "";
+        var input = v.SafeGetString() ?? "";
         var expanded = Environment.ExpandEnvironmentVariables(input);
         return ToolResult.Ok(expanded);
     }