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

package/README.md

@@ -595,11 +595,12 @@ The graph UI shows:
 - realtime refresh while `--watch` is enabled
 - graph controls for zoom in, zoom out, fit visible nodes and reset-to-fit-all
 - wheel zoom (including `cmd+scroll` and `ctrl+scroll`) anchored to cursor position for faster navigation in large graphs
-- zoom-out floor for large and massive graphs, plus reset macro floor tied to hub-neighbor distance and first-level cluster spacing, so initial macro view stays closer to first particle layers instead of over-distancing
+- zoom-out floor for large and massive graphs, plus reset macro floor tied to hub-neighbor distance and first-level cluster spacing, with a tighter initial camera so the first graph appears as a closer cell instead of a distant mesh
 - keyboard shortcuts: `+` zoom in, `-` zoom out, `0` reset fit
 - 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()
 }
@@ -2214,9 +2222,9 @@ const currentZoomMax = () => {
 }
 
 const zoomFloorByNodeCount = (nodeCount) => {
-  if (nodeCount > massiveGraphNodeThreshold) return 0.0028
-  if (nodeCount > largeGraphNodeThreshold) return 0.0014
-  if (nodeCount > ecosystemActivationNodeThreshold) return 0.0006
+  if (nodeCount > massiveGraphNodeThreshold) return 0.0042
+  if (nodeCount > largeGraphNodeThreshold) return 0.0021
+  if (nodeCount > ecosystemActivationNodeThreshold) return 0.001
   return zoomRange.min
 }
 
@@ -2289,8 +2297,8 @@ const macroFaceToFaceScale = (nodeCount, hubDistance) => {
 
   const rect = canvas.getBoundingClientRect()
   const viewportReference = Math.max(320, Math.min(rect.width, rect.height))
-  const share = nodeCount > massiveGraphNodeThreshold ? 0.052 : 0.046
-  const targetPx = Math.max(18, viewportReference * share)
+  const share = nodeCount > massiveGraphNodeThreshold ? 0.082 : 0.068
+  const targetPx = Math.max(24, viewportReference * share)
   return targetPx / hubDistance
 }
 
@@ -2328,8 +2336,8 @@ const macroEcosystemFaceScale = (nodeCount) => {
 
   const rect = canvas.getBoundingClientRect()
   const viewportReference = Math.max(320, Math.min(rect.width, rect.height))
-  const targetShare = nodeCount > massiveGraphNodeThreshold ? 0.068 : 0.058
-  const targetPx = Math.max(22, viewportReference * targetShare)
+  const targetShare = nodeCount > massiveGraphNodeThreshold ? 0.114 : 0.096
+  const targetPx = Math.max(30, viewportReference * targetShare)
   return targetPx / nearestDistance
 }
 const fitView = (options = { useFiltered: true, macro: false, preferHubCenter: true }) => {
@@ -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.102",
+  "version": "0.1.0-beta.104",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",