@andespindola/brainlink 0.1.0-beta.86 → 0.1.0-beta.87

package/README.md

@@ -84,7 +84,7 @@ Legacy `.jsonl.gz` packs are upgraded to `.blpk` automatically on first search/c
 - Graph renderer optimized for large datasets with viewport-driven node culling and edge lookup by visible nodes.
 - Canvas graph rendering uses the same batched node and edge pipeline for every graph size, reducing per-frame draw calls while keeping selected and hovered items highlighted.
 - WebGL acceleration is used when available for dense node and edge drawing, with Canvas 2D preserved as the interaction and fallback layer.
-- Graph zoom-out renders hierarchical ecosystem subgraphs: macro clusters of up to 1000 notes expand near the user's focus into smaller graph meshes before individual notes are rendered.
+- Graph zoom-out renders hierarchical ecosystem subgraphs only above 1000 notes: distant groups stay as small sand-like points and expand near the user's focus into smaller graph meshes before individual notes are rendered.
 - 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 macro mass and zoom-in progressively expands toward local detail.
@@ -602,7 +602,7 @@ The graph UI shows:
 - WebGL node and edge acceleration when supported, falling back to Canvas 2D without changing graph behavior
 - compact macro-to-micro density progression so reset keeps the graph mass oriented and zoom-in separates local neighborhoods progressively
 - graph camera treats hub-centered navigation as structural only when the hub is dominant; diffuse stress graphs reset and zoom around the full graph mass
-- graph LOD progression: very low zoom uses connected ecosystem clusters of up to 1000 notes, zoom-in expands only focused clusters into 250-note and 60-note subgraphs with aggregated real links, then progressively raises the focused node budget so local areas keep nearby notes and links visible
+- graph LOD progression: graphs up to 1000 notes render directly; larger graphs use connected sand-like ecosystem points of up to 1000 notes, zoom-in spreads only focused clusters into 250-note and 60-note subgraphs with aggregated real links, then progressively raises the focused node budget so local areas keep nearby notes and links visible
 
 The server indexes before starting by default. Use `--no-index` to skip that step:
 

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

@@ -22,6 +22,7 @@ const worldCoordinateLimit = 5_000_000
 const transformCoordinateLimit = 20_000_000
 const hoverHitTestIntervalMs = 64
 const ecosystemGroupSize = 1000
+const ecosystemActivationNodeThreshold = 1000
 const ecosystemGroupSizes = [1000, 250, 60]
 const ecosystemClusterEdgeLimit = 520
 const ecosystemClusterScaleThreshold = 0.32
