@andespindola/brainlink 0.1.0-beta.90 → 0.1.0-beta.92

package/README.md

@@ -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: graphs up to 1000 notes render directly; larger graphs use a compact memory-hub-centered mesh of connected 1000-note points, zoom-in spreads only focused clusters into 250-note and 60-note subgraphs with aggregated real links plus local sibling mesh links, keeps parent points during expansion to avoid visual jumps, 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 a compact memory-hub-centered mesh of small connected 1000-note points, zoom-in delays expansion until the focused cluster is visually close, then continuously spreads and fades only focused clusters through 500-note, 250-note, 125-note and 60-note subgraphs with aggregated real links plus local sibling mesh links, keeps parent points during expansion to avoid visual jumps, 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

@@ -23,14 +23,20 @@ const transformCoordinateLimit = 20_000_000
 const hoverHitTestIntervalMs = 64
 const ecosystemGroupSize = 1000
 const ecosystemActivationNodeThreshold = 1000
-const ecosystemGroupSizes = [1000, 250, 60]
+const ecosystemGroupSizes = [1000, 500, 250, 125, 60]
 const ecosystemClusterEdgeLimit = 520
 const ecosystemHubEdgeLimit = 120
 const ecosystemSiblingEdgeLimit = 180
-const ecosystemClusterScaleThreshold = 0.32
+const ecosystemClusterScaleThreshold = 0.78
 const ecosystemSubgraphScaleThreshold = 0.18
 const ecosystemMicroScaleThreshold = 0.08
-const ecosystemFocusedParentLimit = 3
+const ecosystemFocusedParentLimit = 2
+const ecosystemExpansionLevels = [
+  { parentSize: 1000, childSize: 500, start: 0.16, end: 0.34 },
+  { parentSize: 500, childSize: 250, start: 0.3, end: 0.5 },
+  { parentSize: 250, childSize: 125, start: 0.46, end: 0.66 },
+  { parentSize: 125, childSize: 60, start: 0.62, end: 0.78 }
+]
 const zoomRecoveryGuardMs = 4200
 const zoomCapTargetViewportShare = 0.72
 const meshEdgeScaleThreshold = 0.09
