@jefuriiij/synthra 0.1.17 → 0.1.19

package/dist/server/index.js

@@ -1558,7 +1558,7 @@ import { basename as basename2 } from "path";
 // src/hooks/claude-md.ts
 import { readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
 import { basename, dirname as dirname4 } 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;
@@ -1627,6 +1627,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",