@andespindola/brainlink 0.1.0-beta.103 → 0.1.0-beta.105

package/README.md

@@ -600,10 +600,11 @@ The graph UI shows:
 - double-click on canvas zooms in at cursor position
 - floating graph totals (notes, links, tags) below the Brainlink title
 - 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
 - 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 one recursive model where each visible level targets up to 999 non-hub nodes, starts from a memory-hub-centered mesh, and each supernode can expand into another same-shape subgraph level (again up to 999 children) with latent fade-in, aggregated real links and local sibling mesh links so org-heavy and stress-50k follow the same structure at different depths; for massive graphs the first expansion starts much deeper in zoom, low-size child levels use slower easing, and expansion is additionally gated by focus readiness (screen-space isolation of the focused parent) so child levels open only when that subgraph is truly centered and separated in view
+- graph LOD progression: hierarchical rendering now follows one recursive graph-of-graphs standard whenever a graph has more than one hierarchy level; each level expands through intermediate subgraph sizes (instead of jumping directly to leaves), starts from a memory-hub-centered mesh, and each supernode can expand into another same-shape subgraph level (up to 999 children) with latent fade-in, aggregated real links and local sibling mesh links so org-heavy-like and stress-50k-like structures share the same layered behavior at different depths; for massive graphs the first expansion starts deeper in zoom and is additionally gated by focus readiness (screen-space isolation of the focused parent) so child levels open only when that subgraph is truly centered and separated in view
 
 The server indexes before starting by default. Use `--no-index` to skip that step:
 

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

@@ -42,6 +42,10 @@ const dragSettleRounds = 3
 const wheelZoomExponent = 0.0009
 const wheelZoomExponentCap = 0.035
 const wheelZoomModifierBoost = 1.08
