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

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

@@ -50,8 +50,8 @@ public class SqlTool : IAgentTool
 
     public Task<ToolResult> ExecuteAsync(JsonElement args, AgentContext context, CancellationToken ct = default)
     {
-        var action = args.GetProperty("action").GetString() ?? "";
-        var dbPath = args.GetProperty("db_path").GetString() ?? "";
+        var action = args.GetProperty("action").SafeGetString() ?? "";
+        var dbPath = args.GetProperty("db_path").SafeGetString() ?? "";
 
         if (!Path.IsPathRooted(dbPath))
             dbPath = Path.Combine(context.WorkFolder, dbPath);
@@ -86,10 +86,10 @@ public class SqlTool : IAgentTool
 
     private static ToolResult QueryAction(SqliteConnection conn, JsonElement args)
     {
-        if (!args.TryGetProperty("sql", out var sqlProp))
+        if (!args.SafeTryGetProperty("sql", out var sqlProp))
             return ToolResult.Fail("'sql' parameter is required for query action");
 
-        var sql = sqlProp.GetString() ?? "";
+        var sql = sqlProp.SafeGetString() ?? "";
 
         // SELECT만 허용
         if (!sql.TrimStart().StartsWith("SELECT", StringComparison.OrdinalIgnoreCase) &&
@@ -97,8 +97,8 @@ public class SqlTool : IAgentTool
             !sql.TrimStart().StartsWith("PRAGMA", StringComparison.OrdinalIgnoreCase))
             return ToolResult.Fail("Query action only allows SELECT/WITH/PRAGMA statements. Use 'execute' for modifications.");
 
-        var maxRows = args.TryGetProperty("max_rows", out var mr) && int.TryParse(mr.GetString(), out var mrv)
-            ? Math.Min(mrv, 1000) : 100;
+        var maxRows = args.SafeTryGetProperty("max_rows", out var mr)
+            ? Math.Min(mr.SafeGetInt32(100), 1000) : 100;
 
         using var cmd = conn.CreateCommand();
         cmd.CommandText = sql;
@@ -135,10 +135,10 @@ public class SqlTool : IAgentTool
 
     private static ToolResult ExecuteAction(SqliteConnection conn, JsonElement args)
     {
-        if (!args.TryGetProperty("sql", out var sqlProp))
+        if (!args.SafeTryGetProperty("sql", out var sqlProp))
             return ToolResult.Fail("'sql' parameter is required for execute action");
 
-        var sql = sqlProp.GetString() ?? "";
+        var sql = sqlProp.SafeGetString() ?? "";
 
         // DDL/DML만 허용 (DROP DATABASE 등 위험 명령 차단)
         var trimmed = sql.TrimStart().ToUpperInvariant();