@jefuriiij/synthra 0.1.22 → 0.1.23

package/CHANGELOG.md

@@ -7,6 +7,52 @@ For older versions, see [GitHub Releases](https://github.com/jefuriiij/synthra/r
 
 ---
 
+## [0.1.23] — 2026-06-06
+
+### Added
+
+- **Dashboard token-log dedupe can now be disabled via `SYN_DASHBOARD_DEDUPE=0`.**
+  By default, `delta.ts` deduplicates `token_log.jsonl` entries that share the
+  same project, usage totals, and second-rounded timestamp — collapsing the
+  duplicate writes that a co-installed AI tool's Stop hook may produce. Set
+  `SYN_DASHBOARD_DEDUPE=0` (also accepts `off` or `false`) to see every raw
+  entry. Useful when debugging multi-tool coexistence or auditing raw log data.
+
+- **Graph schema-migration check on load.** A new `SCHEMA_VERSION` constant is
+  exported from `src/graph/types.ts` and stamped into `info_graph.json` by
+  `buildGraph`. On server start, `http.ts` compares the stored graph's
+  `schema_version` to the current constant; if they differ it triggers an
+  automatic one-time rescan instead of serving an incompatible graph. No
+  behavior change today — all graphs are v1 and schema_version matches — but
+  this is the forward-safety mechanism for future schema bumps so existing
+  graphs are never silently misread.
+
+### Fixed
+
+- **JS/TS parser now captures member-assigned functions** (`exports.handler = fn`,
+  `module.exports.route = () => {}`, `this.x = () => {}`). Previously these
+  CommonJS/member-export patterns were invisible to the query, so modules that
+  exclusively use this style extracted zero symbols and degraded to whole-file
+  reads via `graph_read`. A member-assignment capture has been added to both
+  `JS_QUERY` and `TS_QUERY` in `src/scanner/parsers/typescript.ts`. Note: a
+  pure-wiring `server.js` whose only structure is anonymous inline-callback
+  arguments (e.g. `io.use(...)` / `socket.on(event, fn)`) is genuinely
+  symbol-less — that is correct, and the gate's symbol-hit guard already
+  prevents blocking such files.
+
+### Changed
+
+- **Policy block v4 → v5.** Adds a "large file — pull the symbol, don't
+  chunk" nudge to address recurring dogfood friction: on large files Claude
+  was reading successive line-range chunks instead of fetching the specific
+  symbol via `graph_read("file::symbol")`. The v5 block now explicitly
+  instructs: when a file is large, use `graph_read("file/path.ts::SymbolName")`
+  to pull the symbol directly rather than reading successive line-range chunks.
+  `POLICY_VERSION` bumped `4 → 5`; existing v4 blocks auto-upgrade on the
+  next `syn .` run.
+
+---
+
 ## [0.1.22] — 2026-06-06
 
 ### Fixed

package/dist/cli/index.js

@@ -18,7 +18,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@jefuriiij/synthra",
-      version: "0.1.22",
+      version: "0.1.23",
       publishConfig: {
         access: "public"
       },
@@ -297,13 +297,18 @@ function summarize(p) {
     models
   };
 }