+const physicsDragFrameIntervalMs = 16
+const physicsIdleFrameIntervalMs = 78
+const physicsLargeGraphIdleFrameIntervalMs = 108
+const physicsStepDeltaCapMs = 96
 const state = {
   graph: { nodes: [], edges: [] },
   nodes: [],
@@ -67,7 +71,10 @@ const state = {
   graphSignature: '',
   graphStatus: '',
   graphTotals: { nodes: 0, edges: 0 },
+  viewport: { width: 320, height: 320 },
   last: performance.now(),
+  lastPhysicsAt: performance.now(),
+  physicsRestFrames: 0,
   offscreenFrameCount: 0,
   recoveringViewport: false,
   renderVisibilityDirty: true,
@@ -434,6 +441,7 @@ const resize = () => {
     glCanvas.width = Math.floor(width * ratio)
     glCanvas.height = Math.floor(height * ratio)
   }
+  state.viewport = { width, height }
   ctx.setTransform(ratio, 0, 0, ratio, 0, 0)
   markRenderDirty()
 }
@@ -588,7 +596,7 @@ const recomputeVisibility = () => {
       y: macroHub ? macroHub.y : (bounds.minY + bounds.maxY) / 2
     }
     : { x: 0, y: 0 }
-  const ecosystemGraph = nodes.length > ecosystemActivationNodeThreshold
+  const ecosystemGraph = nodes.length > 1
     ? buildEcosystemGraph(nodes, state.macroCenter, primaryHub)
     : {
         clusters: [],
@@ -760,12 +768,29 @@ const ecosystemLayoutSpacingForSize = size => {
   return 7
 }
 
+const buildIntermediateEcosystemSizes = (fromSize, toSize) => {
+  if (fromSize <= toSize + 1) {
+    return []
+  }
+  const intermediate = []
+  let current = fromSize
+  while (current > toSize + 1) {
+    const stepped = Math.max(toSize + 1, Math.ceil(current / 3))
+    if (stepped >= current) {
+      break
+    }
+    intermediate.push(stepped)
+    current = stepped
+  }
+  return intermediate
+}
+
 const buildEcosystemLevelSizes = nodeCount => {
   if (nodeCount <= 0) return []
-  const sizes = []
+  const primarySizes = []
   let currentSize = Math.max(1, Math.ceil(nodeCount / ecosystemLevelNodeCap))
   while (currentSize >= 1) {
-    sizes.push(currentSize)
+    primarySizes.push(currentSize)
     if (currentSize === 1) {
       break
     }
@@ -775,7 +800,28 @@ const buildEcosystemLevelSizes = nodeCount => {
     }
     currentSize = nextSize
   }
-  return sizes
+  const expandedSizes = []
+  for (let index = 0; index < primarySizes.length; index += 1) {
+    const size = primarySizes[index]
+    if (expandedSizes.length === 0 || expandedSizes[expandedSizes.length - 1] !== size) {
+      expandedSizes.push(size)
+    }
+    const nextSize = primarySizes[index + 1]
+    if (!Number.isFinite(nextSize)) {
+      continue
+    }
+    const intermediate = buildIntermediateEcosystemSizes(size, nextSize)
+    for (let intermediateIndex = 0; intermediateIndex < intermediate.length; intermediateIndex += 1) {
+      const candidate = intermediate[intermediateIndex]
+      if (expandedSizes[expandedSizes.length - 1] !== candidate) {
+        expandedSizes.push(candidate)
+      }
+    }
+  }
+  if (expandedSizes[expandedSizes.length - 1] !== 1) {
+    expandedSizes.push(1)
+  }
+  return expandedSizes
 }
 
 const buildEcosystemExpansionLevels = (levelSizes, nodeCount) => {
@@ -786,12 +832,12 @@ const buildEcosystemExpansionLevels = (levelSizes, nodeCount) => {
   const maxScale = isMassive
     ? massiveEcosystemClusterScaleThreshold
     : ecosystemClusterScaleThreshold
-  const startScale = isMassive ? 0.82 : 0.18
+  const startScale = isMassive ? 1.12 : 0.24
   const transitionCount = levelSizes.length - 1
   const usableScale = Math.max(0.08, maxScale - startScale)
   const step = usableScale / transitionCount
-  const stride = isMassive ? 0.9 : 0.78
-  const overlap = isMassive ? 1.28 : 1.75
+  const stride = isMassive ? 0.93 : 0.82
+  const overlap = isMassive ? 1.22 : 1.62
   const levels = []
   for (let index = 0; index < transitionCount; index += 1) {
     const start = startScale + step * index * stride
@@ -2565,7 +2611,7 @@ const scheduleContentFilterSync = () => {
   }
 }
 
-const tick = delta => {
+const tick = (delta, now) => {
   const nodes = state.renderNodes.length > 0 ? state.renderNodes : state.visibleNodes
   const edges = state.renderEdges.length > 0 ? state.renderEdges : state.visibleEdges
   const shouldRunPhysics =
@@ -2573,9 +2619,24 @@ const tick = delta => {
     nodes.length <= 320 &&
     state.transform.scale >= 0.08
   if (!shouldRunPhysics) {
+    state.physicsRestFrames = 0
+    return
+  }
+  const isDragging = Boolean(state.pointer.dragNode)
+  const intervalMs = isDragging
+    ? physicsDragFrameIntervalMs
+    : state.nodes.length > largeGraphNodeThreshold
+      ? physicsLargeGraphIdleFrameIntervalMs
+      : physicsIdleFrameIntervalMs
+  if (!isDragging && state.physicsRestFrames >= 18) {
+    return
+  }
+  const elapsedSincePhysics = now - state.lastPhysicsAt
+  if (elapsedSincePhysics < intervalMs) {
     return
   }
-  const strength = Math.min(delta / 16, 2)
+  state.lastPhysicsAt = now
+  const strength = Math.min(Math.max(elapsedSincePhysics, delta, 16) / 16, physicsStepDeltaCapMs / 16)
 
   edges.forEach(edge => {
     const source = edge.sourceNode
@@ -2617,6 +2678,7 @@ const tick = delta => {
     }
   }
 
+  let kinetic = 0
   nodes.forEach(node => {
     node.vx = Number.isFinite(node.vx) ? node.vx : 0
     node.vy = Number.isFinite(node.vy) ? node.vy : 0
@@ -2633,7 +2695,16 @@ const tick = delta => {
     node.vy *= 0.88
     node.x += node.vx * strength
     node.y += node.vy * strength
+    kinetic += Math.abs(node.vx) + Math.abs(node.vy)
   })
+  if (isDragging) {
+    state.physicsRestFrames = 0
+    return
+  }
+  const kineticFloor = Math.max(0.16, nodes.length * 0.01)
+  state.physicsRestFrames = kinetic <= kineticFloor
+    ? state.physicsRestFrames + 1
+    : 0
 }
 
 const worldPoint = event => {
@@ -2789,9 +2860,8 @@ 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)
-  const height = Math.max(rect.height, 320)
+  const width = Math.max(state.viewport.width, 320)
+  const height = Math.max(state.viewport.height, 320)
   const paddingMultiplier =
     state.nodes.length > massiveGraphNodeThreshold
       ? (state.transform.scale >= 0.6 ? 2.8 : state.transform.scale >= 0.25 ? 2.35 : 1.9)
@@ -2953,7 +3023,7 @@ const computeRenderVisibility = () => {
     ? massiveEcosystemClusterScaleThreshold
     : ecosystemClusterScaleThreshold
   if (
-    state.visibleNodes.length > ecosystemActivationNodeThreshold &&
+    state.ecosystemExpansionLevels.length > 0 &&
     state.transform.scale <= ecosystemScaleThreshold &&
     state.ecosystemClusters.length > 0
   ) {
@@ -3136,10 +3206,10 @@ const render = now => {
   state.last = now
   const backgroundFrameIntervalMs =
     state.nodes.length > massiveGraphNodeThreshold
-      ? (state.transform.scale < 0.035 ? 130 : state.transform.scale < 0.08 ? 110 : 86)
+      ? (state.transform.scale < 0.035 ? 156 : state.transform.scale < 0.08 ? 128 : 98)
       : state.nodes.length > largeGraphNodeThreshold
-        ? 64
-        : 16
+        ? 72
+        : 18
   const isInteracting =
     state.pointer.down ||
     state.renderVisibilityDirty ||
@@ -3152,6 +3222,7 @@ const render = now => {
   const rect = canvas.getBoundingClientRect()
   const width = Math.max(rect.width, 320)
   const height = Math.max(rect.height, 320)
+  state.viewport = { width, height }
   sanitizeGraphState()
   if (!hasValidTransform()) {
     resetView()
@@ -3168,7 +3239,7 @@ const render = now => {
   }
 
   computeRenderVisibility()
-  tick(delta)
+  tick(delta, now)
   const hasVisibleNodeOnScreen = state.renderNodes.some((node) => isNodeVisibleOnScreen(node, width, height))
   const manualZoomGuardActive = now - state.lastManualZoomAt < zoomRecoveryGuardMs
   const allowViewportAutoRecovery = state.nodes.length <= massiveGraphNodeThreshold

package/package.json

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