@andespindola/brainlink 0.1.0-beta.51 → 0.1.0-beta.53

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

@@ -17,7 +17,7 @@ const worldCoordinateLimit = 5_000_000
 const transformCoordinateLimit = 20_000_000
 const hoverHitTestIntervalMs = 64
 const overviewClusterMaxCount = 1400
-const zoomRecoveryGuardMs = 560
+const zoomRecoveryGuardMs = 1500
 const state = {
   graph: { nodes: [], edges: [] },
   nodes: [],
@@ -52,6 +52,7 @@ const state = {
   overviewClusters: [],
   macroCenter: { x: 0, y: 0 },
   macroRepresentative: null,
+  primaryHub: null,
   filterWorker: null,
   filterReady: false,
   lastHoverHitAt: 0,
@@ -296,6 +297,7 @@ const recomputeVisibility = () => {
     }
     : { x: 0, y: 0 }
   state.macroRepresentative = resolveMacroRepresentative(nodes)
+  state.primaryHub = rankedHubNodes()[0] ?? null
   markRenderDirty()
 }
 
@@ -601,6 +603,27 @@ const enrichSampleWithNeighbors = (nodes) => {
   }
 }
 
+const ensureHubNodesInRenderedSet = (nodes) => {
+  if (nodes.length === 0) {
+    return nodes
+  }
+
+  const maxNodes = Math.max(renderNodeBudget, nodes.length)
+  const ids = new Set(nodes.map((node) => node.id))
+  const hubs = rankedHubNodes()
+  const merged = [...nodes]
+
+  for (let index = 0; index < hubs.length && merged.length < maxNodes; index += 1) {
+    const hub = hubs[index]
+    if (!ids.has(hub.id)) {
+      merged.push(hub)
+      ids.add(hub.id)
+    }
+  }
+
+  return merged
+}
+
 const clampScale = value => Math.max(zoomRange.min, Math.min(zoomRange.max, value))
 const isFiniteNumber = value => Number.isFinite(value)
 const isReasonableCoordinate = value => isFiniteNumber(value) && Math.abs(value) <= worldCoordinateLimit
@@ -658,7 +681,7 @@ const autoFitScaleRangeByNodeCount = nodeCount => {
   return { min: 0.0008, max: 0.24 }
 }
 