+function dedupeEnabled() {
+  const v = process.env.SYN_DASHBOARD_DEDUPE;
+  return v !== "0" && v !== "off" && v !== "false";
+}
 async function loadProjectFiles(path, name, lastSeen) {
   const paths = resolvePaths(path);
   const [rawTokens, gates] = await Promise.all([
     readJsonl(paths.tokenLog),
     readJsonl(paths.gateLog)
   ]);
-  return { path, name, last_seen: lastSeen, tokens: dedupeTokens(rawTokens), gates };
+  const tokens = dedupeEnabled() ? dedupeTokens(rawTokens) : rawTokens;
+  return { path, name, last_seen: lastSeen, tokens, gates };
 }
 function dedupeTokens(entries) {
   const score2 = (model) => {
@@ -1401,33 +1406,33 @@ exit 0
 var pre_tool_use_default = '# PreToolUse hook \u2014 Windows PowerShell.\n# THE MOAT (improvement #1). Reads the tool call from stdin (JSON), POSTs it\n# to /gate, and if the server says "block" emits a JSON deny-decision to\n# stdout. Claude Code reads stdout JSON to enforce the decision.\n# Always exits 0; failure-to-reach-server leaves Claude untouched.\n\n$ErrorActionPreference = "SilentlyContinue"\n\n$raw = [Console]::In.ReadToEnd()\nif (-not $raw) { exit 0 }\n\ntry {\n    $hookInput = $raw | ConvertFrom-Json -ErrorAction Stop\n} catch {\n    exit 0\n}\n\n$portFile = Join-Path $PWD ".synthra-graph\\mcp_port"\nif (-not (Test-Path $portFile)) { exit 0 }\n$port = (Get-Content -Path $portFile -Raw).Trim()\nif (-not $port) { exit 0 }\n\n$payload = @{\n    tool_name  = $hookInput.tool_name\n    tool_input = $hookInput.tool_input\n} | ConvertTo-Json -Depth 10 -Compress\n\ntry {\n    $resp = Invoke-RestMethod -Uri "http://127.0.0.1:$port/gate" -Method POST `\n        -Body $payload -ContentType "application/json" -TimeoutSec 3\n} catch {\n    exit 0\n}\n\nif ($resp.decision -eq "block") {\n    $denyJson = @{\n        hookSpecificOutput = @{\n            hookEventName            = "PreToolUse"\n            permissionDecision       = "deny"\n            permissionDecisionReason = $resp.reason\n        }\n    } | ConvertTo-Json -Depth 5 -Compress\n    Write-Output $denyJson\n}\nexit 0\n';
 
 // src/hooks/scripts/pre-tool-use.sh
-var pre_tool_use_default2 = `#!/usr/bin/env bash
-# PreToolUse hook \u2014 bash. POSTs the tool call to /gate; if server returns
-# "block", emits the deny-decision JSON to stdout for Claude Code to enforce.
-# Always exits 0; server failures leave Claude untouched.
-
-set +e
-
-PORT_FILE="$PWD/.synthra-graph/mcp_port"
-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
-
-INPUT=$(cat 2>/dev/null)
-if [ -z "$INPUT" ]; then exit 0; fi
-
-RESP=$(curl -sS --max-time 3 -X POST -H "Content-Type: application/json" \\
-  --data "$INPUT" "http://127.0.0.1:$PORT/gate" 2>/dev/null)
-
-case "$RESP" in
-  *'"decision":"block"'*)
-    REASON=$(printf '%s' "$RESP" | sed -n 's/.*"reason"[[:space:]]*:[[:space:]]*"\\(.*\\)".*/\\1/p')
-    cat <<EOF
-{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"\${REASON}"}}
-EOF
-    ;;
-esac
-exit 0
+var pre_tool_use_default2 = `#!/usr/bin/env bash\r
+# PreToolUse hook \u2014 bash. POSTs the tool call to /gate; if server returns\r
+# "block", emits the deny-decision JSON to stdout for Claude Code to enforce.\r
+# Always exits 0; server failures leave Claude untouched.\r
+\r
+set +e\r
+\r
+PORT_FILE="$PWD/.synthra-graph/mcp_port"\r
+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
+INPUT=$(cat 2>/dev/null)\r
+if [ -z "$INPUT" ]; then exit 0; fi\r
+\r
+RESP=$(curl -sS --max-time 3 -X POST -H "Content-Type: application/json" \\\r
+  --data "$INPUT" "http://127.0.0.1:$PORT/gate" 2>/dev/null)\r
+\r
+case "$RESP" in\r
+  *'"decision":"block"'*)\r
+    REASON=$(printf '%s' "$RESP" | sed -n 's/.*"reason"[[:space:]]*:[[:space:]]*"\\(.*\\)".*/\\1/p')\r
+    cat <<EOF\r
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"\${REASON}"}}\r
+EOF\r
+    ;;\r
+esac\r
+exit 0\r
 `;
 
 // src/hooks/scripts/prime.ps1
@@ -1958,6 +1963,9 @@ import { resolve } from "path";
 // src/scanner/extract.ts
 import { dirname as dirname4, join as join6, posix } from "path";
 
+// src/graph/types.ts
+var SCHEMA_VERSION2 = 1;
+
 // src/scanner/hash.ts
 import { createHash } from "crypto";
 function fileHash(content) {
@@ -2294,7 +2302,7 @@ async function buildGraph(root, parsed) {
     nodes,
     edges,
     generated_at: (/* @__PURE__ */ new Date()).toISOString(),
-    schema_version: 1
+    schema_version: SCHEMA_VERSION2
   };
 }
 function buildSymbolIndex(graph) {
@@ -2828,6 +2836,7 @@ var TS_QUERY = `
 (enum_declaration name: (identifier) @enum.name) @enum
 (method_definition name: (property_identifier) @method.name) @method
 (lexical_declaration (variable_declarator name: (identifier) @const-fn.name value: [(arrow_function) (function_expression)])) @const-fn
