@tiens.nguyen/gu-cli 1.0.748 → 1.0.749

package/gonext_agent_chat.py

@@ -8020,13 +8020,19 @@ def run_agent_chat(cfg):
         # ORDER to use them in and the CONSTRAINTS that bite — so keep those, drop the third
         # retelling. Every rule below is a scar: token waste (#63/#79), no-shell/no-sudo,
         # key-only deploys (#57).
-        "    THE EDIT LOOP: grep_repo to LOCATE → read_file_lines around the hit (a SMALL "
-        "range; never re-read the whole file or the same range twice — large reads are "
-        "truncated and slow every later step) → edit_lines to change it → run_command to "
-        "VERIFY. edit_file only for a byte-exact unique string; create_file(overwrite=True) "
+        # Task #48 (GitHub): string edits are the default, like Claude Code's Edit tool. A
+        # line-number edit needs a fresh read before every edit (each one shifts the numbers):
+        # a measured turn spent 12 of its 43 steps on read → edit_lines → read → edit_lines.
+        "    THE EDIT LOOP: LOCATE (explore, grep_repo) → read_file_lines ONCE around what you will "
+        "change (a SMALL range; never re-read the whole file or the same range twice) → make ALL "
+        "of that file's edits in ONE block with edit_file(path, old_string, new_string), quoting "
+        "a short UNIQUE snippet from what you read — no line numbers, so no re-read between "
+        "edits → VERIFY with run_command (in the same block when you can). edit_lines only when "
+        "you cannot quote a unique string (e.g. replacing a long range); create_file(overwrite=True) "
         "replaces a whole file in ONE call (no read+edit just to rewrite it).\n"
-        "    EXPLORE FIRST — before CHANGING code you have not seen yet in this conversation, and "
-        "for any broad question (where is X handled, how does Y work, what would a change to Z "
+        "    EXPLORE FIRST — before CHANGING code you have not seen yet in this conversation "
+        "(always for a change that spans several files or layers — frontend + backend, UI + API), "
+        "and for any broad question (where is X handled, how does Y work, what would a change to Z "
         "touch): call explore(question) ONCE to map the files and lines involved. It searches in "
         "a SEPARATE context and returns a short summary with path:line references, so its greps "
         "and reads do not pile up here and are not re-sent on every later step. Then read only "
@@ -8071,12 +8077,11 @@ def run_agent_chat(cfg):
         "- user asks to FIX A BUG / MODIFY / ADD CODE in a workspace -> "
         "grep_repo(pattern) when you know the exact string, or rag_search_workspace(query) "
         "when you do not, to FIND the file, THEN "
-        "read_file_lines(file, around the hit) to see exact lines, THEN "
-        "edit_lines(file, start, end, new_content) to change them, THEN "
+        "read_file_lines(file, around the hit) ONCE, THEN edit_file(file, old_string, new_string) "
+        "for EACH change to that file — all in ONE block —, THEN "
         "run_command('…test…') to VERIFY if run permission exists — read failures and fix, "
         "iterate. Finish with final_answer summarizing WHAT you changed (files + lines). "
-        "AFTER editing, re-read with grep_repo/read_file_lines (an indexed knowledge base may be "
-        "stale — do not trust rag_search for freshly edited code).\n"
+        "Do not trust rag_search for freshly edited code (the index may be stale).\n"
     ) if _WS_AVAILABLE else ""
     _email_choose_line = (
         "- 'email …' / 'send an email to …' -> send_email(to, subject, body) "
@@ -8261,7 +8266,8 @@ def run_agent_chat(cfg):
         + ("Remember: FINISH what was asked yourself — fix blockers, VERIFY the outcome, then "
            "final_answer with evidence; never hand the task back. If it only asks to RECORD work "
            "(create a task, a note, a plan), recording it IS the task — do not start the work. "
-           "To change code you have not seen yet, map it with ONE explore() call first.\n"
+           "To change code you have not seen yet — especially across several files — map it with "
+           "ONE explore() call first, then make each file's edits in ONE block with edit_file.\n"
            if _WS_AVAILABLE else "")
         + "\nTASK (answer THIS, choose the tool that fits it):\n"
         f"{task_text}\n"
@@ -11601,7 +11607,7 @@ def run_agent_chat(cfg):
 
         @tool
         def edit_lines(path: str, start_line: int, end_line: int, new_content: str) -> str:
-            """Replace lines start_line..end_line (inclusive, 1-based) of a workspace file with new_content. The PRIMARY edit tool — get exact line numbers from grep_repo/read_file_lines first. A backup is saved automatically.
+            """Replace lines start_line..end_line (inclusive, 1-based) of a workspace file with new_content. Use it only when you cannot quote a unique string for edit_file (e.g. replacing a long range). Line numbers shift after every edit, so re-read before another edit_lines in the same file. A backup is saved automatically.
 
             Args:
                 path: file inside a registered workspace.
@@ -11658,7 +11664,7 @@ def run_agent_chat(cfg):
 
         @tool
         def edit_file(path: str, old_string: str, new_string: str) -> str:
-            """Replace an EXACT unique text occurrence in a workspace file (must match byte-for-byte incl. whitespace). Prefer edit_lines when you have line numbers. A backup is saved automatically.
+            """The PRIMARY edit tool: replace an EXACT, unique text occurrence in a workspace file (byte-for-byte, incl. whitespace). It needs no line numbers, so several edit_file calls to one file go in ONE block after a single read. A backup is saved automatically.
 
             Args:
                 path: file inside a registered workspace.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiens.nguyen/gu-cli",
-  "version": "1.0.748",
+  "version": "1.0.749",
   "description": "Gu CLI — the gu terminal plus the local worker that runs agent / OCR / PDF / embedding jobs on your Mac (Ollama / MLX / OpenAI-compatible).",
   "type": "module",
   "license": "MIT",