@jefuriiij/synthra 0.1.17 → 0.1.19

package/CHANGELOG.md

@@ -7,6 +7,46 @@ 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
+
+- **Stop hook on Linux/macOS no longer posts zero tokens to the dashboard.** The bash
+  `stop.sh` hook extracted `transcript_path` from the Claude Code Stop payload using a
+  greedy `sed` capture (`\(.*\)"`). Because the real payload has additional fields after
+  `transcript_path`, the capture grabbed those trailing fields and produced a
+  non-existent path string. The `-f` file check therefore always failed, totals were
+  never POSTed to `/log`, and the dashboard stayed stuck at 0 on every turn (GitHub
+  issue #1). Fixed by parsing with `jq -r '.transcript_path // empty'` and moving the
+  `command -v jq` guard above the parse so the hook exits cleanly when `jq` is absent.
+- **SessionStart/PreCompact primer hook (`prime.sh`) hardened the same way.** The
+  `/prime` response is `{"primer":"…","port":…}`, so the old greedy capture accidentally
+  injected trailing `","port":…` junk into the primer string. Because primer text can
+  contain inner quotes, a negated-class fix (`[^"]*`) would have truncated it at the
+  first quote — `jq -r '.primer // empty'` is the correct parse. Switched `printf '%b'`
+  to `printf '%s'` since `jq -r` already decodes JSON escapes.
+- Both fixes are **bash-only**. The Windows PowerShell hooks (`stop.ps1`, `prime.ps1`)
+  use `ConvertFrom-Json` and were already correct.
+
+---
+
 ## [0.1.17] — 2026-05-29
 
 ### Added

package/dist/cli/index.js

@@ -18,7 +18,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@jefuriiij/synthra",
-      version: "0.1.17",
+      version: "0.1.19",
       publishConfig: {
         access: "public"
       },
@@ -1466,12 +1466,18 @@ if [ ! -f "$PORT_FILE" ]; then exit 0; fi
 PORT=$(cat "$PORT_FILE" 2>/dev/null | tr -d '[:space:]')
 if [ -z "$PORT" ]; then exit 0; fi
 
+# Parse the primer with jq, not sed. Primer text legitimately contains quotes, so a
+# negated-class capture ([^"]*) would truncate it at the first inner quote, while the
+# old greedy capture (.*") over-ran into the trailing "port" field and injected junk.
+# jq -r also decodes JSON escapes, so we print with %s (not %b). No jq \u2192 no primer.
+if ! command -v jq >/dev/null 2>&1; then exit 0; fi
+
 PRIMER=$(curl -sS --max-time 3 "http://127.0.0.1:$PORT/prime" 2>/dev/null \\
-  | sed -n 's/.*"primer"[[:space:]]*:[[:space:]]*"\\(.*\\)".*/\\1/p' \\
+  | jq -r '.primer // empty' 2>/dev/null \\
   | head -c 8000)
 
 if [ -n "$PRIMER" ]; then
-  printf '%b\\n' "$PRIMER"
+  printf '%s\\n' "$PRIMER"
 fi
 exit 0
 `;
@@ -1564,7 +1570,13 @@ set +e\r
 INPUT=$(cat 2>/dev/null)\r
 if [ -z "$INPUT" ]; then exit 0; fi\r
 \r
-TRANSCRIPT=$(printf '%s' "$INPUT" | sed -n 's/.*"transcript_path"[[:space:]]*:[[:space:]]*"\\(.*\\)".*/\\1/p')\r
+# jq is required for the parsing below \u2014 bail early (silent no-op) if it's absent.\r
+if ! command -v jq >/dev/null 2>&1; then exit 0; fi\r
+\r
+# Extract transcript_path with jq, not sed. A greedy sed capture (\\(.*\\)") grabs the\r
+# trailing JSON fields after transcript_path and yields a path that doesn't exist, so\r
+# the -f check below always failed and totals were never POSTed to /log. (issue #1)\r
+TRANSCRIPT=$(printf '%s' "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)\r
 if [ -z "$TRANSCRIPT" ] || [ ! -f "$TRANSCRIPT" ]; then exit 0; fi\r
 \r
 PORT_FILE="$PWD/.synthra-graph/mcp_port"\r
@@ -1572,8 +1584,6 @@ if [ ! -f "$PORT_FILE" ]; then exit 0; fi\r
 PORT=$(cat "$PORT_FILE" 2>/dev/null | tr -d '[:space:]')\r
 if [ -z "$PORT" ]; then exit 0; fi\r
 \r
-if ! command -v jq >/dev/null 2>&1; then exit 0; fi\r
-\r
 OFFSET_FILE="\${TRANSCRIPT}.stopoffset"\r
 START_OFFSET=0\r
 if [ -f "$OFFSET_FILE" ]; then\r
@@ -3203,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;
@@ -3272,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",