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

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

@@ -64,24 +64,24 @@ public class DocumentAssemblerTool : IAgentTool
 
     public async Task<ToolResult> ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct)
     {
-        var path = args.GetProperty("path").GetString() ?? "";
-        var title = args.GetProperty("title").GetString() ?? "Document";
-        var requestedFormat = args.TryGetProperty("format", out var fmt) ? fmt.GetString() ?? "auto" : GetDefaultOutputFormat();
-        var requestedMood = args.TryGetProperty("mood", out var m) ? m.GetString() ?? GetDefaultMood() : GetDefaultMood();
-        var useToc = !args.TryGetProperty("toc", out var tocVal) || tocVal.GetBoolean(); // default true
-        var coverSubtitle = args.TryGetProperty("cover_subtitle", out var cs) ? cs.GetString() : null;
-        var headerText = args.TryGetProperty("header", out var hdr) ? hdr.GetString() : null;
-        var footerText = args.TryGetProperty("footer", out var ftr) ? ftr.GetString() : null;
+        var path = args.GetProperty("path").SafeGetString() ?? "";
+        var title = args.GetProperty("title").SafeGetString() ?? "Document";
+        var requestedFormat = args.SafeTryGetProperty("format", out var fmt) ? fmt.SafeGetString() ?? "auto" : GetDefaultOutputFormat();
+        var requestedMood = args.SafeTryGetProperty("mood", out var m) ? m.SafeGetString() ?? GetDefaultMood() : GetDefaultMood();
+        var useToc = !args.SafeTryGetProperty("toc", out var tocVal) || tocVal.GetBoolean(); // default true
+        var coverSubtitle = args.SafeTryGetProperty("cover_subtitle", out var cs) ? cs.SafeGetString() : null;
+        var headerText = args.SafeTryGetProperty("header", out var hdr) ? hdr.SafeGetString() : null;
+        var footerText = args.SafeTryGetProperty("footer", out var ftr) ? ftr.SafeGetString() : null;
 
-        if (!args.TryGetProperty("sections", out var sectionsEl) || sectionsEl.ValueKind != JsonValueKind.Array)
+        if (!args.SafeTryGetProperty("sections", out var sectionsEl) || sectionsEl.ValueKind != JsonValueKind.Array)
             return ToolResult.Fail("sections 배열이 필요합니다.");
 
         var sections = new List<(string Heading, string Content, int Level)>();
         foreach (var sec in sectionsEl.EnumerateArray())
         {
-            var heading = sec.TryGetProperty("heading", out var h) ? h.GetString() ?? "" : "";
-            var content = sec.TryGetProperty("content", out var c) ? c.GetString() ?? "" : "";
-            var level = sec.TryGetProperty("level", out var lv) ? lv.GetInt32() : 1;
+            var heading = sec.SafeTryGetProperty("heading", out var h) ? h.SafeGetString() ?? "" : "";
+            var content = sec.SafeTryGetProperty("content", out var c) ? c.SafeGetString() ?? "" : "";
+            var level = sec.SafeTryGetProperty("level", out var lv) ? lv.GetInt32() : 1;
             if (!string.IsNullOrWhiteSpace(heading) || !string.IsNullOrWhiteSpace(content))
                 sections.Add((heading, content, level));
         }