@@ -569,7 +570,7 @@ const recomputeVisibility = () => {
   state.visibleEdges = limitedEdges
   state.visibleNodeSpatial = createSpatialIndex(nodes)
   state.visibleEdgeByNode = createVisibleEdgeLookup(limitedEdges)
-  const ecosystemGraph = nodes.length > 1
+  const ecosystemGraph = nodes.length > ecosystemActivationNodeThreshold
     ? buildEcosystemGraph(nodes)
     : { clusters: [], clustersBySize: new Map() }
   state.ecosystemClusters = ecosystemGraph.clusters
@@ -759,7 +760,9 @@ const buildEcosystemLevel = (sortedNodes, size, parentLookup) => {
       ...buildEcosystemCluster(clusterNodes, clusters.length),
       id: 'ecosystem-' + size + '-' + clusters.length,
       size,
-      parentId: parentCluster?.id ?? null
+      parentId: parentCluster?.id ?? null,
+      parentX: parentCluster?.x ?? null,
+      parentY: parentCluster?.y ?? null
     }
     clusters.push(cluster)
     for (let index = 0; index < clusterNodes.length; index += 1) {
@@ -821,14 +824,42 @@ const nearestEcosystemParentIds = (clusters, focusPoint, limit) =>
     .slice(0, limit)
     .map(item => item.cluster.id)
 
+const smoothStep = value => {
+  const clamped = Math.max(0, Math.min(1, value))
+  return clamped * clamped * (3 - clamped * 2)
+}
+
+const zoomProgress = (scale, start, end) =>
+  smoothStep((scale - start) / Math.max(end - start, 0.0001))
+
 const ecosystemPlanForScale = scale => {
   if (scale <= ecosystemMicroScaleThreshold) {
-    return { baseSize: 1000, childSize: null }
+    return { baseSize: 1000, childSize: null, spread: 0 }
   }
   if (scale <= ecosystemSubgraphScaleThreshold) {
-    return { baseSize: 1000, childSize: 250 }
+    return {
+      baseSize: 1000,
+      childSize: 250,
+      spread: zoomProgress(scale, ecosystemMicroScaleThreshold, ecosystemSubgraphScaleThreshold)
+    }
+  }
+  return {
+    baseSize: 250,
+    childSize: 60,
+    spread: zoomProgress(scale, ecosystemSubgraphScaleThreshold, ecosystemClusterScaleThreshold)
+  }
+}
+
+const spreadChildClusterFromParent = (cluster, spread) => {
+  if (!Number.isFinite(cluster.parentX) || !Number.isFinite(cluster.parentY)) {
+    return cluster
+  }
+
+  return {
+    ...cluster,
+    x: cluster.parentX + (cluster.x - cluster.parentX) * spread,
+    y: cluster.parentY + (cluster.y - cluster.parentY) * spread
   }
-  return { baseSize: 250, childSize: 60 }
 }
 
 const selectHierarchicalEcosystemClusters = viewport => {
@@ -850,7 +881,7 @@ const selectHierarchicalEcosystemClusters = viewport => {
   const visibleChildClusters = childClusters.filter(cluster =>
     expandedParentIds.has(cluster.parentId) &&
     isClusterInViewport(cluster, viewport)
-  )
+  ).map(cluster => spreadChildClusterFromParent(cluster, plan.spread))
 
   if (visibleChildClusters.length === 0) {
     return visibleBaseClusters
@@ -2337,6 +2368,17 @@ const baseNodeRadius = node => {
 
 const nodeRadius = node => Math.max(baseNodeRadius(node), minNodePixelRadius / Math.max(state.transform.scale, 0.0001))
 
+const clusterRadiusPx = cluster => {
+  if (cluster.id === 'macro-galaxy') {
+    return 10
+  }
+  if (String(cluster.id).startsWith('ecosystem-')) {
+    const base = cluster.size >= 1000 ? 2.4 : cluster.size >= 250 ? 2.1 : 1.8
+    return Math.max(1.8, Math.min(4.2, base + Math.log10(cluster.count + 1) * 0.28))
+  }
+  return Math.max(8, Math.min(28, 8 + Math.log2(cluster.count + 1) * 3))
+}
+
 const worldViewportBounds = () => {
   const rect = canvas.getBoundingClientRect()
   const width = Math.max(rect.width, 320)
@@ -2498,7 +2540,11 @@ const computeRenderVisibility = () => {
     return
   }
 
-  if (state.transform.scale <= ecosystemClusterScaleThreshold && state.ecosystemClusters.length > 0) {
+  if (
+    state.visibleNodes.length > ecosystemActivationNodeThreshold &&
+    state.transform.scale <= ecosystemClusterScaleThreshold &&
+    state.ecosystemClusters.length > 0
+  ) {
     const clusters = selectHierarchicalEcosystemClusters(viewport)
       .sort((left, right) => right.count - left.count)
     state.renderClusters = clusters
@@ -2760,20 +2806,21 @@ const render = now => {
     }
     state.renderClusters.forEach(cluster => {
       const isMacro = cluster.id === 'macro-galaxy'
-      const radiusPx = isMacro
-        ? 10
-        : Math.max(8, Math.min(28, 8 + Math.log2(cluster.count + 1) * 3))
+      const isEcosystem = String(cluster.id).startsWith('ecosystem-')
+      const radiusPx = clusterRadiusPx(cluster)
       const radius = radiusPx / safeScale
-      const haloRadius = (radiusPx + (isMacro ? 8 : 4)) / safeScale
-      ctx.beginPath()
-      ctx.arc(cluster.x, cluster.y, haloRadius, 0, Math.PI * 2)
-      ctx.fillStyle = isMacro ? 'rgba(243, 247, 251, 0.28)' : graphTheme.nodeHalo
-      ctx.fill()
+      const haloRadius = (radiusPx + (isMacro ? 8 : isEcosystem ? 1.1 : 4)) / safeScale
+      if (!isEcosystem || state.transform.scale >= ecosystemSubgraphScaleThreshold) {
+        ctx.beginPath()
+        ctx.arc(cluster.x, cluster.y, haloRadius, 0, Math.PI * 2)
+        ctx.fillStyle = isMacro ? 'rgba(243, 247, 251, 0.28)' : graphTheme.nodeHalo
+        ctx.fill()
+      }
       ctx.beginPath()
       ctx.arc(cluster.x, cluster.y, radius, 0, Math.PI * 2)
       ctx.fillStyle = isMacro ? '#f3f7fb' : graphTheme.node
       ctx.fill()
-      ctx.lineWidth = 1.4 / safeScale
+      ctx.lineWidth = (isEcosystem ? 0.7 : 1.4) / safeScale
       ctx.strokeStyle = isMacro ? '#ffffff' : graphTheme.nodeStroke
       ctx.stroke()
       if (isMacro && cluster.representative?.title) {

package/package.json

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