Add readFile line range support, startup optimization, and cleanup unused imports

- McpTools.readFile: add optional startLine/endLine params for reading specific
  line ranges from source files (1-based, inclusive)
- GraphController /api/file: add startLine/endLine query params matching MCP tool
- application.yml: enable lazy-initialization for indexing profile to speed up
  CLI commands that don't need full Spring context (e.g. version, plugins)
- QueryService: remove unused imports (Arrays, HashMap, EdgeKind, NodeKind)
- Add tests for line range reading in both McpToolsTest and GraphControllerTest

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: aksOps

src/main/java/io/github/randomcodespace/iq/api/GraphController.java

@@ -201,7 +201,10 @@ public List<Map<String, Object>> searchGraph(
     }
 
     @GetMapping("/file")
-    public ResponseEntity<String> readFile(@RequestParam String path) {
+    public ResponseEntity<String> readFile(
+            @RequestParam String path,
+            @RequestParam(required = false) Integer startLine,
+            @RequestParam(required = false) Integer endLine) {
         Path codebasePath = Path.of(config.getRootPath()).toAbsolutePath().normalize();
         Path resolved = codebasePath.resolve(path).normalize();
         if (!resolved.startsWith(codebasePath)) {
@@ -214,6 +217,19 @@ public ResponseEntity<String> readFile(@RequestParam String path) {
         }
         try {
             String content = Files.readString(resolved, StandardCharsets.UTF_8);
+            if (startLine != null || endLine != null) {
+                String[] lines = content.split("\n", -1);
+                int start = (startLine != null ? startLine : 1);
+                int end = (endLine != null ? endLine : lines.length);
+                start = Math.max(1, Math.min(start, lines.length));
+                end = Math.max(start, Math.min(end, lines.length));
+                StringBuilder sb = new StringBuilder();
+                for (int i = start - 1; i < end; i++) {
+                    if (i > start - 1) sb.append('\n');
+                    sb.append(lines[i]);
+                }
+                content = sb.toString();
+            }
             return ResponseEntity.ok()
                     .contentType(MediaType.TEXT_PLAIN)
                     .body(content);

src/main/java/io/github/randomcodespace/iq/mcp/McpTools.java

@@ -267,17 +267,34 @@ public String searchGraph(
         return toJson(queryService.searchGraph(query, limit != null ? limit : 20));
     }
 
-    @Tool(name = "read_file", description = "Read a source file's content for deep analysis. Path is relative to the codebase root.")
+    @Tool(name = "read_file", description = "Read a source file from the codebase, optionally a specific line range")
     public String readFile(
-            @ToolParam(description = "File path relative to codebase root") String filePath) {
+            @ToolParam(description = "File path relative to codebase root") String filePath,
+            @ToolParam(description = "Start line (1-based, optional)", required = false) Integer startLine,
+            @ToolParam(description = "End line (1-based, inclusive, optional)", required = false) Integer endLine) {
         try {
             Path root = Path.of(config.getRootPath()).toAbsolutePath().normalize();
             Path resolved = root.resolve(filePath).normalize();
             // Path traversal protection
             if (!resolved.startsWith(root)) {
                 return "Error: Path traversal detected";
             }
-            return java.nio.file.Files.readString(resolved, java.nio.charset.StandardCharsets.UTF_8);
+            String content = java.nio.file.Files.readString(resolved, java.nio.charset.StandardCharsets.UTF_8);
+            if (startLine != null || endLine != null) {
+                String[] lines = content.split("\n", -1);
+                int start = (startLine != null ? startLine : 1);
+                int end = (endLine != null ? endLine : lines.length);
+                // Clamp bounds
+                start = Math.max(1, Math.min(start, lines.length));
+                end = Math.max(start, Math.min(end, lines.length));
+                StringBuilder sb = new StringBuilder();
+                for (int i = start - 1; i < end; i++) {
+                    if (i > start - 1) sb.append('\n');
+                    sb.append(lines[i]);
+                }
+                return sb.toString();
+            }
+            return content;
         } catch (Exception e) {
             return "Error: " + e.getMessage();
         }

src/main/java/io/github/randomcodespace/iq/query/QueryService.java

@@ -4,14 +4,10 @@
 import io.github.randomcodespace.iq.graph.GraphStore;
 import io.github.randomcodespace.iq.model.CodeEdge;
 import io.github.randomcodespace.iq.model.CodeNode;
-import io.github.randomcodespace.iq.model.EdgeKind;
-import io.github.randomcodespace.iq.model.NodeKind;
 import org.springframework.cache.annotation.Cacheable;
 import org.springframework.stereotype.Service;
 
 import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.HashMap;
 import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;

src/main/resources/application.yml

@@ -25,6 +25,7 @@ codeiq:
     path: ".osscodeiq/graph.db"
   max-depth: 10
   max-radius: 10
+  batch-size: 500
 
 spring.ai.mcp.server:
   name: code-iq
@@ -36,10 +37,16 @@ spring:
   config:
     activate:
       on-profile: indexing
+  main:
+    lazy-initialization: true
   autoconfigure:
     exclude:
       - org.springframework.ai.mcp.server.autoconfigure.McpServerAutoConfiguration
 
+codeiq:
+  neo4j:
+    enabled: false
+
 ---
 spring:
   config:

src/test/java/io/github/randomcodespace/iq/api/GraphControllerTest.java

@@ -456,6 +456,34 @@ void readFileShouldBlockPathTraversal(@TempDir Path tempDir) throws Exception {
                 .andExpect(content().string("Path traversal blocked"));
     }
 
+    @Test
+    void readFileShouldReturnLineRange(@TempDir Path tempDir) throws Exception {
+        Files.writeString(tempDir.resolve("multi.txt"), "line1\nline2\nline3\nline4\nline5",
+                StandardCharsets.UTF_8);
+        config.setRootPath(tempDir.toAbsolutePath().toString());
+        var controller = new GraphController(queryService, analyzer, config, statsService);
+        var fileMvc = MockMvcBuilders.standaloneSetup(controller).build();
+
+        fileMvc.perform(get("/api/file")
+                        .param("path", "multi.txt")
+                        .param("startLine", "2")
+                        .param("endLine", "4"))
+                .andExpect(status().isOk())
+                .andExpect(content().string("line2\nline3\nline4"));
+    }
+
+    @Test
+    void readFileShouldReturnFullContentWithoutLineParams(@TempDir Path tempDir) throws Exception {
+        Files.writeString(tempDir.resolve("full.txt"), "aaa\nbbb\nccc", StandardCharsets.UTF_8);
+        config.setRootPath(tempDir.toAbsolutePath().toString());
+        var controller = new GraphController(queryService, analyzer, config, statsService);
+        var fileMvc = MockMvcBuilders.standaloneSetup(controller).build();
+
+        fileMvc.perform(get("/api/file").param("path", "full.txt"))
+                .andExpect(status().isOk())
+                .andExpect(content().string("aaa\nbbb\nccc"));
+    }
+
     // --- /api/analyze ---
 
     @Test

src/test/java/io/github/randomcodespace/iq/mcp/McpToolsTest.java

@@ -485,7 +485,7 @@ void readFileShouldReadContent(@TempDir Path tempDir) throws IOException {
         Path file = tempDir.resolve("test.txt");
         Files.writeString(file, "Hello, World!");
 
-        String result = mcpTools.readFile("test.txt");
+        String result = mcpTools.readFile("test.txt", null, null);
 
         assertEquals("Hello, World!", result);
     }
@@ -494,7 +494,7 @@ void readFileShouldReadContent(@TempDir Path tempDir) throws IOException {
     void readFileShouldRejectPathTraversal(@TempDir Path tempDir) {
         config.setRootPath(tempDir.toString());
 
-        String result = mcpTools.readFile("../../etc/passwd");
+        String result = mcpTools.readFile("../../etc/passwd", null, null);
 
         assertEquals("Error: Path traversal detected", result);
     }
@@ -503,8 +503,52 @@ void readFileShouldRejectPathTraversal(@TempDir Path tempDir) {
     void readFileShouldHandleMissingFile(@TempDir Path tempDir) {
         config.setRootPath(tempDir.toString());
 
-        String result = mcpTools.readFile("nonexistent.txt");
+        String result = mcpTools.readFile("nonexistent.txt", null, null);
 
         assertTrue(result.startsWith("Error:"));
     }
+
+    @Test
+    void readFileShouldReturnLineRange(@TempDir Path tempDir) throws IOException {
+        config.setRootPath(tempDir.toString());
+        Path file = tempDir.resolve("lines.txt");
+        Files.writeString(file, "line1\nline2\nline3\nline4\nline5");
+
+        String result = mcpTools.readFile("lines.txt", 2, 4);
+
+        assertEquals("line2\nline3\nline4", result);
+    }
+
+    @Test
+    void readFileShouldReturnFromStartLineToEnd(@TempDir Path tempDir) throws IOException {
+        config.setRootPath(tempDir.toString());
+        Path file = tempDir.resolve("lines.txt");
+        Files.writeString(file, "line1\nline2\nline3\nline4\nline5");
+
+        String result = mcpTools.readFile("lines.txt", 3, null);
+
+        assertEquals("line3\nline4\nline5", result);
+    }
+
+    @Test
+    void readFileShouldReturnFromStartToEndLine(@TempDir Path tempDir) throws IOException {
+        config.setRootPath(tempDir.toString());
+        Path file = tempDir.resolve("lines.txt");
+        Files.writeString(file, "line1\nline2\nline3\nline4\nline5");
+
+        String result = mcpTools.readFile("lines.txt", null, 2);
+
+        assertEquals("line1\nline2", result);
+    }
+
+    @Test
+    void readFileShouldClampOutOfBoundsLineRange(@TempDir Path tempDir) throws IOException {
+        config.setRootPath(tempDir.toString());
+        Path file = tempDir.resolve("lines.txt");
+        Files.writeString(file, "line1\nline2\nline3");
+
+        String result = mcpTools.readFile("lines.txt", 2, 100);
+
+        assertEquals("line2\nline3", result);
+    }
 }