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

package/README.md

@@ -600,6 +600,7 @@ 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

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()
 }
@@ -2565,7 +2573,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 +2581,24 @@ const tick = delta => {
     nodes.length <= 320 &&
     state.transform.scale >= 0.08
   if (!shouldRunPhysics) {
+    state.physicsRestFrames = 0
     return
   }
-  const strength = Math.min(delta / 16, 2)
+  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
+  }
+  state.lastPhysicsAt = now
+  const strength = Math.min(Math.max(elapsedSincePhysics, delta, 16) / 16, physicsStepDeltaCapMs / 16)
 
   edges.forEach(edge => {
     const source = edge.sourceNode
@@ -2617,6 +2640,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 +2657,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 +2822,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)
@@ -3136,10 +3168,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 +3184,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 +3201,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.104",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",