@andespindola/brainlink 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.5.0
+
+- **Graph shows every node at any zoom.** The viewport stream previously replaced nodes with per-context clusters below a zoom threshold, so nodes vanished when you zoomed out and reappeared on approach. Graphs that fit a cap (6000 nodes) now render every node in near mode at all zoom levels; larger graphs keep the far/mid/near level-of-detail.
+- **Graph visual refresh.** Bigger nodes with a screen-space radius floor so they stay visible dots at any zoom, brighter and more legible edges, and labels decluttered by collision (placed by importance, skipping overlaps) so density scales smoothly with zoom instead of flipping on at a hard threshold. Labels reposition live during interaction (no flicker) and are throttled to keep pan/zoom fluid.
+- **Crowquill Mono UI font.** The graph UI now ships and uses Crowquill Mono, inlined as base64 woff2 in the served CSS so it is self-contained (graceful monospace fallback if unavailable). The header metrics were made compact so the Notes/Links counters no longer wrap.
+- **New logo and npm image fix.** The README logo is now a brain drawn as a knowledge graph, exported to PNG and referenced by absolute URL so it renders on the npm package page (npm does not render SVG). Copyright holder set to Anderson Espindola.
+
 ## 1.4.0
 
 - **Shared namespace by default.** `defaultAgent` now defaults to `shared`, so every agent (Claude, Codex, GPT, …) reads and writes the same namespace and sees each other's memory unless a call passes an explicit `--agent`/`agent`. Set `defaultAgent` to another id, or pass `--agent` per call, to scope to a private namespace.

package/COPYRIGHT.md

@@ -1,4 +1,4 @@
-Copyright (c) 2026 Substructa
+Copyright (c) 2026 Anderson Espindola
 
 This project is licensed under the MIT License.
 

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="./assets/brainlink-logo.svg" alt="Brainlink" width="720">
+  <img src="https://raw.githubusercontent.com/andersonflima/brainlink/main/assets/brainlink-logo.png" alt="Brainlink" width="720">
 </p>
 
 # Brainlink
@@ -1456,7 +1456,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md).
 ## License
 
 MIT. See [LICENSE](LICENSE).
-Copyright (c) 2026 Substructa. See [COPYRIGHT.md](COPYRIGHT.md).
+Copyright (c) 2026 Anderson Espindola. See [COPYRIGHT.md](COPYRIGHT.md).
 
 ### Memory Optimization Loop (1-7)
 

package/assets/brainlink-logo.svg

@@ -1,25 +1,100 @@
-<svg width="900" height="220" viewBox="0 0 900 220" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
+<svg width="1240" height="440" viewBox="0 0 1240 440" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
   <title id="title">Brainlink</title>
