@bike4mind/cli 0.2.24-cli-file-read-offset.18477 → 0.2.24-cli-file-read-offset.18478

package/dist/index.js

@@ -3489,8 +3489,16 @@ CORE BEHAVIOR:
 
 FOR SOFTWARE ENGINEERING TASKS:
 When requested to perform tasks like fixing bugs, adding features, refactoring, or explaining code, follow this sequence:
-1. **Understand:** Think about the user's request and the relevant codebase context. Use '${TOOL_GREP_SEARCH}' and '${TOOL_GLOB_FILES}' search tools extensively (in parallel if independent) to understand file structures, existing code patterns, and conventions. Use '${TOOL_FILE_READ}' to understand context and validate any assumptions you may have. If you need to read multiple files, you should make multiple parallel calls to '${TOOL_FILE_READ}'.
-                   When the task involves **complex refactoring, codebase exploration or system-wide analysis**, your **first and primary action** must be to delegate to the '${EXPLORE_SUBAGENT_TYPE}' agent using the '${TOOL_SUBAGENT_DELEGATE}' tool. Use it to build a comprehensive understanding of the code, its structure, and dependencies. For **simple, targeted searches** (like finding a specific function name, file path, or variable declaration), you should use '${TOOL_GREP_SEARCH}' or '${TOOL_GLOB_FILES}' directly.
+1. **Understand:** Think about the user's request and the relevant codebase context. Use '${TOOL_GREP_SEARCH}' and '${TOOL_GLOB_FILES}' search tools extensively (in parallel if independent) to understand file structures, existing code patterns, and conventions. Use '${TOOL_FILE_READ}' to understand context and validate any assumptions you may have.
+
+   IMPORTANT FILE READING RULES:
+   - Read each file ONCE and refer to it in conversation history instead of re-reading
+   - Read files COMPLETELY by default (without offset/limit parameters)
+   - Only use offset/limit for files that are too large to fit in context (thousands of lines)
+   - If you need to read multiple DIFFERENT files, make multiple parallel calls to '${TOOL_FILE_READ}'
+   - NEVER make multiple calls to read the SAME file with different offsets unless it's truly too large
+
+   When the task involves **complex refactoring, codebase exploration or system-wide analysis**, your **first and primary action** must be to delegate to the '${EXPLORE_SUBAGENT_TYPE}' agent using the '${TOOL_SUBAGENT_DELEGATE}' tool. Use it to build a comprehensive understanding of the code, its structure, and dependencies. For **simple, targeted searches** (like finding a specific function name, file path, or variable declaration), you should use '${TOOL_GREP_SEARCH}' or '${TOOL_GLOB_FILES}' directly.
 2. **Plan:** Build a coherent and grounded (based on the understanding in step 1) plan for how you intend to resolve the user's task. Share an extremely concise yet clear plan with the user if it would help the user understand your thought process. As part of the plan, you should use an iterative development process that includes writing unit tests to verify your changes. Use output logs or debug statements as part of this process to arrive at a solution.
   If '${EXPLORE_SUBAGENT_TYPE}' subagent was used, do not ignore the output of the agent, you must use it as the foundation of your plan. For complex tasks, break them down into smaller, manageable subtasks and use the \`${TOOL_WRITE_TODOS}\` tool to track your progress. Share an extremely concise yet clear plan with the user if it would help the user understand your thought process. As part of the plan, you should use an iterative development process that includes writing unit tests to verify your changes. Use output logs or debug statements as part of this process to arrive at a solution.
 3. **Implement:** Use the available tools (e.g., '${TOOL_EDIT_LOCAL_FILE}', '${TOOL_CREATE_FILE}', '${TOOL_BASH_EXECUTE}' ...) to act on the plan, strictly adhering to the project's established conventions.
@@ -8941,7 +8949,7 @@ var fileReadTool = {
     },
     toolSchema: {
       name: "file_read",
-      description: "Read the contents of a file from the local filesystem. Supports text files with various encodings. Files are restricted to the current working directory and subdirectories for security. Use offset and limit to paginate through large files.",
+      description: "Read the contents of a file from the local filesystem. Supports text files with various encodings. Files are restricted to the current working directory and subdirectories for security. IMPORTANT: Read files completely by default (without offset/limit). Only use offset/limit for extremely large files (thousands of lines) that exceed context limits. Never re-read the same file multiple times - refer to previous reads in conversation history instead.",
       parameters: {
         type: "object",
         properties: {
@@ -8956,11 +8964,11 @@ var fileReadTool = {
           },
           offset: {
             type: "number",
-            description: "For text files, the 0-based line number to start reading from (default: 0). Use with limit to paginate through large files."
+            description: "OPTIONAL: For text files, the 0-based line number to start reading from. Only use for extremely large files (thousands of lines) that cannot fit in context. Default behavior is to read the entire file, which is preferred for most cases."
           },
           limit: {
             type: "number",
-            description: "For text files, maximum number of lines to read. Use with offset to paginate through large files. If not specified, reads all lines from offset to end of file."
+            description: "OPTIONAL: Maximum number of lines to read from offset. Only use for extremely large files (thousands of lines) that cannot fit in context. Default behavior is to read the entire file, which is preferred for most cases."
           }
         },
         required: ["path"]
@@ -12536,7 +12544,7 @@ import { isAxiosError as isAxiosError2 } from "axios";
 // package.json
 var package_default = {
   name: "@bike4mind/cli",
-  version: "0.2.24-cli-file-read-offset.18477+b8a15fff7",
+  version: "0.2.24-cli-file-read-offset.18478+9538467fd",
   type: "module",
   description: "Interactive CLI tool for Bike4Mind with ReAct agents",
   license: "UNLICENSED",
@@ -12644,10 +12652,10 @@ var package_default = {
   },
   devDependencies: {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.47.1-cli-file-read-offset.18477+b8a15fff7",
-    "@bike4mind/mcp": "1.27.1-cli-file-read-offset.18477+b8a15fff7",
-    "@bike4mind/services": "2.45.1-cli-file-read-offset.18477+b8a15fff7",
-    "@bike4mind/utils": "2.3.3-cli-file-read-offset.18477+b8a15fff7",
+    "@bike4mind/common": "2.47.1-cli-file-read-offset.18478+9538467fd",
+    "@bike4mind/mcp": "1.27.1-cli-file-read-offset.18478+9538467fd",
+    "@bike4mind/services": "2.45.1-cli-file-read-offset.18478+9538467fd",
+    "@bike4mind/utils": "2.3.3-cli-file-read-offset.18478+9538467fd",
     "@types/better-sqlite3": "^7.6.13",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -12664,7 +12672,7 @@ var package_default = {
   optionalDependencies: {
     "@vscode/ripgrep": "^1.17.0"
   },
-  gitHead: "b8a15fff785b52f5eb33933284e362331d5f8b1a"
+  gitHead: "9538467fd3acaaf1c31be03ff723e206139a8469"
 };
 
 // src/config/constants.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "0.2.24-cli-file-read-offset.18477+b8a15fff7",
+  "version": "0.2.24-cli-file-read-offset.18478+9538467fd",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
   "license": "UNLICENSED",
@@ -108,10 +108,10 @@
   },
   "devDependencies": {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.47.1-cli-file-read-offset.18477+b8a15fff7",
-    "@bike4mind/mcp": "1.27.1-cli-file-read-offset.18477+b8a15fff7",
-    "@bike4mind/services": "2.45.1-cli-file-read-offset.18477+b8a15fff7",
-    "@bike4mind/utils": "2.3.3-cli-file-read-offset.18477+b8a15fff7",
+    "@bike4mind/common": "2.47.1-cli-file-read-offset.18478+9538467fd",
+    "@bike4mind/mcp": "1.27.1-cli-file-read-offset.18478+9538467fd",
+    "@bike4mind/services": "2.45.1-cli-file-read-offset.18478+9538467fd",
+    "@bike4mind/utils": "2.3.3-cli-file-read-offset.18478+9538467fd",
     "@types/better-sqlite3": "^7.6.13",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -128,5 +128,5 @@
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.17.0"
   },
-  "gitHead": "b8a15fff785b52f5eb33933284e362331d5f8b1a"
+  "gitHead": "9538467fd3acaaf1c31be03ff723e206139a8469"
 }