-const fitView = (options = { useFiltered: true, macro: false }) => {
+const fitView = (options = { useFiltered: true, macro: false, preferHubCenter: true }) => {
   const rect = canvas.getBoundingClientRect()
   const width = Math.max(rect.width, 320)
   const height = Math.max(rect.height, 320)
@@ -695,8 +718,12 @@ const fitView = (options = { useFiltered: true, macro: false }) => {
     : nodes.length > massiveGraphNodeThreshold
       ? clampScale(Math.min(baselineScale, massiveAutoFitMacroScale))
       : baselineScale
-  const centerX = (bounds.minX + bounds.maxX) / 2
-  const centerY = (bounds.minY + bounds.maxY) / 2
+  const hubCenter =
+    options.preferHubCenter && state.primaryHub && nodes.some((node) => node.id === state.primaryHub.id)
+      ? state.primaryHub
+      : null
+  const centerX = hubCenter ? hubCenter.x : (bounds.minX + bounds.maxX) / 2
+  const centerY = hubCenter ? hubCenter.y : (bounds.minY + bounds.maxY) / 2
 
   state.transform = {
     x: clampTransformCoordinate(width / 2 - centerX * scale),
@@ -708,7 +735,7 @@ const fitView = (options = { useFiltered: true, macro: false }) => {
   markRenderDirty()
 }
 
-const resetView = () => fitView({ useFiltered: false, macro: true })
+const resetView = () => fitView({ useFiltered: false, macro: true, preferHubCenter: true })
 
 const createLayout = graph => {
   const nodeRows = Array.isArray(graph.nodes) ? graph.nodes : []
@@ -1100,12 +1127,13 @@ const computeRenderVisibility = () => {
       : sourceNodes.slice(0, Math.min(sourceNodes.length, renderNodeBudget))
     const sampledIds = new Set(sampled.map((node) => node.id))
     let sampledEdges = state.transform.scale >= 0.035 ? collectVisibleEdgesForNodes(sampledIds) : []
-    let sampledNodes = sampled
+    let sampledNodes = ensureHubNodesInRenderedSet(sampled)
 
     if (state.transform.scale >= 0.035 && sampledEdges.length === 0) {
-      const enriched = enrichSampleWithNeighbors(sampled)
-      sampledNodes = enriched.nodes
-      sampledEdges = enriched.edges
+      const enriched = enrichSampleWithNeighbors(sampledNodes)
+      sampledNodes = ensureHubNodesInRenderedSet(enriched.nodes)
+      const sampledWithHubsIds = new Set(sampledNodes.map((node) => node.id))
+      sampledEdges = collectVisibleEdgesForNodes(sampledWithHubsIds)
     }
 
     state.renderClusters = []
@@ -1159,10 +1187,11 @@ const computeRenderVisibility = () => {
     return
   }
 
-  const nodeIds = new Set(nodes.map((node) => node.id))
+  const normalizedNodes = ensureHubNodesInRenderedSet(nodes)
+  const nodeIds = new Set(normalizedNodes.map((node) => node.id))
   const edges = collectVisibleEdgesForNodes(nodeIds)
 
-  state.renderNodes = nodes
+  state.renderNodes = normalizedNodes
   state.renderEdges = edges
 
   if (state.renderNodes.length === 0 && state.visibleNodes.length > 0) {
@@ -1456,17 +1485,19 @@ const selectNodeById = id => {
 }
 
 const zoomAtPoint = (screenX, screenY, factor, source = 'generic') => {
+  if (source === 'wheel') {
+    state.lastManualZoomAt = performance.now()
+  }
   const nextScale = clampScale(state.transform.scale * factor)
-  if (nextScale === state.transform.scale) return
+  if (nextScale === state.transform.scale) {
+    return
+  }
   const worldX = (screenX - state.transform.x) / state.transform.scale
   const worldY = (screenY - state.transform.y) / state.transform.scale
   state.transform.scale = clampScale(nextScale)
   state.transform.x = clampTransformCoordinate(screenX - worldX * nextScale)
   state.transform.y = clampTransformCoordinate(screenY - worldY * nextScale)
   state.offscreenFrameCount = 0
-  if (source === 'wheel') {
-    state.lastManualZoomAt = performance.now()
-  }
   markRenderDirty()
 }
 

package/dist/domain/graph-layout.js

@@ -20,6 +20,7 @@ const segmentAngles = {
     Evaluation: 2.08,
     Security: 2.82
 };
+const hubTitlePattern = /\b(memory\s*hub|knowledge\s*root|moc|map)\b/i;
 const hashText = (value) => Array.from(value).reduce((hash, char) => ((hash << 5) - hash + char.charCodeAt(0)) | 0, 0);
 const jitter = (value, range) => {
     const normalized = Math.abs(hashText(value) % 1000) / 1000;
@@ -62,6 +63,44 @@ const byDegreeThenTitle = (degrees) => (left, right) => {
     const degreeDelta = (degrees.get(right.id) ?? 0) - (degrees.get(left.id) ?? 0);
     return degreeDelta === 0 ? byTitle(left, right) : degreeDelta;
 };
+const hubScore = (node) => {
+    const title = node.title.trim().toLowerCase();
+    if (title === 'memory hub')
+        return 5;
+    if (title === 'knowledge root')
+        return 4;
+    if (/\bmoc\b/i.test(node.title))
+        return 3;
+    return hubTitlePattern.test(node.title) ? 2 : 0;
+};
+const selectPrimaryHubId = (nodes, degrees) => {
+    const ranked = [...nodes]
+        .filter((node) => hubScore(node) > 0)
+        .sort((left, right) => {
+        const scoreDelta = hubScore(right) - hubScore(left);
+        if (scoreDelta !== 0)
+            return scoreDelta;
+        const degreeDelta = (degrees.get(right.id) ?? 0) - (degrees.get(left.id) ?? 0);
+        if (degreeDelta !== 0)
+            return degreeDelta;
+        return left.title.localeCompare(right.title);
+    });
+    return ranked[0]?.id ?? null;
+};
+const centerLayoutByNode = (nodes, nodeId) => {
+    if (!nodeId) {
+        return nodes;
+    }
+    const anchor = nodes.find((node) => node.id === nodeId);
+    if (!anchor) {
+        return nodes;
+    }
+    return nodes.map((node) => ({
+        ...node,
+        x: node.x - anchor.x,
+        y: node.y - anchor.y
+    }));
+};
 const naturalSegmentSeed = (node) => groupKey(node) === '00-maps' || /\b(moc|map)\b/i.test(node.title);
 const segmentName = (node) => node.title.replace(/^MOC\s+/i, '').replace(/\s+Memory Map$/i, '').trim() || node.title;
 const collectComponent = (adjacency, startId, visited) => {
@@ -246,8 +285,10 @@ export const createCauliflowerGraphLayout = (graph) => {
     const segmentGroups = Array.from(groupNodesBySegment(graph.nodes, segments).entries())
         .sort(([left], [right]) => left.localeCompare(right));
     const nodes = relaxCollisions(segmentGroups.flatMap(createSegmentNodes(segments, degrees, segmentGroups.length)));
+    const primaryHubId = selectPrimaryHubId(graph.nodes, degrees);
+    const centeredNodes = centerLayoutByNode(nodes, primaryHubId);
     return {
-        nodes,
+        nodes: centeredNodes,
         edges: graph.edges
     };
 };

package/package.json

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