@andespindola/brainlink 0.1.0-beta.74 → 0.1.0-beta.76

package/README.md

@@ -594,7 +594,7 @@ The graph UI shows:
 - double-click on canvas zooms in at cursor position
 - floating graph totals (notes, links, tags) below the Brainlink title
 - large-graph rendering safeguards (edge draw caps, lower redraw rate, zoom-aware interaction)
-- massive-graph LOD progression: very low zoom uses spatial overview clusters to preserve whole-vault shape, then progressively reveals nodes and edges as zoom increases
+- massive-graph LOD progression: very low zoom uses spatial overview sampling plus hub-neighborhood edge previews to preserve whole-vault shape and orientation, then progressively reveals nodes and edges as zoom increases
 
 The server indexes before starting by default. Use `--no-index` to skip that step:
 

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

@@ -1110,6 +1110,64 @@ const enrichSampleWithNeighbors = (nodes) => {
   }
 }
 
+const includeHubPreviewNeighborhood = (nodes, limit) => {
+  const hub = state.primaryHub
+  if (!hub) {
+    return nodes
+  }
+
+  const maxNodes = Math.max(1, Math.min(renderNodeBudget, limit))
+  const merged = [...nodes]
+  const ids = new Set(merged.map((node) => node.id))
+
+  if (!ids.has(hub.id)) {
+    if (merged.length < maxNodes) {
+      merged.push(hub)
+      ids.add(hub.id)
+    } else {
+      const replaceIndex = merged.findIndex((node) => node.id !== hub.id)
+      if (replaceIndex >= 0) {
+        ids.delete(merged[replaceIndex].id)
+        merged[replaceIndex] = hub
+        ids.add(hub.id)
+      }
+    }
+  }
+
+  const hubEdges = [...(state.visibleEdgeByNode.get(hub.id) ?? [])]
+    .filter((edge) => edge.target && (edge.source === hub.id || edge.target === hub.id))
+    .sort((left, right) => {
+      const byWeight = edgeWeight(right) - edgeWeight(left)
+      if (byWeight !== 0) return byWeight
+
+      const leftOtherId = left.source === hub.id ? left.target : left.source
+      const rightOtherId = right.source === hub.id ? right.target : right.source
+      const leftDegree = state.nodeDegrees.get(leftOtherId ?? '') ?? 0
+      const rightDegree = state.nodeDegrees.get(rightOtherId ?? '') ?? 0
+      if (leftDegree !== rightDegree) return rightDegree - leftDegree
+
+      return edgeIdentityKey(left).localeCompare(edgeIdentityKey(right))
+    })
+
+  for (let index = 0; index < hubEdges.length && merged.length < maxNodes; index += 1) {
+    const edge = hubEdges[index]
+    const otherId = edge.source === hub.id ? edge.target : edge.source
+    if (!otherId || ids.has(otherId)) {
+      continue
+    }
+
+    const otherNode = state.nodeById.get(otherId)
+    if (!otherNode) {
+      continue
+    }
+
+    ids.add(otherId)
+    merged.push(otherNode)
+  }
+
+  return merged
+}
+
 const ensureHubNodesInRenderedSet = (nodes) => {
   if (nodes.length === 0) {
     return nodes
@@ -1758,6 +1816,18 @@ const clusterViewportNodes = viewportNodes => {
     }))
 }
 
+const representativeNodesFromClusters = (clusters, limit) => {
+  const representatives = clusters
+    .map((cluster) => cluster.representative)
+    .filter((node) => Boolean(node))
+  const merged = mergeUniqueNodes(
+    representatives,
+    state.renderNodes ?? [],
+    Math.max(1, limit)
+  )
+  return ensureHubNodesInRenderedSet(merged)
+}
+
 const computeRenderVisibility = () => {
   if (!hasValidTransform()) {
     fitView({ useFiltered: true })
@@ -1816,8 +1886,11 @@ const computeRenderVisibility = () => {
         .sort((left, right) => right.count - left.count)
         .slice(0, Math.min(renderNodeBudget, clusterBudgetForScale(state.transform.scale)))
       if (overviewClusters.length > 0) {
-        state.renderClusters = overviewClusters
-        state.renderNodes = overviewClusters.map((cluster) => cluster.representative)
+        state.renderClusters = []
+        state.renderNodes = representativeNodesFromClusters(
+          overviewClusters,
+          Math.min(renderNodeBudget, clusterBudgetForScale(state.transform.scale))
+        )
         state.renderEdges = []
         return
       }
@@ -1848,9 +1921,15 @@ const computeRenderVisibility = () => {
       sampledRaw,
       Math.min(sampleLimit, renderNodeBudget)
     )
-    const sampledIds = new Set(sampled.map((node) => node.id))
-    let sampledEdges = state.transform.scale >= 0.035 ? collectVisibleEdgesForNodes(sampledIds) : []
     let sampledNodes = ensureHubNodesInRenderedSet(sampled)
+    if (state.transform.scale < 0.035) {
+      sampledNodes = includeHubPreviewNeighborhood(
+        sampledNodes,
+        Math.min(renderNodeBudget, sampleLimit + 160)
+      )
+    }
+    const sampledIds = new Set(sampledNodes.map((node) => node.id))
+    let sampledEdges = collectVisibleEdgesForNodes(sampledIds)
 
     if (state.transform.scale >= 0.035 && sampledEdges.length === 0) {
       const enriched = enrichSampleWithNeighbors(sampledNodes)
@@ -1877,8 +1956,8 @@ const computeRenderVisibility = () => {
   const viewportNodes = viewportNodesFromSpatialIndex(viewport)
   const clusters = clusterViewportNodes(viewportNodes)
   if (clusters.length > 0) {
-    state.renderClusters = clusters
-    state.renderNodes = clusters.map(cluster => cluster.representative)
+    state.renderClusters = []
+    state.renderNodes = representativeNodesFromClusters(clusters, Math.min(renderNodeBudget, 900))
     state.renderEdges = []
     return
   }

package/package.json

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