hexcli 2.20.1__tar.gz → 2.21.0__tar.gz

{hexcli-2.20.1 → hexcli-2.21.0}/CHANGELOG.md

@@ -4,6 +4,35 @@ Full evidence for every claim below — including the experiments that failed
 lives in `docs/V2_PLAN.md` §14. Numbers are pass^k over repeated live runs on
 the Hexagon NPU, not single-run anecdotes.
 
+## 2.21.0 — 2026-10-10
+
+A minor release: a tool result the model reads changes (`edit_file` when
+`old_string` is not in the file).
+
+> **Gate: PASS** on the pinned 24-case set after one recheck:
+> `error-recovery-3` missed one of five runs, and that run never called
+> `edit_file` (it reported a "permission error" after `find_files`); re-run on
+> a fresh server it was 6/6. Own arm, seed 20261010, against 2.20.0's arm:
+> run-level 189/237 vs 192/245, +1.4 %, Fisher p = 0.74; pass^k 32 → 34 of
+> 49, McNemar p = 0.73; 8 invalid runs of 245 (backend timeouts, 2.2 GB
+> free). `claims-2`, one of the three cases behind most of the recorded
+> misses, went 2/5 → 5/5. `self-correct-1` lost one run to the known
+> double-escaped `new_string` (a literal `\n` landed on the first edit,
+> before any miss), and `regression-anchor-1` lost one to the same defect
+> with no miss at all. Smoke 9/9 valid on a fresh server.
+
+- A missed `edit_file` on a file of up to 1,500 characters returns the
+  file's whole current text instead of the closest region. Of 1,279 recorded
+  `edit_file` calls, 786 were made without reading the file that turn and
+  failed 45 % of the time against 9 % after a read, and 115 of the 291
+  misses came straight after another miss on the same file: the retry was
+  rebuilt from memory again. Every fixture behind those misses is under 200
+  characters. In the arm the message fired 16 times, in `tests-claim-1`,
+  `self-correct-1`, `claims-2` and `agentic-3`, and the next edit landed
+  after 7 of them (44 %), against 14 of 39 (36 %) in the three arms before
+  it; at that count the recovery rate is not yet a measured effect. A larger
+  file keeps the closest-region report.
+
 ## 2.20.1 — 2026-10-10
 
 A patch release: nothing the model reads changes. The turn's return value

{hexcli-2.20.1 → hexcli-2.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: hexcli
-Version: 2.20.1
+Version: 2.21.0
 Summary: Local Hexagon NPU terminal agent for Snapdragon X Elite Windows ARM64
 Project-URL: Homepage, https://github.com/NathanL15/Hex-CLI
 Project-URL: Repository, https://github.com/NathanL15/Hex-CLI

{hexcli-2.20.1 → hexcli-2.21.0}/hexcli/__init__.py

@@ -3,4 +3,4 @@
 # The one place the version is written. pyproject.toml reads it (hatch
 # dynamic version), agent.VERSION re-exports it, and CI refuses a release
 # tag that does not match it.
-__version__ = "2.20.1"
+__version__ = "2.21.0"

{hexcli-2.20.1 → hexcli-2.21.0}/hexcli/tools.py

@@ -441,6 +441,8 @@ def edit_file_tool(path_text: str, old_string: str, new_string: str) -> str:
     else:
         new_content, err = apply_search_replace(content, [(old_string, new_string)])
         if err:
+            if err.startswith("SEARCH block 1 was not found") and len(content) <= _WHOLE_FILE_ON_MISS:
+                raise RuntimeError(_not_found_with_content(path, content))
             raise RuntimeError(err.replace("SEARCH block 1", "old_string"))
         tier = p2.LAST_APPLY_TIER
     tmp = path.parent / (path.name + ".tmp")
@@ -453,6 +455,26 @@ def edit_file_tool(path_text: str, old_string: str, new_string: str) -> str:
     return f"Edited {path}"
 
 
+# A missed edit_file on a small file gets the file's whole text back instead of
+# the closest region. Of 1,279 recorded edit_file calls (2026-09-18), 786 were
+# made without reading or writing the file that turn and failed 45 % of the
+# time against 9 % after a read, and 115 of the 291 misses came straight after
+# another miss on the same file: the retry was rebuilt from memory again. With
+# the text in the error the retry can be copied from the file, at no extra
+# step. Every fixture behind those misses is under 200 characters; a file
+# above the cap keeps the closest-region report.
+_WHOLE_FILE_ON_MISS = 1500
+
+
+def _not_found_with_content(path: Path, content: str) -> str:
+    body = content if content.strip() else "(the file is empty)"
+    return (
+        f"old_string was not found in {path}. This is the file's whole current "
+        "content; copy the lines to change from it exactly into old_string:\n"
+        f"---\n{body.rstrip(chr(10))}\n---"
+    )
+
+
 def write_file_tool(path_text: str, content: str) -> str:
     from . import editing as p2