-  <desc id="desc">Brainlink logo with a linked memory graph mark and wordmark.</desc>
-  <rect width="900" height="220" fill="transparent"/>
-  <g transform="translate(42 24)">
-    <rect x="6" y="6" width="160" height="160" rx="36" fill="#F8FAFC"/>
-    <rect x="6" y="6" width="160" height="160" rx="36" stroke="#111827" stroke-width="8"/>
-    <path d="M47 84C47 65.225 62.225 50 81 50H92C110.775 50 126 65.225 126 84C126 102.775 110.775 118 92 118H81C62.225 118 47 102.775 47 84Z" stroke="#111827" stroke-width="12" stroke-linecap="round"/>
-    <path d="M67 84C67 76.268 73.268 70 81 70H92C99.732 70 106 76.268 106 84C106 91.732 99.732 98 92 98H81C73.268 98 67 91.732 67 84Z" fill="#FFFFFF"/>
-    <path d="M54 132L43 121L54 110" stroke="#2563EB" stroke-width="10" stroke-linecap="round" stroke-linejoin="round"/>
-    <path d="M118 110L129 121L118 132" stroke="#2563EB" stroke-width="10" stroke-linecap="round" stroke-linejoin="round"/>
-    <circle cx="55" cy="43" r="12" fill="#14B8A6"/>
-    <circle cx="121" cy="43" r="12" fill="#2563EB"/>
-    <circle cx="86" cy="136" r="12" fill="#111827"/>
-    <path d="M66.5 47.5L109.5 47.5" stroke="#94A3B8" stroke-width="7" stroke-linecap="round"/>
-    <path d="M62 54L79 125" stroke="#94A3B8" stroke-width="7" stroke-linecap="round"/>
-    <path d="M115 54L92 125" stroke="#94A3B8" stroke-width="7" stroke-linecap="round"/>
+  <desc id="desc">Brainlink logo: a brain drawn as a knowledge graph of connected memory nodes, for AI agents.</desc>
+  <defs>
+    <radialGradient id="bg" cx="26%" cy="30%" r="95%">
+      <stop offset="0%" stop-color="#0e2233"/>
+      <stop offset="55%" stop-color="#0a1926"/>
+      <stop offset="100%" stop-color="#06111b"/>
+    </radialGradient>
+    <linearGradient id="brainStroke" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#5aa8ff"/>
+      <stop offset="100%" stop-color="#59d0dd"/>
+    </linearGradient>
+    <linearGradient id="wordmark" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#eef5ff"/>
+      <stop offset="100%" stop-color="#bcd4f2"/>
+    </linearGradient>
+    <filter id="glow" x="-60%" y="-60%" width="220%" height="220%">
+      <feGaussianBlur stdDeviation="5" result="b"/>
+      <feMerge>
+        <feMergeNode in="b"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <rect width="1240" height="440" rx="34" fill="url(#bg)"/>
+
+  <!-- Brain drawn as a graph -->
+  <g transform="translate(70 26)" filter="url(#glow)">
+    <!-- brain silhouette -->
+    <path d="M270,58 C232,40 190,50 168,84 C138,74 110,96 116,130 C88,140 82,180 108,200
+             C86,214 92,256 122,266 C120,306 158,336 202,326 C224,352 286,352 312,326
+             C356,340 398,312 392,270 C420,258 424,214 398,196 C420,180 416,138 386,132
+             C392,98 360,72 322,84 C308,64 288,58 270,58 Z"
+          fill="#5aa8ff" fill-opacity="0.05" stroke="url(#brainStroke)" stroke-width="3" stroke-opacity="0.65"/>
+    <!-- central sulcus + a few gyri -->
+    <path d="M268,72 C246,120 300,150 270,196 C242,240 300,272 272,318"
+          fill="none" stroke="#5aa8ff" stroke-width="2.2" stroke-opacity="0.32"/>
+    <path d="M150,110 C176,128 176,156 150,176" fill="none" stroke="#5aa8ff" stroke-width="2" stroke-opacity="0.2"/>
+    <path d="M360,120 C334,140 336,168 362,186" fill="none" stroke="#5aa8ff" stroke-width="2" stroke-opacity="0.2"/>
+    <path d="M196,250 C222,262 250,258 268,240" fill="none" stroke="#5aa8ff" stroke-width="2" stroke-opacity="0.2"/>
+
+    <!-- graph edges -->
+    <g stroke="#7fb2e6" stroke-width="2" stroke-opacity="0.42" stroke-linecap="round">
+      <line x1="150" y1="120" x2="210" y2="96"/>
+      <line x1="210" y1="96" x2="250" y2="150"/>
+      <line x1="150" y1="120" x2="190" y2="170"/>
+      <line x1="190" y1="170" x2="250" y2="150"/>
+      <line x1="190" y1="170" x2="140" y2="200"/>
+      <line x1="140" y1="200" x2="172" y2="248"/>
+      <line x1="172" y1="248" x2="225" y2="228"/>
+      <line x1="225" y1="228" x2="250" y2="150"/>
+      <line x1="172" y1="248" x2="208" y2="298"/>
+      <line x1="208" y1="298" x2="266" y2="262"/>
+      <line x1="266" y1="262" x2="225" y2="228"/>
+      <line x1="250" y1="150" x2="270" y2="205"/>
+      <line x1="270" y1="205" x2="315" y2="200"/>
+      <line x1="300" y1="112" x2="340" y2="152"/>
+      <line x1="300" y1="112" x2="250" y2="150"/>
+      <line x1="340" y1="152" x2="315" y2="200"/>
+      <line x1="315" y1="200" x2="362" y2="236"/>
+      <line x1="362" y1="236" x2="345" y2="292"/>
+      <line x1="345" y1="292" x2="300" y2="300"/>
+      <line x1="300" y1="300" x2="266" y2="262"/>
+      <line x1="300" y1="300" x2="208" y2="298"/>
+      <line x1="270" y1="205" x2="300" y2="300"/>
+      <line x1="270" y1="205" x2="266" y2="262"/>
+    </g>
+
+    <!-- graph nodes -->
+    <g>
+      <circle cx="270" cy="205" r="12" fill="#5aa8ff"/>
+      <circle cx="210" cy="96" r="8" fill="#59d0dd"/>
+      <circle cx="150" cy="120" r="7" fill="#5aa8ff"/>
+      <circle cx="250" cy="150" r="10" fill="#7cb6ff"/>
+      <circle cx="190" cy="170" r="7" fill="#5ecf92"/>
+      <circle cx="140" cy="200" r="7" fill="#5aa8ff"/>
+      <circle cx="172" cy="248" r="8" fill="#a88fff"/>
+      <circle cx="225" cy="228" r="9" fill="#5aa8ff"/>
+      <circle cx="208" cy="298" r="7" fill="#ffb65c"/>
+      <circle cx="266" cy="262" r="8" fill="#59d0dd"/>
+      <circle cx="300" cy="112" r="8" fill="#ff7dac"/>
+      <circle cx="340" cy="152" r="7" fill="#5aa8ff"/>
+      <circle cx="315" cy="200" r="10" fill="#5ecf92"/>
+      <circle cx="362" cy="236" r="7" fill="#7cb6ff"/>
+      <circle cx="345" cy="292" r="8" fill="#5aa8ff"/>
+      <circle cx="300" cy="300" r="9" fill="#ff8f6a"/>
+    </g>
   </g>