+(assignment_expression left: (member_expression property: (property_identifier) @member-fn.name) right: [(arrow_function) (function_expression)]) @member-fn
 (import_statement source: (string) @import)
 `;
 var JS_QUERY = `
@@ -2835,6 +2844,7 @@ var JS_QUERY = `
 (class_declaration name: (identifier) @class.name) @class
 (method_definition name: (property_identifier) @method.name) @method
 (lexical_declaration (variable_declarator name: (identifier) @const-fn.name value: [(arrow_function) (function_expression)])) @const-fn
+(assignment_expression left: (member_expression property: (property_identifier) @member-fn.name) right: [(arrow_function) (function_expression)]) @member-fn
 (import_statement source: (string) @import)
 (call_expression function: (identifier) @_require_fn arguments: (arguments . (string) @require_source))
 `;
@@ -2859,7 +2869,7 @@ function shapeFromCaptures(captures) {
     const name = captures.get(`${k}.name`);
     return decl && name ? { decl, name, kind: sk } : null;
   };
-  return findDecl("function", "function") ?? findDecl("class", "class") ?? findDecl("interface", "interface") ?? findDecl("type", "type") ?? findDecl("enum", "enum") ?? findDecl("method", "method") ?? findDecl("const-fn", "function");
+  return findDecl("function", "function") ?? findDecl("class", "class") ?? findDecl("interface", "interface") ?? findDecl("type", "type") ?? findDecl("enum", "enum") ?? findDecl("method", "method") ?? findDecl("const-fn", "function") ?? findDecl("member-fn", "function");
 }
 async function parseTypeScript(f, source) {
   const grammar = grammarFor(f.ext);
@@ -3267,7 +3277,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 = 4;
+var POLICY_VERSION = 5;
 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;
@@ -3335,6 +3345,10 @@ function policyBlock() {
     "  reads should be rare \u2014 only when you genuinely need the full file.",
     "- If `graph_continue`'s `Files` list contains a `::` entry, pass it",
     "  verbatim to `graph_read`.",
+    "- **Large file?** Don't read it in successive line-range chunks \u2014 call",
+    '  `graph_continue` or `graph_read("file::symbol")` to pull the one symbol',
+    "  you need. Chunked whole-file Reads are exactly the cost `graph_read`",
+    "  exists to avoid.",
     "",
     "### Editing a file",
     "",
@@ -3892,7 +3906,7 @@ async function writeContextMd(path, ctx) {
 // src/memory/context-store.ts
 import { mkdir as mkdir7, readFile as readFile13, writeFile as writeFile7 } from "fs/promises";
 import { dirname as dirname8 } from "path";
-var SCHEMA_VERSION2 = 1;
+var SCHEMA_VERSION3 = 1;
 async function readEntries(path) {
   try {
     const raw = await readFile13(path, "utf8");
@@ -3904,7 +3918,7 @@ async function readEntries(path) {
 }
 async function writeEntries(path, entries) {
   await mkdir7(dirname8(path), { recursive: true });
-  const store = { schema_version: SCHEMA_VERSION2, entries };
+  const store = { schema_version: SCHEMA_VERSION3, entries };
   await writeFile7(path, JSON.stringify(store, null, 2) + "\n", "utf8");
 }
 async function appendEntry(path, entry) {
@@ -4804,10 +4818,20 @@ ${fileCount} files indexed, ${symbolCount} symbols. Prefer the graph_* MCP tools
 // src/server/http.ts
 async function loadContext(paths) {
   try {
-    const [graph, symbolIndex] = await Promise.all([
+    let [graph, symbolIndex] = await Promise.all([
       readGraph(paths.infoGraph),
       readSymbolIndex(paths.symbolIndex)
     ]);
+    if (graph.schema_version !== SCHEMA_VERSION2) {
+      log.info(
+        `graph schema v${graph.schema_version} \u2260 current v${SCHEMA_VERSION2} \u2014 rescanning\u2026`
+      );
+      await scanProject(paths.projectRoot, { silent: true });
+      [graph, symbolIndex] = await Promise.all([
+        readGraph(paths.infoGraph),
+        readSymbolIndex(paths.symbolIndex)
+      ]);
+    }
     const activity = new ActivityStore(paths.activityLog);
     return { paths, graph, symbolIndex, activity };
   } catch (err2) {