@andespindola/brainlink 0.1.0-beta.126 → 0.1.0-beta.127

package/README.md

@@ -88,7 +88,7 @@ Legacy `.jsonl.gz` packs are upgraded to `.blpk` automatically on first search/c
 - Large graph layout API automatically uses compact payload encoding with link-coverage-aware edge selection to reduce initial client load without hiding major relationships.
 - Large-segment layout spacing now grows logarithmically to keep initial visual density consistent between medium and very large vaults (for example, ~1k vs ~50k notes).
 - Graph coordinates are visually compacted across graph sizes so reset starts from a stable fitted scene and zoom-in progressively reveals local detail.
-- Zoomed-out graph LOD renders hierarchy groups as normal mesh graph nodes and expands a group only after it is framed in the viewport, progressively hiding sibling groups in micro view.
+- Zoomed-out graph LOD renders hierarchy groups as normal mesh graph nodes and expands a group from the focused node's current viewport position only after it is framed, progressively hiding sibling groups in micro view.
 - Graph reset fits the full graph scene instead of starting in a separate macro overview mode.
 - Graph filtering runs in a dedicated browser worker to keep the UI thread responsive during heavy datasets.
 - Edge rendering budgets adapt to zoom level to prevent frame spikes on large graph panoramas.
@@ -606,7 +606,7 @@ The graph UI shows:
 - graph rendering safeguards (batched canvas drawing across graph sizes, edge draw caps, lower redraw rate, zoom-aware interaction)
 - adaptive CPU safeguards for large graphs: idle frame pacing, throttled background physics updates and cached viewport dimensions to reduce redraw/layout overhead while preserving interaction responsiveness
 - WebGL node and edge acceleration when supported, falling back to Canvas 2D without changing graph behavior
-- large graph LOD keeps a recursive graph-of-graphs mesh model: zoom-out shows one projected graph level capped at 1000 group nodes, zoom-in expands the framed node into its own radial child graph capped at 1000 nodes, micro view renders only that focused subgraph with dense-node label suppression in a local frame anchored to the group node, and zoom-out restores sibling groups
+- large graph LOD keeps a recursive graph-of-graphs mesh model: zoom-out shows one projected graph level capped at 1000 group nodes, zoom-in expands the framed node from its current viewport position into its own radial child graph capped at 1000 nodes, micro view renders only that focused subgraph with dense-node label suppression in a local frame anchored to the rendered group node, and zoom-out restores sibling groups
 
 The server indexes before starting by default. Use `--no-index` to skip that step:
 

package/dist/application/frontend/client-js.js

@@ -1281,9 +1281,9 @@ const arrangeGraphLevelNodes = (nodes, radiusForNode = () => 1) => {
   return arranged
 }
 
