techunter 0.1.10 → 0.1.11

package/dist/index.js

@@ -882,7 +882,7 @@ AI model set to: ${val.trim()}
 init_github();
 
 // src/lib/agent.ts
-import ora15 from "ora";
+import ora14 from "ora";
 import chalk13 from "chalk";
 
 // src/tools/pick/index.ts
@@ -1148,7 +1148,7 @@ ${issue.body ?? "(none)"}
 
 Diff:
 ${diff || "(no changes)"}`,
-    ["run_command", "read_file", "get_diff"]
+    ["run_command", "grep_code", "get_diff"]
   );
 }
 
@@ -1662,9 +1662,9 @@ Previous guide:
 ${revise.previousGuide}` : `Write an implementation guide for this task: "${title}"`;
   return runSubAgentLoop(
     config,
-    "You are a senior engineer writing a brief task guide for a developer. Use scan_project and read_file to identify which files are relevant. Do NOT include code snippets or implementation details. When you have enough context, write the guide.\n\n" + GUIDE_FORMAT,
+    "You are a senior engineer writing a brief task guide for a developer. Use list_files then grep_code to identify which files are relevant. Do NOT include code snippets or implementation details. When you have enough context, write the guide.\n\n" + GUIDE_FORMAT,
     userMessage,
-    ["scan_project", "read_file", "run_command", "ask_user"]
+    ["list_files", "grep_code", "run_command", "ask_user"]
   );
 }
 
@@ -2034,10 +2034,10 @@ Clear instruction on what to fix and how to re-submit (via /submit).
 async function generateRejectionComment(config, issueNumber, userFeedback) {
   return runSubAgentLoop(
     config,
-    "You are a senior engineer writing a structured code review rejection comment. Use get_task to read the acceptance criteria, get_diff or read_file to inspect the implementation, and get_comments to see prior discussion. Then write the rejection comment.\n\n" + REJECTION_FORMAT,
+    "You are a senior engineer writing a structured code review rejection comment. Use get_task to read the acceptance criteria, get_diff or grep_code to inspect the implementation, and get_comments to see prior discussion. Then write the rejection comment.\n\n" + REJECTION_FORMAT,
     `Write a rejection comment for issue #${issueNumber}.
 Reviewer feedback: ${userFeedback}`,
-    ["get_task", "get_comments", "get_diff", "read_file"]
+    ["get_task", "get_comments", "get_diff", "grep_code"]
   );
 }
 
