npm - @jefuriiij/synthra - Versions diffs - 0.1.21 → 0.1.22 - Mend

@jefuriiij/synthra 0.1.21 → 0.1.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md +35 -0
package/dist/cli/index.js +47 -13
package/dist/cli/index.js.map +1 -1
package/dist/dashboard/index.js +4 -4
package/dist/dashboard/index.js.map +1 -1
package/dist/server/index.js +43 -9
package/dist/server/index.js.map +1 -1
package/package.json +3 -3

package/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,41 @@ For older versions, see [GitHub Releases](https://github.com/jefuriiij/synthra/r
 ---
+## [0.1.22] — 2026-06-06
+### Fixed
+- **`graph_read` now resolves shortened file paths (path-suffix fallback).** Previously
+  `graph_read` performed an exact `path === target` match only. Passing a shortened path
+  like `appsettings.json` returned "file not found" even when
+  `connectwarev2/.../appsettings.json` was indexed. A new `resolveFileTarget` helper (now
+  exported) tries an exact match first; on a miss it looks for a unique path-suffix match
+  and serves that file; if multiple files share the suffix it reports them as ambiguous with
+  candidate paths rather than guessing. Symbol lookups use the resolved path. No API or
+  protocol change. Roadmap item #11.
+- **Gate content-keyword relaxation now intersects file contents, not just file paths.**
+  The Moat's recent-activity relaxation previously matched query tokens against the paths of
+  recently-touched files only. A query like `Grep "login"` would not relax on a recent save
+  of `auth.ts` unless the word "login" appeared in the path. Now the relaxation also checks
+  the recently-touched file's graph-node keywords (its indexed content), so a recent save
+  relaxes a Grep whenever the file *contains* the queried term — not just when the path
+  matches it. Completes roadmap item #3.
+### Changed
+- **Dashboard Projects card shows a first-run hint in the empty state.** When no projects
+  have run `syn .` yet, the Projects card now displays "No projects yet — run `syn .` in a
+  project to start" instead of a blank card. The Recent-turns card already carried this
+  hint; Projects now matches it. Roadmap item #10.
+- **`bin` path normalization (chore).** Ran `npm pkg fix` to normalize `bin` entries from
+  `./bin/syn` to `bin/syn`. Silences the cosmetic publish warnings
+  (`"bin[syn]" script name was cleaned`). `syn` and `synthra` still resolve to the same
+  entry point. Roadmap item #4.
+---
 ## [0.1.21] — 2026-06-06
 ### Added

package/dist/cli/index.js CHANGED Viewed

@@ -18,15 +18,15 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@jefuriiij/synthra",
-      version: "0.1.21",
+      version: "0.1.22",
       publishConfig: {
         access: "public"
       },
       description: "Local context engine for AI coding assistants \u2014 graph-based context, branch-aware memory, real-time human-activity awareness, deterministic Grep/Glob gating, and a live token dashboard.",
       type: "module",
       bin: {
-        syn: "./bin/syn",
-        synthra: "./bin/syn"
+        syn: "bin/syn",
+        synthra: "bin/syn"
       },
       scripts: {
         build: "tsup",
@@ -1075,7 +1075,7 @@ var public_default = `<!doctype html>
       const el = $('#proj-chart');
       el.innerHTML = '';
       if (!projects.length) {
-        el.innerHTML = '<div class="empty">No projects yet.</div>';
+        el.innerHTML = '<div class="empty">No projects yet \u2014 run <code>syn .</code> in a project to start.</div>';
         return;
       }
       const ranked = [...projects].sort((a, b) => (b.total_turns || 0) - (a.total_turns || 0));
@@ -4438,15 +4438,33 @@ Reason: ${retrieval.reason}
   return textContent(`${header}
 ${packed.text}`);
 }
+function resolveFileTarget(graph, filePath) {
+  const files = graph.nodes.filter((n) => n.kind === "file");
+  const exact = files.find((n) => n.path === filePath);
+  if (exact) return { node: exact };
+  const suffix = "/" + filePath;
+  const matches = files.filter((n) => n.path.endsWith(suffix));
+  if (matches.length === 1) return { node: matches[0] };
+  if (matches.length > 1) return { ambiguous: matches.map((n) => n.path) };
+  return { none: true };
+}
 function graphRead(args, ctx) {
   const target = typeof args?.target === "string" ? args.target : "";
   if (!target) return errorContent("graph_read: 'target' (string) is required");
   const [rawFile, symbolName] = target.includes("::") ? target.split("::", 2) : [target, void 0];
   const filePath = (rawFile ?? "").trim();
-  const fileNode = ctx.graph.nodes.find(
-    (n) => n.kind === "file" && n.path === filePath
-  );
-  if (!fileNode) return errorContent(`graph_read: file not found in graph: ${filePath}`);
+  const resolved = resolveFileTarget(ctx.graph, filePath);
+  if ("ambiguous" in resolved) {
+    const shown = resolved.ambiguous.slice(0, 5).join(", ");
+    const more = resolved.ambiguous.length > 5 ? ", \u2026" : "";
+    return errorContent(
+      `graph_read: '${filePath}' matches multiple files (${shown}${more}). Pass a longer path.`
+    );
+  }
+  if ("none" in resolved) {
+    return errorContent(`graph_read: file not found in graph: ${filePath}`);
+  }
+  const fileNode = resolved.node;
   if (!symbolName) {
     return textContent(`# ${fileNode.path}
@@ -4454,10 +4472,10 @@ ${fileNode.content}`);
   }
   const cleanSym = symbolName.trim();
   const symbol = ctx.graph.nodes.find(
-    (n) => n.kind === "symbol" && n.file === filePath && n.name === cleanSym
+    (n) => n.kind === "symbol" && n.file === fileNode.path && n.name === cleanSym
   );
   if (!symbol) {
-    return errorContent(`graph_read: symbol '${cleanSym}' not found in ${filePath}`);
+    return errorContent(`graph_read: symbol '${cleanSym}' not found in ${fileNode.path}`);
   }
   const lines = fileNode.content.split(/\r?\n/);
   const body = lines.slice(symbol.start_line - 1, symbol.end_line).join("\n");
@@ -4623,16 +4641,32 @@ function looksLikeNonSymbolQuery(pattern) {
   }
   return false;
 }
-function recentlyTouchedMatchesQuery(recentPaths, queryTokens) {
+function recentlyTouchedMatchesQuery(recentPaths, queryTokens, graph) {
+  if (recentPaths.length === 0) return [];
+  const recent = new Set(recentPaths);
+  const keywordsByPath = /* @__PURE__ */ new Map();
+  for (const n of graph.nodes) {
+    if (n.kind === "file" && recent.has(n.path)) keywordsByPath.set(n.path, n.keywords);
+  }
   const matches = [];
   for (const path of recentPaths) {
     const lower = path.toLowerCase();
+    let matched = false;
     for (const t of queryTokens) {
       if (lower.includes(t)) {
-        matches.push(path);
+        matched = true;
         break;
       }
     }
+    if (!matched) {
+      for (const kw of keywordsByPath.get(path) ?? []) {
+        if (queryTokens.has(kw)) {
+          matched = true;
+          break;
+        }
+      }
+    }
+    if (matched) matches.push(path);
   }
   return matches;
 }
@@ -4683,7 +4717,7 @@ async function handleGate(req, ctx) {
   }
   const qTokens = new Set(tokenizeQuery(query));
   const recentPaths = ctx.activity.recentFilePaths(RECENT_ACTIVITY_WINDOW_MS);
-  const overlap = recentlyTouchedMatchesQuery(recentPaths, qTokens);
+  const overlap = recentlyTouchedMatchesQuery(recentPaths, qTokens, ctx.graph);
   if (overlap.length > 0) {
     const res2 = {
       decision: "allow",