@andespindola/brainlink 0.1.0-beta.73 → 0.1.0-beta.75

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: zoomed-out views prefer lightweight clusters, then progressively reveal nodes and edges as zoom increases
+- massive-graph LOD progression: very low zoom uses spatial overview sampling to preserve whole-vault shape while keeping node visuals consistent, 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

@@ -26,6 +26,7 @@ const meshEdgeScaleThreshold = 0.09
 const meshEdgeMinBudget = 140
 const meshEdgeMaxBudget = 1400
 const layeredCoreScaleThreshold = 0.55
+const massiveOverviewClusterScaleThreshold = 0.035
 const dragNeighborhoodMaxAffected = 180
 const dragSettleRounds = 3
 const wheelZoomExponent = 0.0018
@@ -1757,6 +1758,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 })
@@ -1810,6 +1823,20 @@ const computeRenderVisibility = () => {
 
   if (state.visibleNodes.length > massiveGraphNodeThreshold) {
     const viewportNodes = viewportNodesFromSpatialIndex(viewport)
+    if (state.transform.scale <= massiveOverviewClusterScaleThreshold) {
+      const overviewClusters = filterOverviewClustersByViewport(viewport)
+        .sort((left, right) => right.count - left.count)
+        .slice(0, Math.min(renderNodeBudget, clusterBudgetForScale(state.transform.scale)))
+      if (overviewClusters.length > 0) {
+        state.renderClusters = []
+        state.renderNodes = representativeNodesFromClusters(
+          overviewClusters,
+          Math.min(renderNodeBudget, clusterBudgetForScale(state.transform.scale))
+        )
+        state.renderEdges = []
+        return
+      }
+    }
     const sourceNodes = viewportNodes.length > 0 ? viewportNodes : state.visibleNodes
     const sampleLimit = nodeBudgetForScale(state.transform.scale)
     const carryMargin = Math.max(240, Math.min(1200, 340 / Math.max(state.transform.scale, 0.0001)))
@@ -1865,8 +1892,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.73",
+  "version": "0.1.0-beta.75",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",