@@ -2580,20 +2580,34 @@ ${out || e.message}`;
   }
 }
 
-// src/tools/scan-project/index.ts
-var scan_project_exports = {};
-__export(scan_project_exports, {
+// src/tools/list-files/index.ts
+var list_files_exports = {};
+__export(list_files_exports, {
   definition: () => definition17,
   execute: () => execute17
 });
-import ora14 from "ora";
-
-// src/lib/project.ts
 import { readFile as readFile2 } from "fs/promises";
 import { existsSync } from "fs";
 import path2 from "path";
 import { globby } from "globby";
 import ignore from "ignore";
+var definition17 = {
+  type: "function",
+  function: {
+    name: "list_files",
+    description: "List file paths in the project. Use this first to orient yourself before searching or reading.",
+    parameters: {
+      type: "object",
+      properties: {
+        glob: {
+          type: "string",
+          description: 'Glob pattern to filter results, e.g. "src/**/*.ts". Defaults to all text files.'
+        }
+      },
+      required: []
+    }
+  }
+};
 var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".png",
   ".jpg",
@@ -2606,213 +2620,199 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".zip",
   ".tar",
   ".gz",
-  ".bz2",
-  ".rar",
   ".exe",
   ".dll",
-  ".so",
-  ".dylib",
   ".woff",
   ".woff2",
   ".ttf",
-  ".otf",
-  ".eot",
   ".mp3",
   ".mp4",
-  ".wav",
-  ".avi",
-  ".mov",
   ".db",
   ".sqlite",
   ".lock"
 ]);
-var ALWAYS_READ = [
-  "README.md",
-  "README.txt",
-  "README",
-  "package.json",
-  "pyproject.toml",
-  "go.mod",
-  "Cargo.toml",
-  "tsconfig.json",
-  "vite.config.ts",
-  "vite.config.js",
-  "webpack.config.js",
-  "rollup.config.js",
-  ".env.example",
-  "docker-compose.yml",
-  "Dockerfile"
-];
-var MAX_TOTAL_BYTES = 8e4;
-var MAX_FILE_BYTES = 15e3;
-async function buildIgnoreFilter(cwd) {
+async function execute17(input3, _config) {
+  const glob = input3["glob"] ?? "**/*";
+  const cwd = process.cwd();
   const ig = ignore();
   const gitignorePath = path2.join(cwd, ".gitignore");
   if (existsSync(gitignorePath)) {
-    const content = await readFile2(gitignorePath, "utf-8");
-    ig.add(content);
-  }
-  ig.add(["node_modules", "dist", ".git", ".next", "__pycache__", "*.pyc", "build", "coverage"]);
-  return ig;
-}
-async function safeReadFile(filePath, maxBytes = MAX_FILE_BYTES) {
-  try {
-    const content = await readFile2(filePath, "utf-8");
-    if (content.length > maxBytes) {
-      return content.slice(0, maxBytes) + `
-... (truncated at ${maxBytes} chars)`;
-    }
-    return content;
-  } catch {
-    return null;
-  }
-}
-function isBinaryFile(filePath) {
-  const ext = path2.extname(filePath).toLowerCase();
-  return BINARY_EXTENSIONS.has(ext);
-}
-function buildFileTree(files) {
-  const tree = {};
-  for (const file of files) {
-    const dir = path2.dirname(file);
-    if (!tree[dir]) tree[dir] = [];
-    tree[dir].push(path2.basename(file));
-  }
-  const lines = [];
-  const rootFiles = tree["."] ?? [];
-  for (const f of rootFiles) lines.push(f);
-  const dirs = Object.keys(tree).filter((d) => d !== ".").sort();
-  for (const dir of dirs) {
-    lines.push(`${dir}/`);
-    for (const f of tree[dir]) {
-      lines.push(`  ${f}`);
-    }
-  }
-  return lines.join("\n");
-}
-function scoreRelevance(filePath, keywords) {
-  const lower = filePath.toLowerCase();
-  let score = 0;
-  for (const kw of keywords) {
-    if (lower.includes(kw)) score += 1;
-  }
-  return score;
-}
-async function buildProjectContext(cwd, issueTitle, issueBody) {
-  const ig = await buildIgnoreFilter(cwd);
-  const allFiles = await globby("**/*", {
-    cwd,
-    gitignore: false,
-    // We handle ignore ourselves
-    dot: false,
-    onlyFiles: true
-  });
-  const filtered = allFiles.filter((f) => !ig.ignores(f) && !isBinaryFile(f));
-  const fileTree = buildFileTree(filtered);
-  const issueText = `${issueTitle} ${issueBody}`.toLowerCase();
-  const keywords = issueText.replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter((w) => w.length > 3);
-  const keyFiles = {};
-  let totalBytes = 0;
-  for (const always of ALWAYS_READ) {
-    if (totalBytes >= MAX_TOTAL_BYTES) break;
-    const fullPath = path2.join(cwd, always);
-    if (!existsSync(fullPath)) continue;
-    const content = await safeReadFile(fullPath);
-    if (content !== null) {
-      keyFiles[always] = content;
-      totalBytes += content.length;
-    }
-  }
-  const scored = filtered.filter((f) => !ALWAYS_READ.includes(f) && !ALWAYS_READ.includes(path2.basename(f))).map((f) => ({ file: f, score: scoreRelevance(f, keywords) })).filter((x) => x.score > 0).sort((a, b) => b.score - a.score).slice(0, 10);
-  for (const { file } of scored) {
-    if (totalBytes >= MAX_TOTAL_BYTES) break;
-    const fullPath = path2.join(cwd, file);
-    const content = await safeReadFile(fullPath);
-    if (content !== null) {
-      keyFiles[file] = content;
-      totalBytes += content.length;
-    }
-  }
-  return { fileTree, keyFiles };
-}
-
-// src/tools/scan-project/index.ts
-var definition17 = {
-  type: "function",
-  function: {
-    name: "scan_project",
-    description: "Scan the current project directory: returns the file tree and contents of the most relevant files. Call this when creating a new task to understand the codebase before writing the task body and guide.",
-    parameters: {
-      type: "object",
-      properties: {
-        focus: {
-          type: "string",
-          description: "Keywords describing the task. Used to prioritise which files to read."
-        }
-      },
-      required: []
-    }
-  }
-};
-async function execute17(input3, _config) {
-  const focus = input3["focus"] ?? "";
-  const spinner = ora14("Scanning project...").start();
-  try {
-    const cwd = process.cwd();
-    const context = await buildProjectContext(cwd, focus, "");
-    spinner.stop();
-    const fileCount = context.fileTree.split("\n").filter(Boolean).length;
-    const readCount = Object.keys(context.keyFiles).length;
-    const totalBytes = Object.values(context.keyFiles).reduce((s, c) => s + c.length, 0);
-    const summary = `Scanned ${fileCount} files \xB7 ${readCount} read \xB7 ${(totalBytes / 1024).toFixed(1)} KB`;
-    const parts = [summary, `## File tree
-\`\`\`
-${context.fileTree}
-\`\`\``];
-    for (const [filePath, content] of Object.entries(context.keyFiles)) {
-      parts.push(`## ${filePath}
-\`\`\`
-${content}
-\`\`\``);
-    }
-    return parts.join("\n\n");
-  } catch (err) {
-    spinner.stop();
-    throw err;
+    ig.add(await readFile2(gitignorePath, "utf-8"));
   }