-  <g transform="translate(244 68)">
-    <text x="0" y="62" fill="#111827" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="72" font-weight="760">Brainlink</text>
-    <text x="4" y="102" fill="#475569" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="24" font-weight="500">Local-first memory for AI agents</text>
-    <path d="M0 124H268" stroke="#14B8A6" stroke-width="8" stroke-linecap="round"/>
-    <path d="M292 124H392" stroke="#2563EB" stroke-width="8" stroke-linecap="round"/>
+
+  <!-- wordmark -->
+  <g transform="translate(560 0)" font-family="Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <text x="0" y="212" fill="url(#wordmark)" font-size="118" font-weight="780" letter-spacing="-3">Brainlink</text>
+    <text x="4" y="262" fill="#7f9ad0" font-size="30" font-weight="500">Canonical memory graph for AI agents</text>
+    <line x1="6" y1="292" x2="150" y2="292" stroke="#5aa8ff" stroke-width="6" stroke-linecap="round"/>
+    <line x1="166" y1="292" x2="238" y2="292" stroke="#59d0dd" stroke-width="6" stroke-linecap="round"/>
+    <line x1="254" y1="292" x2="298" y2="292" stroke="#5ecf92" stroke-width="6" stroke-linecap="round"/>
   </g>
 </svg>

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

@@ -23,8 +23,8 @@ const drawFallback = () => {
     nodeById.set(nodes[i][0], nodes[i])
   }
 
-  ctx2dFallback.strokeStyle = 'rgba(151,181,212,0.18)'
-  ctx2dFallback.lineWidth = 1
+  ctx2dFallback.strokeStyle = 'rgba(158,188,220,0.32)'
+  ctx2dFallback.lineWidth = 1.2
   for (let i = 0; i < edges.length; i += 1) {
     const edge = edges[i]
     const source = nodeById.get(edge[0])
@@ -43,7 +43,7 @@ const drawFallback = () => {
     const p = worldToScreen(node[2], node[3])
     const selected = state.selectedNodeId === node[0]
     const color = segmentColor(node[5] || node[4] || node[1])
-    const radius = Math.max(3.2, Math.min(16.5, 5 + node[7] * 0.65))
+    const radius = Math.max(3.8, Math.min(18, 5.5 + node[7] * 0.7))
 
     ctx2dFallback.beginPath()
     ctx2dFallback.fillStyle = selected ? '#edf4ff' : color
@@ -179,25 +179,57 @@ const hideTooltip = () => {
 
 const labelCandidates = () => {
   const nodes = normalizeList(state.chunk.nodes)
-  const visible = nodes.filter((node) => {
+  const focused = state.focusedNodeIds
+  const isPinned = (node) => focused.has(node[0]) || node[0] === state.hoveredNodeId || node[0] === state.selectedNodeId
+  const margin = 80
+
+  // Collect on-screen nodes with their screen position, ranked by importance
+  // (pinned first, then relevance, deterministic id tie-break).
+  const scored = []
+  for (let i = 0; i < nodes.length; i += 1) {
+    const node = nodes[i]
     const x = Number(node?.[2])
     const y = Number(node?.[3])
-    if (!Number.isFinite(x) || !Number.isFinite(y)) return false
+    if (!Number.isFinite(x) || !Number.isFinite(y)) continue
     const point = worldToScreen(x, y)
-    return point.x >= -80 && point.x <= state.viewport.width + 80 && point.y >= -80 && point.y <= state.viewport.height + 80
+    if (point.x < -margin || point.x > state.viewport.width + margin || point.y < -margin || point.y > state.viewport.height + margin) continue
+    scored.push({ node, x: point.x, y: point.y, pinned: isPinned(node), relevance: Number(node?.[7] ?? 0) })
+  }
+  scored.sort((left, right) => {
+    const focusDelta = (right.pinned ? 1 : 0) - (left.pinned ? 1 : 0)
+    if (focusDelta !== 0) return focusDelta
+    const relevanceDelta = right.relevance - left.relevance
+    if (relevanceDelta !== 0) return relevanceDelta
+    return String(left.node[0]).localeCompare(String(right.node[0]))
   })
-  const shouldShowMany = state.camera.scale >= 0.72 || visible.length <= 120
-  const focused = state.focusedNodeIds
 
-  return visible
-    .filter((node) => shouldShowMany || focused.has(node[0]) || node[0] === state.hoveredNodeId || node[0] === state.selectedNodeId || Number(node?.[7]) > 5.5)
-    .sort((left, right) => {
-      const leftFocused = focused.has(left[0]) || left[0] === state.hoveredNodeId || left[0] === state.selectedNodeId ? 1 : 0
-      const rightFocused = focused.has(right[0]) || right[0] === state.hoveredNodeId || right[0] === state.selectedNodeId ? 1 : 0
-      if (rightFocused !== leftFocused) return rightFocused - leftFocused
-      return Number(right?.[7] ?? 0) - Number(left?.[7] ?? 0)
-    })
-    .slice(0, state.camera.scale >= 0.72 ? 160 : 48)
+  // Greedy overlap-free placement: a label is shown only if its box does not
+  // collide with an already-placed one, so density scales smoothly with zoom
+  // (few when nodes are packed, more as they spread out) instead of flipping on
+  // at a hard zoom threshold. Pinned labels are always kept.
+  const gap = 4
+  const height = 22
+  const maxLabels = state.camera.scale >= 0.72 ? 220 : 120
+  const placed = []
+  const result = []
+  for (let i = 0; i < scored.length && result.length < maxLabels; i += 1) {
+    const item = scored[i]
+    const title = String(item.node[1] || item.node[0])
+    const width = Math.min(220, 18 + title.length * 6.6)
+    const box = { left: item.x - width / 2, right: item.x + width / 2, bottom: item.y - 6, top: item.y - 6 - height }
+    let overlaps = false
+    for (let j = 0; j < placed.length; j += 1) {
+      const other = placed[j]
+      if (box.left < other.right + gap && box.right > other.left - gap && box.top < other.bottom + gap && box.bottom > other.top - gap) {
+        overlaps = true
+        break
+      }
+    }
+    if (overlaps && !item.pinned) continue
+    placed.push(box)
+    result.push(item.node)
+  }
+  return result
 }
 
 const drawLabels = () => {
@@ -268,6 +300,12 @@ const drawMiniMap = () => {
 
 const shouldDeferGraphOverlays = () => state.pointer.down || performance.now() - state.lastWheelAt < 150
 
+// Rebuilding the label overlay is the main per-frame cost. During interaction we
+// cap it to ~25fps (the canvas keeps 60fps in the worker), which halves the DOM
+// churn while labels still track the nodes. A trailing timer guarantees a final
+// pass so labels settle in the right place when interaction stops.
+const graphOverlayInteractionThrottleMs = 40
+
 const updateGraphOverlays = () => {
   if (state.overlayScheduled) {
     return
@@ -275,19 +313,25 @@ const updateGraphOverlays = () => {
   state.overlayScheduled = true
   requestAnimationFrame(() => {
     state.overlayScheduled = false
-    if (shouldDeferGraphOverlays()) {
-      elements.labels?.classList.add('is-stale')
+    const interacting = shouldDeferGraphOverlays()
+
+    if (interacting && performance.now() - (state.lastOverlayDrawAt || 0) < graphOverlayInteractionThrottleMs) {
       if (!state.overlayIdleTimer) {
         state.overlayIdleTimer = setTimeout(() => {
           state.overlayIdleTimer = null
           updateGraphOverlays()
-        }, 170)
+        }, graphOverlayInteractionThrottleMs)
       }
       return
     }
+
     elements.labels?.classList.remove('is-stale')
     drawLabels()
-    if (state.miniMapDirty) {
+    state.lastOverlayDrawAt = performance.now()
+
+    // The minimap is heavier and irrelevant mid-gesture, so only refresh it once
+    // the camera settles.
+    if (!interacting && state.miniMapDirty) {
       drawMiniMap()
       state.miniMapDirty = false
     }

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

@@ -63,8 +63,8 @@ const graphTheme = {
     parseColor('#c9945f'),
     parseColor('#7cb6ff')
   ],
-  edge: [0.59, 0.71, 0.83, 0.14],
-  edgeHeavy: [0.59, 0.71, 0.83, 0.3],
+  edge: [0.62, 0.74, 0.86, 0.24],
+  edgeHeavy: [0.66, 0.78, 0.9, 0.46],
   clear: parseColor('#08131d')
 }
 

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

@@ -1,4 +1,29 @@
-export const createClientCss = () => `:root {
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+// Crowquill Mono ships with the package under assets/fonts. Inline each face as a
+// base64 woff2 data URI so the served CSS is self-contained (no extra route, no
+// path resolution) and works identically for a global npm install. A missing
+// file degrades gracefully to the monospace fallback stack.
+const embedFontFace = (weight, style, file) => {
+    try {
+        const path = fileURLToPath(new URL(`../../../assets/fonts/${file}`, import.meta.url));
+        const base64 = readFileSync(path).toString('base64');
+        return `@font-face{font-family:"Crowquill Mono";font-style:${style};font-weight:${weight};font-display:swap;src:url("data:font/woff2;base64,${base64}") format("woff2")}`;
+    }
+    catch {
+        return '';
+    }
+};
+const crowquillFontFaces = () => [
+    embedFontFace(400, 'normal', 'CrowquillMono-Regular.woff2'),
+    embedFontFace(700, 'normal', 'CrowquillMono-Bold.woff2'),
+    embedFontFace(400, 'italic', 'CrowquillMono-Italic.woff2'),
+    embedFontFace(700, 'italic', 'CrowquillMono-BoldItalic.woff2')
+]
+    .filter(Boolean)
+    .join('\n');
+export const createClientCss = () => `${crowquillFontFaces()}
+:root {
   color-scheme: dark;
   --bg: #071019;
   --panel: #0d1823;
@@ -22,7 +47,7 @@ body {
   margin: 0;
   background: var(--bg);
   color: var(--text);
-  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  font-family: "Crowquill Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
 }
 
 body {
@@ -256,28 +281,30 @@ select {
 
 .floating-metrics {
   display: flex;
-  gap: 10px;
-  flex-wrap: wrap;
+  gap: 8px;
+  flex-wrap: nowrap;
+  flex: 0 0 auto;
 }
 
 .metric-chip {
-  min-width: 94px;
-  padding: 10px 12px;
+  padding: 6px 10px;
   border: 1px solid var(--line);
-  border-radius: 10px;
+  border-radius: 9px;
   background: rgba(12, 24, 36, 0.94);
-  display: grid;
-  gap: 3px;
+  display: flex;
+  align-items: baseline;
+  gap: 6px;
+  white-space: nowrap;
 }
 
 .metric-chip strong {
-  font-size: 26px;
+  font-size: 15px;
   line-height: 1;
 }
 
 .metric-chip small {
   color: var(--muted);
-  font-size: 11px;
+  font-size: 10px;
   letter-spacing: 0.03em;
   text-transform: uppercase;
 }
@@ -344,7 +371,7 @@ li small {
   color: var(--text);
   white-space: pre-wrap;
   overflow: auto;
-  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
+  font-family: "Crowquill Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
   font-size: 12px;
   line-height: 1.5;
 }
@@ -742,7 +769,7 @@ li small {
   }
 
   .metric-chip {
-    min-width: 82px;
+    min-width: 0;
   }
 
   .content-meta {

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

@@ -124,7 +124,7 @@ export const createClientHtml = () => `<!doctype html>
       </section>
     </main>
     <footer class="app-footer" aria-label="Copyright notice">
-      <small>Copyright © 2026 Substructa</small>
+      <small>Copyright © 2026 Anderson Espindola</small>
     </footer>
     <script src="/app.js"></script>
   </body>

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

@@ -56,8 +56,8 @@ const defaultTheme = {
     [0.72, 0.51, 0.33, 1],
     [0.44, 0.62, 0.85, 1]
   ],
-  edge: [0.23, 0.31, 0.42, 0.18],
-  edgeHeavy: [0.23, 0.31, 0.42, 0.34],
+  edge: [0.36, 0.46, 0.60, 0.26],
+  edgeHeavy: [0.40, 0.52, 0.68, 0.5],
   clear: [0.031, 0.075, 0.114, 1]
 }
 
@@ -213,8 +213,8 @@ const ensureEdgeCapacity = (count) => {
 }
 
 const nodeRadius = (relevance, kind) => {
-  const base = kind === 'cluster' ? 10.2 : 6.4
-  const modifier = Math.min(6.6, Math.max(0, relevance * 0.72))
+  const base = kind === 'cluster' ? 11.2 : 7.2
+  const modifier = Math.min(7.6, Math.max(0, relevance * 0.78))
   return base + modifier
 }
 
@@ -352,7 +352,9 @@ const drawNodeLayer = (predicate, color, radiusBoost = 1) => {
     const [sx, sy] = toScreenPoint(state.x[index], state.y[index])
     pointPositionsBuffer[positionCursor] = sx
     pointPositionsBuffer[positionCursor + 1] = sy
-    pointSizesBuffer[sizeCursor] = Math.max(1.2, state.radius[index] * camera.scale * devicePixelRatio * radiusBoost)
+    // Screen-space floor so every node stays a visible dot at any zoom (a low
+    // floor made nodes sub-pixel until zoomed in). Scaled by devicePixelRatio.
+    pointSizesBuffer[sizeCursor] = Math.max(3.0 * devicePixelRatio, state.radius[index] * camera.scale * devicePixelRatio * radiusBoost)
     positionCursor += 2
     sizeCursor += 1
   }

package/dist/application/get-graph-stream-chunk.js

@@ -3,6 +3,9 @@ const layoutCacheBySignature = new Map();
 const maxLayoutCacheEntries = 6;
 const farScaleThreshold = 0.22;
 const midScaleThreshold = 0.78;
+// Graphs with up to this many nodes render every node at all zoom levels (no
+// zoom-based clustering). Above it, the far/mid/near LOD keeps huge graphs fast.
+const renderAllNodeCap = 6000;
 const viewportPaddingFactor = 0.18;
 const maxNearEdgePerNode = 24;
 const maxMidEdgePerNode = 12;
@@ -296,23 +299,29 @@ export const getGraphStreamChunk = async (vaultPath, input) => {
             }
         };
     }
-    const mode = input.scale < farScaleThreshold
-        ? 'far'
-        : input.scale < midScaleThreshold
-            ? 'mid'
-            : 'near';
+    // When the whole graph fits a sane cap, render every node at every zoom (no
+    // clustering / budget-shrink), so nodes never disappear as you zoom out and
+    // reappear on approach. Only genuinely large graphs keep the far/mid/near LOD.
+    const rendersAll = layout.nodes.length <= renderAllNodeCap;
+    const effectiveNodeBudget = rendersAll ? Math.max(nodeBudget, layout.nodes.length) : nodeBudget;
+    const effectiveEdgeBudget = rendersAll ? Math.max(edgeBudget, layout.edges.length) : edgeBudget;
+    const mode = rendersAll || input.scale >= midScaleThreshold
+        ? 'near'
+        : input.scale < farScaleThreshold
+            ? 'far'
+            : 'mid';
     const nodes = mode === 'far'
-        ? selectFarClusters(layout.nodes, input, nodeBudget)
+        ? selectFarClusters(layout.nodes, input, effectiveNodeBudget)
         : mode === 'mid'
             ? selectMidNodes(layout.nodes, cache, {
                 ...input,
-                nodeBudget
+                nodeBudget: effectiveNodeBudget
             })
             : selectNearNodes(layout.nodes, cache, {
                 ...input,
-                nodeBudget
+                nodeBudget: effectiveNodeBudget
             });
-    const edges = collectEdgesForNodes(layout.edges, cache, nodes, edgeBudget, mode === 'near' ? maxNearEdgePerNode : mode === 'mid' ? maxMidEdgePerNode : maxFarEdgePerCluster);
+    const edges = collectEdgesForNodes(layout.edges, cache, nodes, effectiveEdgeBudget, mode === 'near' ? maxNearEdgePerNode : mode === 'mid' ? maxMidEdgePerNode : maxFarEdgePerCluster);
     return {
         signature,
         mode,

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@andespindola/brainlink",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Local-first knowledge memory for agents with Markdown, backlinks, indexing and context retrieval.",
   "type": "module",
   "license": "MIT",
-  "author": "Substructa",
+  "author": "Anderson Espindola",
   "homepage": "https://github.com/andersonflima/brainlink#readme",
   "repository": {
     "type": "git",