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

package/README.md

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

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

@@ -2213,7 +2213,19 @@ const currentZoomMax = () => {
   return Math.max(zoomRange.min * 2, capped)
 }
 
-const clampScale = value => Math.max(zoomRange.min, Math.min(currentZoomMax(), value))
+const zoomFloorByNodeCount = (nodeCount) => {
+  if (nodeCount > massiveGraphNodeThreshold) return 0.0028
+  if (nodeCount > largeGraphNodeThreshold) return 0.0014
+  if (nodeCount > ecosystemActivationNodeThreshold) return 0.0006
+  return zoomRange.min
+}
+
+const currentZoomMin = () => {
+  const nodeCount = state.visibleNodes.length > 0 ? state.visibleNodes.length : state.nodes.length
+  return Math.max(zoomRange.min, zoomFloorByNodeCount(nodeCount))
+}
+
+const clampScale = value => Math.max(currentZoomMin(), Math.min(currentZoomMax(), value))
 const isFiniteNumber = value => Number.isFinite(value)
 const isReasonableCoordinate = value => isFiniteNumber(value) && Math.abs(value) <= worldCoordinateLimit
 const clampTransformCoordinate = value => {
@@ -2270,6 +2282,56 @@ const autoFitScaleRangeByNodeCount = nodeCount => {
   return { min: 0.0012, max: 0.24 }
 }
 
+const macroFaceToFaceScale = (nodeCount, hubDistance) => {
+  if (!Number.isFinite(hubDistance) || hubDistance <= 0 || nodeCount <= ecosystemActivationNodeThreshold) {
+    return 0
+  }
+
+  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)
+  return targetPx / hubDistance
+}
+
+const nearestClusterNeighborDistance = (clusters) => {
+  if (!Array.isArray(clusters) || clusters.length < 2) {
+    return Number.POSITIVE_INFINITY
+  }
+
+  let nearestDistance = Number.POSITIVE_INFINITY
+  for (let index = 0; index < clusters.length; index += 1) {
+    const source = clusters[index]
+    for (let neighborIndex = index + 1; neighborIndex < clusters.length; neighborIndex += 1) {
+      const target = clusters[neighborIndex]
+      const distance = Math.hypot(source.x - target.x, source.y - target.y)
+      if (distance > 0 && distance < nearestDistance) {
+        nearestDistance = distance
+      }
+    }
+  }
+
+  return nearestDistance
+}
+
+const macroEcosystemFaceScale = (nodeCount) => {
+  if (nodeCount <= ecosystemActivationNodeThreshold) {
+    return 0
+  }
+
+  const baseClusters = state.ecosystemClustersBySize.get(state.ecosystemBaseSize) ?? state.ecosystemClusters
+  const siblingClusters = baseClusters.filter(cluster => !cluster.isHub)
+  const nearestDistance = nearestClusterNeighborDistance(siblingClusters)
+  if (!Number.isFinite(nearestDistance) || nearestDistance <= 0) {
+    return 0
+  }
+
+  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)
+  return targetPx / nearestDistance
+}
 const fitView = (options = { useFiltered: true, macro: false, preferHubCenter: true }) => {
   const rect = canvas.getBoundingClientRect()
   const width = Math.max(rect.width, 320)
@@ -2307,6 +2369,15 @@ const fitView = (options = { useFiltered: true, macro: false, preferHubCenter: t
     : nodes.length > massiveGraphNodeThreshold
       ? clampScale(Math.min(baselineScale, massiveAutoFitMacroScale))
       : baselineScale
+  const macroFloorScale = options.macro
+    ? clampScale(Math.max(
+      macroFaceToFaceScale(nodes.length, state.hubNeighborDistance),
+      macroEcosystemFaceScale(nodes.length)
+    ))
+    : 0
+  const resolvedScale = options.macro
+    ? clampScale(Math.max(scale, macroFloorScale))
+    : scale
   const hubCenter =
     options.preferHubCenter && isDominantHub(state.primaryHub, nodes.length) && nodes.some((node) => node.id === state.primaryHub.id)
       ? state.primaryHub
@@ -2315,9 +2386,9 @@ const fitView = (options = { useFiltered: true, macro: false, preferHubCenter: t
   const centerY = hubCenter ? hubCenter.y : (bounds.minY + bounds.maxY) / 2
 
   state.transform = {
-    x: clampTransformCoordinate(width / 2 - centerX * scale),
-    y: clampTransformCoordinate(height / 2 - centerY * scale),
-    scale: clampScale(scale)
+    x: clampTransformCoordinate(width / 2 - centerX * resolvedScale),
+    y: clampTransformCoordinate(height / 2 - centerY * resolvedScale),
+    scale: clampScale(resolvedScale)
   }
   state.offscreenFrameCount = 0
   state.recoveringViewport = false

package/package.json

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