+  ig.add(["node_modules", "dist", ".git", ".next", "__pycache__", "build", "coverage"]);
+  const files = await globby(glob, { cwd, dot: false, onlyFiles: true, gitignore: false });
+  const filtered = files.filter((f) => !ig.ignores(f) && !BINARY_EXTENSIONS.has(path2.extname(f).toLowerCase()));
+  if (filtered.length === 0) return `No files matched: ${glob}`;
+  return `${filtered.length} file(s):
+${filtered.join("\n")}`;
 }
 
-// src/tools/read-file/index.ts
-var read_file_exports = {};
-__export(read_file_exports, {
+// src/tools/grep-code/index.ts
+var grep_code_exports = {};
+__export(grep_code_exports, {
   definition: () => definition18,
   execute: () => execute18
 });
 import { readFile as readFile3 } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
 import path3 from "path";
+import { globby as globby2 } from "globby";
+import ignore2 from "ignore";
 var definition18 = {
   type: "function",
   function: {
-    name: "read_file",
-    description: "Read the full contents of a specific file in the project.",
+    name: "grep_code",
+    description: "Search for a pattern across files, or read a specific line range from a file.\n- Search mode: provide `pattern` \u2014 returns matching lines with context.\n- Read-range mode: provide `file_glob` (single file) + `start_line` + `end_line`, no `pattern` \u2014 read an exact section. Use after grep has given you line numbers.",
     parameters: {
       type: "object",
       properties: {
-        path: { type: "string", description: "File path relative to the project root" }
+        pattern: {
+          type: "string",
+          description: "Regex or plain text to search for (case-insensitive). Omit for read-range mode."
+        },
+        file_glob: {
+          type: "string",
+          description: 'Glob to restrict which files to search or read, e.g. "src/**/*.ts" or "src/lib/agent.ts". Defaults to all text files.'
+        },
+        context_lines: {
+          type: "number",
+          description: "Lines of context before/after each match (search mode only). Default: 2."
+        },
+        max_results: {
+          type: "number",
+          description: "Max matches to return (search mode only). Default: 50."
+        },
+        start_line: {
+          type: "number",
+          description: "First line to read, 1-based (read-range mode). Requires file_glob pointing to a single file."
+        },
+        end_line: {
+          type: "number",
+          description: "Last line to read, 1-based (read-range mode)."
+        }
       },
-      required: ["path"]
+      required: []
     }
   }
 };
+async function buildIgnore(cwd) {
+  const ig = ignore2();
+  const gitignorePath = path3.join(cwd, ".gitignore");
+  if (existsSync2(gitignorePath)) {
+    ig.add(await readFile3(gitignorePath, "utf-8"));
+  }
+  ig.add(["node_modules", "dist", ".git", ".next", "__pycache__", "build", "coverage"]);
+  return ig;
+}
+var BINARY_EXTENSIONS2 = /* @__PURE__ */ new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".svg",
+  ".ico",
+  ".webp",
+  ".pdf",
+  ".zip",
+  ".tar",
+  ".gz",
+  ".exe",
+  ".dll",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".mp3",
+  ".mp4",
+  ".db",
+  ".sqlite",
+  ".lock"
+]);
+function isText(f) {
+  return !BINARY_EXTENSIONS2.has(path3.extname(f).toLowerCase());
+}
+var MAX_RANGE_LINES = 300;
 async function execute18(input3, _config) {
-  const filePath = input3["path"];
+  const pattern = input3["pattern"] ?? "";
+  const fileGlob = input3["file_glob"] ?? "**/*";
+  const contextLines = Math.min(input3["context_lines"] ?? 2, 5);
+  const maxResults = Math.min(input3["max_results"] ?? 50, 200);
+  const startLine = input3["start_line"];
+  const endLine = input3["end_line"];
+  const cwd = process.cwd();
+  if (!pattern && startLine != null && endLine != null) {
+    const files = await globby2(fileGlob, { cwd, dot: false, onlyFiles: true, gitignore: false });
+    if (files.length === 0) return `No file matched: ${fileGlob}`;
+    if (files.length > 1) return `file_glob matched ${files.length} files \u2014 narrow it to a single file for read-range mode.`;
+    const raw = await readFile3(path3.join(cwd, files[0]), "utf-8");
+    const lines = raw.split("\n");
+    const total = lines.length;
+    const from = Math.max(1, startLine);
+    const to = Math.min(total, endLine, from + MAX_RANGE_LINES - 1);
+    const numbered = lines.slice(from - 1, to).map((l, i) => `${String(from + i).padStart(5)}: ${l}`).join("\n");
+    const truncNote = to < Math.min(total, endLine) ? `
+\u2026 (use start_line=${to + 1} to continue)` : "";
+    return `${files[0]} \u2014 lines ${from}\u2013${to} of ${total}:
+\`\`\`
+${numbered}
+\`\`\`${truncNote}`;
+  }
+  if (!pattern) return "Provide a `pattern` to search, or `start_line` + `end_line` for read-range mode. Use list_files to browse file paths.";
+  const ig = await buildIgnore(cwd);
+  let regex;
   try {
-    const fullPath = path3.join(process.cwd(), filePath);
-    const content = await readFile3(fullPath, "utf-8");
-    return content.length > 15e3 ? content.slice(0, 15e3) + "\n\n... (truncated)" : content;
-  } catch (err) {
-    return `Error reading file: ${err.message}`;
+    regex = new RegExp(pattern, "i");
+  } catch {
+    regex = new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "i");
+  }
+  const allFiles = await globby2(fileGlob, { cwd, dot: false, onlyFiles: true, gitignore: false });
+  const filtered = allFiles.filter((f) => !ig.ignores(f) && isText(f));
+  const matches = [];
+  let totalMatches = 0;
+  for (const file of filtered) {
+    if (totalMatches >= maxResults) break;
+    let content;
+    try {
+      content = await readFile3(path3.join(cwd, file), "utf-8");
+    } catch {
+      continue;
+    }
+    const lines = content.split("\n");
+    const hitLines = [];
+    for (let i = 0; i < lines.length; i++) {
+      if (regex.test(lines[i])) hitLines.push(i);
+    }
+    if (hitLines.length === 0) continue;
+    const ranges = [];
+    for (const hit of hitLines) {
+      const s = Math.max(0, hit - contextLines);
+      const e = Math.min(lines.length - 1, hit + contextLines);
+      if (ranges.length > 0 && s <= ranges[ranges.length - 1][1] + 1) {
+        ranges[ranges.length - 1][1] = e;
+      } else {
+        ranges.push([s, e]);
+      }
+    }
+    const snippets = [];
+    for (const [s, e] of ranges) {
+      if (totalMatches >= maxResults) break;
+      snippets.push(
+        lines.slice(s, e + 1).map((l, i) => {
+          const n = s + i + 1;
+          return `${regex.test(l) ? ">" : " "} ${String(n).padStart(4)}: ${l}`;
+        }).join("\n")
+      );
+      totalMatches += hitLines.filter((h) => h >= s && h <= e).length;
+    }
+    if (snippets.length > 0) {
+      matches.push(`## ${file}
+\`\`\`
+${snippets.join("\n---\n")}
+\`\`\``);
+    }
   }