@@ -737,9 +743,11 @@ const selectEcosystemRepresentative = nodes => {
 }
 
 const ecosystemLayoutSpacingForSize = size => {
-  if (size >= 1000) return 360
-  if (size >= 250) return 92
-  return 28
+  if (size >= 1000) return 260
+  if (size >= 500) return 92
+  if (size >= 250) return 52
+  if (size >= 125) return 28
+  return 16
 }
 
 const ecosystemCompactPoint = (index, total, center, spacing) => {
@@ -886,7 +894,9 @@ const smoothStep = value => {
 const zoomProgress = (scale, start, end) =>
   smoothStep((scale - start) / Math.max(end - start, 0.0001))
 
-const shouldReplaceParentCluster = spread => spread >= 0.96
+const semanticZoomSpread = progress => Math.pow(progress, 2.6)
+
+const opacityForSpread = spread => 0.03 + smoothStep(spread) * 0.97
 
 const expandFocusedClusters = (parentClusters, childSize, spread, viewport) => {
   const focusPoint = ecosystemFocusPoint()
@@ -909,13 +919,17 @@ const expandFocusedClusters = (parentClusters, childSize, spread, viewport) => {
 
 const spreadChildClusterFromParent = (cluster, spread) => {
   if (!Number.isFinite(cluster.parentX) || !Number.isFinite(cluster.parentY)) {
-    return cluster
+    return {
+      ...cluster,
+      lodOpacity: opacityForSpread(spread)
+    }
   }
 
   return {
     ...cluster,
     x: cluster.parentX + (cluster.x - cluster.parentX) * spread,
-    y: cluster.parentY + (cluster.y - cluster.parentY) * spread
+    y: cluster.parentY + (cluster.y - cluster.parentY) * spread,
+    lodOpacity: opacityForSpread(spread)
   }
 }
 
@@ -923,61 +937,24 @@ const selectHierarchicalEcosystemClusters = viewport => {
   const baseClusters = state.ecosystemClustersBySize.get(ecosystemGroupSize) ?? state.ecosystemClusters
   const visibleBaseClusters = filterEcosystemClustersByViewport(baseClusters, viewport)
   const hubClusters = state.ecosystemHubCluster ? [state.ecosystemHubCluster] : []
+  const visibleClusters = [...visibleBaseClusters]
 
-  if (state.transform.scale <= ecosystemMicroScaleThreshold) {
-    return [...hubClusters, ...visibleBaseClusters]
-  }
-
-  const midExpansion = expandFocusedClusters(
-    visibleBaseClusters,
-    250,
-    state.transform.scale <= ecosystemSubgraphScaleThreshold
-      ? zoomProgress(state.transform.scale, ecosystemMicroScaleThreshold, ecosystemSubgraphScaleThreshold)
-      : 1,
-    viewport
-  )
-  if (midExpansion.childClusters.length === 0) {
-    return [...hubClusters, ...visibleBaseClusters]
-  }
-
-  const midSpread = state.transform.scale <= ecosystemSubgraphScaleThreshold
-    ? zoomProgress(state.transform.scale, ecosystemMicroScaleThreshold, ecosystemSubgraphScaleThreshold)
-    : 1
-  const remainingBaseClusters = shouldReplaceParentCluster(midSpread)
-    ? visibleBaseClusters.filter(cluster => !midExpansion.expandedParentIds.has(cluster.id))
-    : visibleBaseClusters
-  if (state.transform.scale <= ecosystemSubgraphScaleThreshold) {
-    return [
-      ...hubClusters,
-      ...remainingBaseClusters,
-      ...midExpansion.childClusters
-    ]
-  }
-
-  const microExpansion = expandFocusedClusters(
-    midExpansion.childClusters,
-    60,
-    zoomProgress(state.transform.scale, ecosystemSubgraphScaleThreshold, ecosystemClusterScaleThreshold),
-    viewport
-  )
-  if (microExpansion.childClusters.length === 0) {
-    return [
-      ...hubClusters,
-      ...remainingBaseClusters,
-      ...midExpansion.childClusters
-    ]
+  for (let index = 0; index < ecosystemExpansionLevels.length; index += 1) {
+    const level = ecosystemExpansionLevels[index]
+    const parentClusters = visibleClusters.filter(cluster => cluster.size === level.parentSize)
+    if (parentClusters.length === 0) {
+      continue
+    }
+    const progress = zoomProgress(state.transform.scale, level.start, level.end)
+    if (progress <= 0.025) {
+      continue
+    }
+    const spread = semanticZoomSpread(progress)
+    const expansion = expandFocusedClusters(parentClusters, level.childSize, spread, viewport)
+    visibleClusters.push(...expansion.childClusters)
   }
 
-  const microSpread = zoomProgress(state.transform.scale, ecosystemSubgraphScaleThreshold, ecosystemClusterScaleThreshold)
-  const visibleMidClusters = shouldReplaceParentCluster(microSpread)
-    ? midExpansion.childClusters.filter(cluster => !microExpansion.expandedParentIds.has(cluster.id))
-    : midExpansion.childClusters
-  return [
-    ...hubClusters,
-    ...remainingBaseClusters,
-    ...visibleMidClusters,
-    ...microExpansion.childClusters
-  ]
+  return [...hubClusters, ...visibleClusters]
 }
 
 const ecosystemSiblingEdgesForClusters = (clusters, existingEdges) => {
@@ -2553,15 +2530,18 @@ const clusterRadiusPx = cluster => {
     return 10
   }
   if (cluster.isHub) {
-    return 5.2
+    return 4.2
   }
   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))
+    const base = cluster.size >= 1000 ? 1.2 : cluster.size >= 500 ? 1.1 : cluster.size >= 250 ? 1 : cluster.size >= 125 ? 0.92 : 0.86
+    return Math.max(0.85, Math.min(2.45, base + Math.log10(cluster.count + 1) * 0.18))
   }
   return Math.max(8, Math.min(28, 8 + Math.log2(cluster.count + 1) * 3))
 }
 
+const clusterOpacity = cluster =>
+  Math.max(0, Math.min(1, Number.isFinite(cluster.lodOpacity) ? cluster.lodOpacity : 1))
+
 const worldViewportBounds = () => {
   const rect = canvas.getBoundingClientRect()
   const width = Math.max(rect.width, 320)
@@ -2977,23 +2957,32 @@ const render = now => {
     ctx.scale(state.transform.scale, state.transform.scale)
     const safeScale = Math.max(state.transform.scale, 0.0001)
     if (state.renderClusterEdges.length > 0) {
-      ctx.beginPath()
       for (let index = 0; index < state.renderClusterEdges.length; index += 1) {
         const edge = state.renderClusterEdges[index]
+        const edgeOpacity = Math.min(clusterOpacity(edge.sourceCluster), clusterOpacity(edge.targetCluster))
+        if (edgeOpacity <= 0.01) {
+          continue
+        }
+        ctx.beginPath()
         ctx.moveTo(edge.sourceCluster.x, edge.sourceCluster.y)
         ctx.lineTo(edge.targetCluster.x, edge.targetCluster.y)
+        ctx.lineWidth = 1.2 / safeScale
+        ctx.strokeStyle = 'rgba(153, 165, 181, ' + (edge.inferred ? 0.14 : 0.22) * edgeOpacity + ')'
+        ctx.stroke()
       }
-      ctx.lineWidth = 1.2 / safeScale
-      ctx.strokeStyle = 'rgba(153, 165, 181, 0.22)'
-      ctx.stroke()
     }
     state.renderClusters.forEach(cluster => {
       const isMacro = cluster.id === 'macro-galaxy'
       const isEcosystem = String(cluster.id).startsWith('ecosystem-')
       const isHub = Boolean(cluster.isHub)
+      const opacity = clusterOpacity(cluster)
+      if (opacity <= 0.01) {
+        return
+      }
       const radiusPx = clusterRadiusPx(cluster)
       const radius = radiusPx / safeScale
       const haloRadius = (radiusPx + (isMacro ? 8 : isHub ? 4 : isEcosystem ? 1.1 : 4)) / safeScale
+      ctx.globalAlpha = opacity
       if (isHub || !isEcosystem || state.transform.scale >= ecosystemSubgraphScaleThreshold) {
         ctx.beginPath()
         ctx.arc(cluster.x, cluster.y, haloRadius, 0, Math.PI * 2)
@@ -3014,6 +3003,7 @@ const render = now => {
         ctx.textBaseline = 'top'
         ctx.fillText(cluster.representative.title.slice(0, 28), cluster.x, cluster.y + (radiusPx + 9) / safeScale)
       }
+      ctx.globalAlpha = 1
       // Keep cluster markers minimal and faster to draw on large graphs.
     })
     ctx.restore()

package/package.json

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