-const arrangeChildGraphNodes = (nodes, group) => {
+const arrangeChildGraphNodes = (nodes, group, origin = group) => {
   if (nodes.length <= 1) {
-    return nodes.map(node => ({ ...node, x: group.x, y: group.y }))
+    return nodes.map(node => ({ ...node, x: origin.x, y: origin.y }))
   }
 
   const targetRadius = childGraphRenderRadius(group)
@@ -1303,7 +1303,7 @@ const arrangeChildGraphNodes = (nodes, group) => {
     })
   const goldenAngle = Math.PI * (3 - Math.sqrt(5))
   const arranged = centerNode
-    ? [{ ...centerNode, x: group.x, y: group.y }]
+    ? [{ ...centerNode, x: origin.x, y: origin.y }]
     : []
 
   outerNodes.forEach((node, index) => {
@@ -1311,19 +1311,19 @@ const arrangeChildGraphNodes = (nodes, group) => {
     const angle = index * goldenAngle
     arranged.push({
       ...node,
-      x: group.x + Math.cos(angle) * ringRadius,
-      y: group.y + Math.sin(angle) * ringRadius
+      x: origin.x + Math.cos(angle) * ringRadius,
+      y: origin.y + Math.sin(angle) * ringRadius
     })
   })
 
   return arranged
 }
 
-const interpolateNodeFromGroup = (node, group, progress) => {
+const interpolateNodeFromGroup = (node, origin, progress) => {
   return {
     ...node,
-    x: group.x + (node.x - group.x) * progress,
-    y: group.y + (node.y - group.y) * progress,
+    x: origin.x + (node.x - origin.x) * progress,
+    y: origin.y + (node.y - origin.y) * progress,
     vx: 0,
     vy: 0
   }
@@ -1472,10 +1472,11 @@ const computeHierarchyRenderVisibility = (viewport) => {
   const focusIds = new Set(focus.nodeIds)
   const rawChildNodes = state.visibleNodes.filter(node => focusIds.has(node.id))
   const childLimit = Math.max(90, Math.min(renderNodeBudget, Math.floor(renderNodeBudget * progress)))
+  const focusRenderNode = groupNodes.find(node => node.groupId === focus.id) ?? createGroupRenderNode(focus)
   const childNodes = selectStableSampleNodes(
-    arrangeChildGraphNodes(rawChildNodes, focus),
+    arrangeChildGraphNodes(rawChildNodes, focus, focusRenderNode),
     childLimit
-  ).map(node => interpolateNodeFromGroup(node, focus, progress))
+  ).map(node => interpolateNodeFromGroup(node, focusRenderNode, progress))
   const childIds = new Set(childNodes.map(node => node.id))
   const childById = new Map(childNodes.map(node => [node.id, node]))
   const isMicroView = progress >= 0.72

package/docs/AGENT_USAGE.md

@@ -607,7 +607,7 @@ Without `--vault`, the graph UI serves `$HOME/.brainlink/vault`.
 
 The frontend includes an agent selector that shows only the agent id. Selecting an agent calls the same read APIs with `agent=<agent-id>` and renders that namespace instead of merging every agent into one graph.
 
-Graph navigation controls include zoom in, zoom out, fit visible nodes and reset-to-fit-all nodes. Mouse wheel zoom (including `cmd+scroll` and `ctrl+scroll`) is anchored to the cursor. Keyboard shortcuts are `+` (zoom in), `-` (zoom out) and `0` (reset fit). Double-click on canvas zooms in at cursor position. Totals for notes, links and tags stay visible as floating metrics under the Brainlink title, and node details open on click in a modal (tags, outgoing links, backlinks and Markdown content). Vaults above 1000 notes also expose stable hierarchy mesh groups of up to 1000 direct nodes, with recursive parent groups when a level exceeds 1000 groups; zoom-out renders the macro level as a projected mesh graph of group nodes, zoom-in expands a group only after it is framed in the viewport, and micro view renders only the focused radial child graph with dense-node label suppression in a local frame anchored to the group node until zoom-out restores sibling groups.
+Graph navigation controls include zoom in, zoom out, fit visible nodes and reset-to-fit-all nodes. Mouse wheel zoom (including `cmd+scroll` and `ctrl+scroll`) is anchored to the cursor. Keyboard shortcuts are `+` (zoom in), `-` (zoom out) and `0` (reset fit). Double-click on canvas zooms in at cursor position. Totals for notes, links and tags stay visible as floating metrics under the Brainlink title, and node details open on click in a modal (tags, outgoing links, backlinks and Markdown content). Vaults above 1000 notes also expose stable hierarchy mesh groups of up to 1000 direct nodes, with recursive parent groups when a level exceeds 1000 groups; zoom-out renders the macro level as a projected mesh graph of group nodes, zoom-in expands a group from the focused node's current viewport position only after it is framed, and micro view renders only the focused radial child graph with dense-node label suppression in a local frame anchored to the rendered group node until zoom-out restores sibling groups.
 During graph filtering, Brainlink keeps hub context nodes visible (`Memory Hub`/`MOC`/high-degree fallback) so filtered views still show relationship anchors.
 
 The command reindexes by default, then serves:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andespindola/brainlink",
-  "version": "0.1.0-beta.126",
+  "version": "0.1.0-beta.127",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",