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

@jefuriiij/synthra 0.1.20 → 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 +58 -0
package/dist/cli/index.js +102 -14
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 +98 -10
package/dist/server/index.js.map +1 -1
package/package.json +3 -3

package/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,64 @@ 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
+- **HubL (HubSpot CMS) symbol extraction for `.html` and `.hubl` files.**
+  Previously `.html` files were content-indexed only — keyword search and
+  whole-file reads, no symbol-level granularity. On HubSpot projects this
+  meant the graph contributed nothing: zero `graph_continue`/`graph_read`
+  calls resolved to symbol slices all session. Now `.html` and `.hubl` files
+  run through a new **regex-based** parser (`parsers/hubl.ts`; there is no
+  tree-sitter grammar for HubL):
+  - `{% macro name(args) %}` → extracted as a `function` symbol
+  - `{% block name %}` → extracted as a `component` symbol
+  - `{% include / extends / import / from "path" %}` → import edges (relative
+    paths resolve to local templates; `.html`/`.hubl` added to the resolver's
+    extension list)
+  Plain HTML with no HubL tags is unaffected — the parser yields zero symbols
+  and zero imports, identical to before. No API, protocol, or policy-block
+  change. Roadmap item #12.
+---
 ## [0.1.20] — 2026-06-06
 ### Fixed

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.20",
+      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));
@@ -2170,7 +2170,7 @@ function extractKeywords(content, _ext) {
 }
 // src/scanner/extract.ts
-var RESOLVE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".svelte", ".vue", ".dart"];
+var RESOLVE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".svelte", ".vue", ".dart", ".html", ".hubl"];
 var INDEX_FILES = ["index.ts", "index.tsx", "index.js", "index.jsx", "__init__.py"];
 function fileId(relPath) {
   return `file:${relPath}`;
@@ -2574,6 +2574,57 @@ async function parseGo(f, source) {
   );
 }
+// src/scanner/parsers/hubl.ts
+var MACRO_RE = /\{%-?\s*macro\s+([A-Za-z_]\w*)\s*\(([^)]*)\)/g;
+var ENDMACRO_RE = /\{%-?\s*endmacro\b/g;
+var BLOCK_RE = /\{%-?\s*block\s+([A-Za-z_]\w*)/g;
+var ENDBLOCK_RE = /\{%-?\s*endblock\b/g;
+var IMPORT_RE = /\{%-?\s*(?:include|extends|import|from)\s+["']([^"']+)["']/g;
+function lineAt(source, index) {
+  return source.slice(0, index).split(/\r?\n/).length;
+}
+function endLineAfter(source, fromIndex, endRe, startLine) {
+  endRe.lastIndex = fromIndex;
+  const m = endRe.exec(source);
+  return m ? lineAt(source, m.index) : startLine;
+}
+function parseHubL(f, source) {
+  const symbols = [];
+  const imports = [];
+  for (const m of source.matchAll(MACRO_RE)) {
+    const name = m[1];
+    if (!name) continue;
+    const args = (m[2] ?? "").trim();
+    const start = m.index ?? 0;
+    const startLine = lineAt(source, start);
+    symbols.push({
+      name,
+      kind: "function",
+      startLine,
+      endLine: endLineAfter(source, start + m[0].length, ENDMACRO_RE, startLine),
+      signature: `macro ${name}(${args})`
+    });
+  }
+  for (const m of source.matchAll(BLOCK_RE)) {
+    const name = m[1];
+    if (!name) continue;
+    const start = m.index ?? 0;
+    const startLine = lineAt(source, start);
+    symbols.push({
+      name,
+      kind: "component",
+      startLine,
+      endLine: endLineAfter(source, start + m[0].length, ENDBLOCK_RE, startLine),
+      signature: `block ${name}`
+    });
+  }
+  for (const m of source.matchAll(IMPORT_RE)) {
+    const spec = m[1];
+    if (spec) imports.push(spec);
+  }
+  return { file: f, source, symbols, imports: Array.from(new Set(imports)), calls: [] };
+}
 // src/scanner/parsers/java.ts
 var QUERY6 = `
 (class_declaration name: (identifier) @class.name) @class
@@ -3012,6 +3063,9 @@ async function parseFile(f) {
       return parseSvelte(f, source);
     case ".vue":
       return parseVue(f, source);
+    case ".html":
+    case ".hubl":
+      return parseHubL(f, source);
     case ".go":
       return parseGo(f, source);
     case ".rs":
@@ -4384,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}
@@ -4400,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");
@@ -4569,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;
 }
@@ -4629,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",