+  if (matches.length === 0) return `No matches found for: ${pattern}`;
+  const header = `Found matches in ${matches.length} file(s) (${totalMatches} match${totalMatches === 1 ? "" : "es"})${totalMatches >= maxResults ? " \u2014 limit reached" : ""}:`;
+  return [header, ...matches].join("\n\n");
 }
 
 // src/tools/ask-user/index.ts
@@ -2890,13 +2890,33 @@ var toolModules = [
   get_comments_exports,
   get_diff_exports,
   run_command_exports,
-  scan_project_exports,
-  read_file_exports,
+  list_files_exports,
+  grep_code_exports,
   ask_user_exports
 ];
 
 // src/lib/agent.ts
 var tools = toolModules.map((m) => m.definition);
+var HISTORY_KEEP_TURNS = 8;
+function trimHistory(messages) {
+  const userIndices = messages.map((m, i) => m.role === "user" ? i : -1).filter((i) => i !== -1);
+  if (userIndices.length <= HISTORY_KEEP_TURNS) return;
+  const compressBefore = userIndices[userIndices.length - HISTORY_KEEP_TURNS];
+  const compressed = [];
+  for (let t = 0; t < userIndices.length - HISTORY_KEEP_TURNS; t++) {
+    const start = userIndices[t];
+    const end = t + 1 < userIndices.length ? userIndices[t + 1] : compressBefore;
+    const turnMessages = messages.slice(start, end);
+    compressed.push(turnMessages[0]);
+    const lastAssistant = [...turnMessages].reverse().find(
+      (m) => m.role === "assistant" && typeof m.content === "string" && !!m.content
+    );
+    if (lastAssistant) {
+      compressed.push({ role: "assistant", content: lastAssistant.content });
+    }
+  }
+  messages.splice(0, compressBefore, ...compressed);
+}
 async function executeTool(name, input3, config) {
   const mod = toolModules.find((m) => m.definition.function.name === name);
   if (!mod) return `Unknown tool: ${name}`;
@@ -2922,9 +2942,14 @@ async function runAgentLoop(config, messages) {
       "## Tool philosophy",
       "Command tools (pick, new_task, close, submit, my_status, review, refresh, open_code) run",
       "hardcoded interactive flows \u2014 always use these for user-facing actions.",
-      "Low-level tools are for reasoning: run_command, scan_project, read_file, ask_user,",
+      "Low-level tools are for reasoning: run_command, grep_code, ask_user,",
       "get_task, get_comments, get_diff.",
       "",
+      "## Exploring the codebase",
+      "1. list_files \u2014 see all files or filter by glob to orient yourself.",
+      "2. grep_code(pattern) \u2014 find where functions/variables appear.",
+      "3. grep_code(file_glob, start_line, end_line) \u2014 read a specific section after grep gives you line numbers.",
+      "",
       "## Creating a task",
       "If the task description is vague, call ask_user to clarify (max 3 times).",
       "Then call new_task with the title \u2014 the tool scans the project and generates the guide automatically.",
@@ -2955,7 +2980,8 @@ async function runAgentLoop(config, messages) {
     if (++iterations > MAX_ITERATIONS) {
       throw new Error(`Agent exceeded ${MAX_ITERATIONS} iterations without finishing.`);
     }
-    const spinner = ora15({ text: chalk13.dim("Thinking\u2026"), color: "cyan" }).start();
+    trimHistory(messages);
+    const spinner = ora14({ text: chalk13.dim("Thinking\u2026"), color: "cyan" }).start();
     let response;
     try {
       response = await client.chat.completions.create({
@@ -3113,8 +3139,8 @@ async function initNewRepo(config, owner, repo) {
     github: { owner, repo }
   };
   setConfig({ github: newConfig.github });
-  const ora16 = (await import("ora")).default;
-  const spinner = ora16("Creating Techunter labels...").start();
+  const ora15 = (await import("ora")).default;
+  const spinner = ora15("Creating Techunter labels...").start();
   try {
     await ensureLabels(newConfig);
     spinner.succeed("Labels ready");

package/dist/mcp.js

@@ -852,7 +852,7 @@ ${issue.body ?? "(none)"}
 
 Diff:
 ${diff || "(no changes)"}`,
-    ["run_command", "read_file", "get_diff"]
+    ["run_command", "grep_code", "get_diff"]
   );
 }
 
@@ -1366,9 +1366,9 @@ Previous guide:
 ${revise.previousGuide}` : `Write an implementation guide for this task: "${title}"`;
   return runSubAgentLoop(
     config,
-    "You are a senior engineer writing a brief task guide for a developer. Use scan_project and read_file to identify which files are relevant. Do NOT include code snippets or implementation details. When you have enough context, write the guide.\n\n" + GUIDE_FORMAT,
+    "You are a senior engineer writing a brief task guide for a developer. Use list_files then grep_code to identify which files are relevant. Do NOT include code snippets or implementation details. When you have enough context, write the guide.\n\n" + GUIDE_FORMAT,
     userMessage,
-    ["scan_project", "read_file", "run_command", "ask_user"]
+    ["list_files", "grep_code", "run_command", "ask_user"]
   );
 }
 
@@ -1738,10 +1738,10 @@ Clear instruction on what to fix and how to re-submit (via /submit).
 async function generateRejectionComment(config, issueNumber, userFeedback) {
   return runSubAgentLoop(
     config,
-    "You are a senior engineer writing a structured code review rejection comment. Use get_task to read the acceptance criteria, get_diff or read_file to inspect the implementation, and get_comments to see prior discussion. Then write the rejection comment.\n\n" + REJECTION_FORMAT,
+    "You are a senior engineer writing a structured code review rejection comment. Use get_task to read the acceptance criteria, get_diff or grep_code to inspect the implementation, and get_comments to see prior discussion. Then write the rejection comment.\n\n" + REJECTION_FORMAT,
     `Write a rejection comment for issue #${issueNumber}.
 Reviewer feedback: ${userFeedback}`,
-    ["get_task", "get_comments", "get_diff", "read_file"]
+    ["get_task", "get_comments", "get_diff", "grep_code"]
   );
 }
 
@@ -2284,20 +2284,34 @@ ${out || e.message}`;
   }
 }
 
-// src/tools/scan-project/index.ts
-var scan_project_exports = {};
-__export(scan_project_exports, {
+// src/tools/list-files/index.ts
+var list_files_exports = {};
+__export(list_files_exports, {
   definition: () => definition17,
   execute: () => execute17
 });
-import ora13 from "ora";
-
-// src/lib/project.ts
 import { readFile as readFile2 } from "fs/promises";
 import { existsSync } from "fs";
 import path2 from "path";
 import { globby } from "globby";
 import ignore from "ignore";
+var definition17 = {
+  type: "function",
+  function: {
+    name: "list_files",
+    description: "List file paths in the project. Use this first to orient yourself before searching or reading.",
+    parameters: {
+      type: "object",
+      properties: {
+        glob: {
+          type: "string",
+          description: 'Glob pattern to filter results, e.g. "src/**/*.ts". Defaults to all text files.'
+        }
+      },
+      required: []
+    }
+  }
+};
 var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".png",
   ".jpg",
@@ -2310,213 +2324,199 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".zip",
   ".tar",
   ".gz",
-  ".bz2",
-  ".rar",
   ".exe",
   ".dll",
-  ".so",
-  ".dylib",
   ".woff",
   ".woff2",
   ".ttf",
-  ".otf",
-  ".eot",
   ".mp3",
   ".mp4",
-  ".wav",
-  ".avi",
-  ".mov",
   ".db",
   ".sqlite",
   ".lock"
 ]);
-var ALWAYS_READ = [
-  "README.md",
-  "README.txt",
-  "README",
-  "package.json",
-  "pyproject.toml",
-  "go.mod",
-  "Cargo.toml",
-  "tsconfig.json",
-  "vite.config.ts",
-  "vite.config.js",
-  "webpack.config.js",
-  "rollup.config.js",
-  ".env.example",
-  "docker-compose.yml",
-  "Dockerfile"
-];
-var MAX_TOTAL_BYTES = 8e4;
-var MAX_FILE_BYTES = 15e3;
-async function buildIgnoreFilter(cwd) {
+async function execute17(input, _config) {
+  const glob = input["glob"] ?? "**/*";
+  const cwd = process.cwd();
   const ig = ignore();
   const gitignorePath = path2.join(cwd, ".gitignore");
   if (existsSync(gitignorePath)) {
-    const content = await readFile2(gitignorePath, "utf-8");
-    ig.add(content);
+    ig.add(await readFile2(gitignorePath, "utf-8"));
   }
-  ig.add(["node_modules", "dist", ".git", ".next", "__pycache__", "*.pyc", "build", "coverage"]);
-  return ig;
-}
-async function safeReadFile(filePath, maxBytes = MAX_FILE_BYTES) {
-  try {
-    const content = await readFile2(filePath, "utf-8");
-    if (content.length > maxBytes) {
-      return content.slice(0, maxBytes) + `
-... (truncated at ${maxBytes} chars)`;
-    }
-    return content;
-  } catch {
-    return null;
-  }
-}
-function isBinaryFile(filePath) {
-  const ext = path2.extname(filePath).toLowerCase();
-  return BINARY_EXTENSIONS.has(ext);
-}
-function buildFileTree(files) {
-  const tree = {};
-  for (const file of files) {
-    const dir = path2.dirname(file);
-    if (!tree[dir]) tree[dir] = [];
-    tree[dir].push(path2.basename(file));
-  }
-  const lines = [];
-  const rootFiles = tree["."] ?? [];
-  for (const f of rootFiles) lines.push(f);
-  const dirs = Object.keys(tree).filter((d) => d !== ".").sort();
-  for (const dir of dirs) {
-    lines.push(`${dir}/`);
-    for (const f of tree[dir]) {
-      lines.push(`  ${f}`);
-    }
-  }
-  return lines.join("\n");
-}
-function scoreRelevance(filePath, keywords) {
-  const lower = filePath.toLowerCase();
-  let score = 0;
-  for (const kw of keywords) {
-    if (lower.includes(kw)) score += 1;
-  }
-  return score;
-}
-async function buildProjectContext(cwd, issueTitle, issueBody) {
-  const ig = await buildIgnoreFilter(cwd);
-  const allFiles = await globby("**/*", {
-    cwd,
-    gitignore: false,
-    // We handle ignore ourselves
-    dot: false,
-    onlyFiles: true
-  });
-  const filtered = allFiles.filter((f) => !ig.ignores(f) && !isBinaryFile(f));
-  const fileTree = buildFileTree(filtered);
-  const issueText = `${issueTitle} ${issueBody}`.toLowerCase();
-  const keywords = issueText.replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter((w) => w.length > 3);
-  const keyFiles = {};
-  let totalBytes = 0;
-  for (const always of ALWAYS_READ) {
-    if (totalBytes >= MAX_TOTAL_BYTES) break;
-    const fullPath = path2.join(cwd, always);
-    if (!existsSync(fullPath)) continue;
-    const content = await safeReadFile(fullPath);
-    if (content !== null) {
-      keyFiles[always] = content;
-      totalBytes += content.length;
-    }
-  }
-  const scored = filtered.filter((f) => !ALWAYS_READ.includes(f) && !ALWAYS_READ.includes(path2.basename(f))).map((f) => ({ file: f, score: scoreRelevance(f, keywords) })).filter((x) => x.score > 0).sort((a, b) => b.score - a.score).slice(0, 10);
-  for (const { file } of scored) {
-    if (totalBytes >= MAX_TOTAL_BYTES) break;
-    const fullPath = path2.join(cwd, file);
-    const content = await safeReadFile(fullPath);
-    if (content !== null) {
-      keyFiles[file] = content;
-      totalBytes += content.length;
-    }
-  }
-  return { fileTree, keyFiles };
+  ig.add(["node_modules", "dist", ".git", ".next", "__pycache__", "build", "coverage"]);
+  const files = await globby(glob, { cwd, dot: false, onlyFiles: true, gitignore: false });
+  const filtered = files.filter((f) => !ig.ignores(f) && !BINARY_EXTENSIONS.has(path2.extname(f).toLowerCase()));
+  if (filtered.length === 0) return `No files matched: ${glob}`;
+  return `${filtered.length} file(s):
+${filtered.join("\n")}`;
 }
 
-// src/tools/scan-project/index.ts
-var definition17 = {
-  type: "function",
-  function: {
-    name: "scan_project",
-    description: "Scan the current project directory: returns the file tree and contents of the most relevant files. Call this when creating a new task to understand the codebase before writing the task body and guide.",
-    parameters: {
-      type: "object",
-      properties: {
-        focus: {
-          type: "string",
-          description: "Keywords describing the task. Used to prioritise which files to read."
-        }
-      },
-      required: []
-    }
-  }
-};
-async function execute17(input, _config) {
-  const focus = input["focus"] ?? "";
-  const spinner = ora13("Scanning project...").start();
-  try {
-    const cwd = process.cwd();
-    const context = await buildProjectContext(cwd, focus, "");
-    spinner.stop();
-    const fileCount = context.fileTree.split("\n").filter(Boolean).length;
-    const readCount = Object.keys(context.keyFiles).length;
-    const totalBytes = Object.values(context.keyFiles).reduce((s, c) => s + c.length, 0);
-    const summary = `Scanned ${fileCount} files \xB7 ${readCount} read \xB7 ${(totalBytes / 1024).toFixed(1)} KB`;
-    const parts = [summary, `## File tree
-\`\`\`
-${context.fileTree}
-\`\`\``];
-    for (const [filePath, content] of Object.entries(context.keyFiles)) {
-      parts.push(`## ${filePath}
-\`\`\`
-${content}
-\`\`\``);
-    }
-    return parts.join("\n\n");
-  } catch (err) {
-    spinner.stop();
-    throw err;
-  }
-}
-
-// src/tools/read-file/index.ts
-var read_file_exports = {};
-__export(read_file_exports, {
+// src/tools/grep-code/index.ts
+var grep_code_exports = {};
+__export(grep_code_exports, {
   definition: () => definition18,
   execute: () => execute18
 });
 import { readFile as readFile3 } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
 import path3 from "path";
+import { globby as globby2 } from "globby";
+import ignore2 from "ignore";
 var definition18 = {
   type: "function",
   function: {
-    name: "read_file",
-    description: "Read the full contents of a specific file in the project.",
+    name: "grep_code",
+    description: "Search for a pattern across files, or read a specific line range from a file.\n- Search mode: provide `pattern` \u2014 returns matching lines with context.\n- Read-range mode: provide `file_glob` (single file) + `start_line` + `end_line`, no `pattern` \u2014 read an exact section. Use after grep has given you line numbers.",
     parameters: {
       type: "object",
       properties: {
-        path: { type: "string", description: "File path relative to the project root" }
+        pattern: {
+          type: "string",
+          description: "Regex or plain text to search for (case-insensitive). Omit for read-range mode."
+        },
+        file_glob: {
+          type: "string",
+          description: 'Glob to restrict which files to search or read, e.g. "src/**/*.ts" or "src/lib/agent.ts". Defaults to all text files.'
+        },
+        context_lines: {
+          type: "number",
+          description: "Lines of context before/after each match (search mode only). Default: 2."
+        },
+        max_results: {
+          type: "number",
+          description: "Max matches to return (search mode only). Default: 50."
+        },
+        start_line: {
+          type: "number",
+          description: "First line to read, 1-based (read-range mode). Requires file_glob pointing to a single file."
+        },
+        end_line: {
+          type: "number",
+          description: "Last line to read, 1-based (read-range mode)."
+        }
       },
-      required: ["path"]
+      required: []
     }
   }
 };
+async function buildIgnore(cwd) {
+  const ig = ignore2();
+  const gitignorePath = path3.join(cwd, ".gitignore");
+  if (existsSync2(gitignorePath)) {
+    ig.add(await readFile3(gitignorePath, "utf-8"));
+  }
+  ig.add(["node_modules", "dist", ".git", ".next", "__pycache__", "build", "coverage"]);
+  return ig;
+}
+var BINARY_EXTENSIONS2 = /* @__PURE__ */ new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".svg",
+  ".ico",
+  ".webp",
+  ".pdf",
+  ".zip",
+  ".tar",
+  ".gz",
+  ".exe",
+  ".dll",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".mp3",
+  ".mp4",
+  ".db",
+  ".sqlite",
+  ".lock"
+]);
+function isText(f) {
+  return !BINARY_EXTENSIONS2.has(path3.extname(f).toLowerCase());
+}
+var MAX_RANGE_LINES = 300;
 async function execute18(input, _config) {
-  const filePath = input["path"];
+  const pattern = input["pattern"] ?? "";
+  const fileGlob = input["file_glob"] ?? "**/*";
+  const contextLines = Math.min(input["context_lines"] ?? 2, 5);
+  const maxResults = Math.min(input["max_results"] ?? 50, 200);
+  const startLine = input["start_line"];
+  const endLine = input["end_line"];
+  const cwd = process.cwd();
+  if (!pattern && startLine != null && endLine != null) {
+    const files = await globby2(fileGlob, { cwd, dot: false, onlyFiles: true, gitignore: false });
+    if (files.length === 0) return `No file matched: ${fileGlob}`;
+    if (files.length > 1) return `file_glob matched ${files.length} files \u2014 narrow it to a single file for read-range mode.`;
+    const raw = await readFile3(path3.join(cwd, files[0]), "utf-8");
+    const lines = raw.split("\n");
+    const total = lines.length;
+    const from = Math.max(1, startLine);
+    const to = Math.min(total, endLine, from + MAX_RANGE_LINES - 1);
+    const numbered = lines.slice(from - 1, to).map((l, i) => `${String(from + i).padStart(5)}: ${l}`).join("\n");
+    const truncNote = to < Math.min(total, endLine) ? `
+\u2026 (use start_line=${to + 1} to continue)` : "";
+    return `${files[0]} \u2014 lines ${from}\u2013${to} of ${total}:
+\`\`\`
+${numbered}
+\`\`\`${truncNote}`;
+  }
+  if (!pattern) return "Provide a `pattern` to search, or `start_line` + `end_line` for read-range mode. Use list_files to browse file paths.";
+  const ig = await buildIgnore(cwd);
+  let regex;
   try {
-    const fullPath = path3.join(process.cwd(), filePath);
-    const content = await readFile3(fullPath, "utf-8");
-    return content.length > 15e3 ? content.slice(0, 15e3) + "\n\n... (truncated)" : content;
-  } catch (err) {
-    return `Error reading file: ${err.message}`;
+    regex = new RegExp(pattern, "i");
+  } catch {
+    regex = new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "i");
+  }
+  const allFiles = await globby2(fileGlob, { cwd, dot: false, onlyFiles: true, gitignore: false });
+  const filtered = allFiles.filter((f) => !ig.ignores(f) && isText(f));
+  const matches = [];
+  let totalMatches = 0;
+  for (const file of filtered) {
+    if (totalMatches >= maxResults) break;
+    let content;
+    try {
+      content = await readFile3(path3.join(cwd, file), "utf-8");
+    } catch {
+      continue;
+    }
+    const lines = content.split("\n");
+    const hitLines = [];
+    for (let i = 0; i < lines.length; i++) {
+      if (regex.test(lines[i])) hitLines.push(i);
+    }
+    if (hitLines.length === 0) continue;
+    const ranges = [];
+    for (const hit of hitLines) {
+      const s = Math.max(0, hit - contextLines);
+      const e = Math.min(lines.length - 1, hit + contextLines);
+      if (ranges.length > 0 && s <= ranges[ranges.length - 1][1] + 1) {
+        ranges[ranges.length - 1][1] = e;
+      } else {
+        ranges.push([s, e]);
+      }
+    }
+    const snippets = [];
+    for (const [s, e] of ranges) {
+      if (totalMatches >= maxResults) break;
+      snippets.push(
+        lines.slice(s, e + 1).map((l, i) => {
+          const n = s + i + 1;
+          return `${regex.test(l) ? ">" : " "} ${String(n).padStart(4)}: ${l}`;
+        }).join("\n")
+      );
+      totalMatches += hitLines.filter((h) => h >= s && h <= e).length;
+    }
+    if (snippets.length > 0) {
+      matches.push(`## ${file}
+\`\`\`
+${snippets.join("\n---\n")}
+\`\`\``);
+    }
   }
+  if (matches.length === 0) return `No matches found for: ${pattern}`;
+  const header = `Found matches in ${matches.length} file(s) (${totalMatches} match${totalMatches === 1 ? "" : "es"})${totalMatches >= maxResults ? " \u2014 limit reached" : ""}:`;
+  return [header, ...matches].join("\n\n");
 }
 
 // src/tools/ask-user/index.ts
@@ -2594,8 +2594,8 @@ var toolModules = [
   get_comments_exports,
   get_diff_exports,
   run_command_exports,
-  scan_project_exports,
-  read_file_exports,
+  list_files_exports,
+  grep_code_exports,
   ask_user_exports
 ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "techunter",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "AI-powered task distribution CLI for development teams",
   "author": "Techunter Contributors",
   "license": "MIT",