@jefuriiij/synthra 0.1.18 → 0.1.19

package/CHANGELOG.md

@@ -7,6 +7,23 @@ For older versions, see [GitHub Releases](https://github.com/jefuriiij/synthra/r
 
 ---
 
+## [0.1.19] — 2026-06-01
+
+### Changed
+
+- **Policy block v4: targeted Read-before-Edit for graph-discovered files.**
+  Claude Code's `Edit` tool requires a file to have been opened with its own
+  `Read` tool; a `graph_read` slice does not satisfy that gate. Previously,
+  editing a file known only through `graph_read` would fail with *"File has
+  not been read yet"* and force a whole-file `Read` — eroding token savings on
+  edit-heavy sessions. The v4 policy now instructs: take the line range already
+  reported in the `graph_read` header (e.g. `…::handler (L120-168)`), do a
+  targeted `Read` with matching `offset`/`limit`, then `Edit`. This satisfies
+  the gate while keeping the read small. Existing v3 blocks auto-upgrade on the
+  next `syn .` run.
+
+---
+
 ## [0.1.18] — 2026-06-01
 
 ### Fixed

package/dist/cli/index.js

@@ -18,7 +18,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@jefuriiij/synthra",
-      version: "0.1.18",
+      version: "0.1.19",
       publishConfig: {
         access: "public"
       },
@@ -3213,7 +3213,7 @@ import { basename as basename4 } from "path";
 // src/hooks/claude-md.ts
 import { readFile as readFile9, writeFile as writeFile4 } from "fs/promises";
 import { basename as basename3, dirname as dirname6 } from "path";
-var POLICY_VERSION = 3;
+var POLICY_VERSION = 4;
 var POLICY_BEGIN = `<!-- synthra-policy v${POLICY_VERSION} BEGIN -->`;
 var POLICY_END = `<!-- synthra-policy v${POLICY_VERSION} END -->`;
 var ANY_BLOCK_RE = /<!--\s*synthra-policy\s+v\d+\s+BEGIN\s*-->[\s\S]*?<!--\s*synthra-policy\s+v\d+\s+END\s*-->\s*/g;
@@ -3282,6 +3282,17 @@ function policyBlock() {
     "- If `graph_continue`'s `Files` list contains a `::` entry, pass it",
     "  verbatim to `graph_read`.",
     "",
+    "### Editing a file",
+    "",
+    "Claude Code's `Edit` tool (and `Write` when overwriting) only accepts a",
+    "file that was opened with the **`Read` tool** \u2014 a `graph_read` slice does",
+    'not count, and editing such a file fails with *"File has not been read',
+    'yet."* So before editing a file you only know through `graph_read`: take',
+    "the line range from its header (e.g. `\u2026::handler (L120-168)`), `Read` that",
+    "file with a matching `offset`/`limit`, then `Edit`. That satisfies the",
+    "gate while keeping the read small \u2014 don't whole-file `Read` unless the",
+    "edit spans most of the file.",
+    "",
     "### Don'ts",
     "",
     "- Don't Grep / Glob before calling `graph_continue` when required \u2014 the",