@andespindola/brainlink 0.1.0-beta.1 → 0.1.0-beta.11

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

@@ -1,17 +1,25 @@
 export const createClientJs = () => `const canvas = document.getElementById('graph')
 const ctx = canvas.getContext('2d')
+const largeGraphNodeThreshold = 4000
+const largeGraphEdgeRenderLimit = 16000
 const state = {
   graph: { nodes: [], edges: [] },
   nodes: [],
   edges: [],
+  visibleNodes: [],
+  visibleEdges: [],
+  nodeDegrees: new Map(),
   selected: null,
   hovered: null,
   query: '',
+  contentFilter: { query: '', ids: null, token: 0, timer: null },
   agentId: '',
   agentsSignature: '',
+  nodeDetails: new Map(),
   transform: { x: 0, y: 0, scale: 1 },
   pointer: { x: 0, y: 0, down: false, dragNode: null, moved: false },
   graphSignature: '',
+  graphStatus: '',
   last: performance.now()
 }
 
@@ -23,26 +31,40 @@ const escapeHtml = value => String(value)
   .replaceAll('"', '"')
   .replaceAll("'", ''')
 const elements = {
-  stats: byId('stats'),
   search: byId('search'),
   agent: byId('agent'),
-  title: byId('title'),
-  path: byId('path'),
-  tags: byId('tags'),
-  notes: byId('notes'),
-  content: byId('content'),
-  outgoing: byId('outgoing'),
-  incoming: byId('incoming'),
   nodeCount: byId('nodeCount'),
   edgeCount: byId('edgeCount'),
   tagCount: byId('tagCount'),
   zoomIn: byId('zoomIn'),
   zoomOut: byId('zoomOut'),
-  reset: byId('reset')
+  fit: byId('fit'),
+  reset: byId('reset'),
+  contentDialog: byId('contentDialog'),
+  contentTitle: byId('contentTitle'),
+  contentPath: byId('contentPath'),
+  contentTags: byId('contentTags'),
+  contentOutgoing: byId('contentOutgoing'),
+  contentIncoming: byId('contentIncoming'),
+  contentBody: byId('contentBody'),
+  contentClose: byId('contentClose')
+}
+
+const zoomRange = {
+  min: 0.05,
+  max: 4.5
 }
 
 const agentQuery = () => state.agentId ? '?agent=' + encodeURIComponent(state.agentId) : ''
 
+const setGraphStatus = text => {
+  state.graphStatus = text
+}
+
+const handleGraphRefreshError = error => {
+  console.error(error)
+}
+
 const graphTheme = {
   node: '#aeb8c5',
   nodeSelected: '#f3f7fb',
@@ -66,30 +88,96 @@ const resize = () => {
   ctx.setTransform(ratio, 0, 0, ratio, 0, 0)
 }
 
-const filteredNodes = () => {
-  const query = state.query.trim().toLowerCase()
-  if (!query) return state.nodes
-  return state.nodes.filter(node =>
+const normalizeQuery = value => value.trim().toLowerCase()
+
+const localFilteredNodes = query =>
+  state.nodes.filter(node =>
     node.title.toLowerCase().includes(query) ||
     node.path.toLowerCase().includes(query) ||
     node.tags.some(tag => tag.toLowerCase().includes(query))
   )
-}
 
-const visibleIds = () => new Set(filteredNodes().map(node => node.id))
+const filteredNodes = () => {
+  const query = normalizeQuery(state.query)
+  if (!query) return state.nodes
+  if (state.contentFilter.query === query && state.contentFilter.ids instanceof Set) {
+    return state.nodes.filter(node => state.contentFilter.ids.has(node.id))
+  }
+
+  return localFilteredNodes(query)
+}
 
-const visibleEdges = () => {
-  const ids = visibleIds()
-  return state.edges.filter(edge => ids.has(edge.source) && edge.target && ids.has(edge.target))
+const recomputeVisibility = () => {
+  const nodes = filteredNodes()
+  const ids = new Set(nodes.map(node => node.id))
+  const edges = state.edges.filter(edge => ids.has(edge.source) && edge.target && ids.has(edge.target))
+  const limitedEdges = state.nodes.length > largeGraphNodeThreshold
+    ? [...edges]
+      .sort((left, right) => edgeWeight(right) - edgeWeight(left))
+      .slice(0, largeGraphEdgeRenderLimit)
+    : edges
+
+  state.visibleNodes = nodes
+  state.visibleEdges = limitedEdges
 }
 
 const edgeWeight = edge => Number.isFinite(edge.weight) ? Math.max(1, edge.weight) : 1
 
-const resetView = () => {
+const clampScale = value => Math.max(zoomRange.min, Math.min(zoomRange.max, value))
+
+const graphBounds = nodes => {
+  if (nodes.length === 0) return null
+  let minX = Number.POSITIVE_INFINITY
+  let maxX = Number.NEGATIVE_INFINITY
+  let minY = Number.POSITIVE_INFINITY
+  let maxY = Number.NEGATIVE_INFINITY
+
+  nodes.forEach(node => {
+    const radius = nodeRadius(node)
+    minX = Math.min(minX, node.x - radius)
+    maxX = Math.max(maxX, node.x + radius)
+    minY = Math.min(minY, node.y - radius)
+    maxY = Math.max(maxY, node.y + radius)
+  })
+
+  return {
+    minX,
+    maxX,
+    minY,
+    maxY,
+    width: Math.max(maxX - minX, 1),
+    height: Math.max(maxY - minY, 1)
+  }
+}
+
+const fitView = (options = { useFiltered: true }) => {
   const rect = canvas.getBoundingClientRect()
-  state.transform = { x: Math.max(rect.width, 320) / 2, y: Math.max(rect.height, 320) / 2, scale: 1 }
+  const width = Math.max(rect.width, 320)
+  const height = Math.max(rect.height, 320)
+  const nodes = options.useFiltered ? filteredNodes() : state.nodes
+  const bounds = graphBounds(nodes)
+
+  if (!bounds) {
+    state.transform = { x: width / 2, y: height / 2, scale: 1 }
+    return
+  }
+
+  const padding = 100
+  const scaleX = width / (bounds.width + padding * 2)
+  const scaleY = height / (bounds.height + padding * 2)
+  const scale = clampScale(Math.min(scaleX, scaleY))
+  const centerX = (bounds.minX + bounds.maxX) / 2
+  const centerY = (bounds.minY + bounds.maxY) / 2
+
+  state.transform = {
+    x: width / 2 - centerX * scale,
+    y: height / 2 - centerY * scale,
+    scale
+  }
 }
 
+const resetView = () => fitView({ useFiltered: false })
+
 const createLayout = graph => {
   const nodes = graph.nodes.map(node => ({
     ...node,
@@ -111,18 +199,79 @@ const encodeEntityTag = (value) => {
     binary += String.fromCharCode(utf8[index])
   }
 
-  return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '')
+  return btoa(binary).replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/g, '')
 }
 
 const graphSignature = graph => JSON.stringify({
-  nodes: graph.nodes.map(node => [node.id, node.title, node.path, node.content, node.tags]),
+  nodes: graph.nodes.map(node => [node.id, node.title, node.path, node.tags]),
   edges: graph.edges.map(edge => [edge.source, edge.target, edge.targetTitle, edge.weight, edge.priority])
 })
 
+const resetContentFilter = () => {
+  if (state.contentFilter.timer) {
+    clearTimeout(state.contentFilter.timer)
+  }
+  state.contentFilter = {
+    query: '',
+    ids: null,
+    token: state.contentFilter.token + 1,
+    timer: null
+  }
+  recomputeVisibility()
+}
+
+const syncContentFilter = async (query, token) => {
+  const response = await fetch(
+    '/api/graph-filter?q=' +
+      encodeURIComponent(query) +
+      '&limit=' +
+      encodeURIComponent(String(Math.max(state.nodes.length, 1))) +
+      agentQuery()
+  )
+
+  if (!response.ok || token !== state.contentFilter.token) {
+    return
+  }
+
+  const payload = await response.json()
+  const nodeIds = Array.isArray(payload?.nodeIds) ? payload.nodeIds.filter(id => typeof id === 'string') : []
+  if (token !== state.contentFilter.token) {
+    return
+  }
+
+  state.contentFilter.query = query
+  state.contentFilter.ids = new Set(nodeIds)
+  recomputeVisibility()
+}
+
+const scheduleContentFilterSync = () => {
+  const query = normalizeQuery(state.query)
+  if (!query) {
+    resetContentFilter()
+    return
+  }
+
+  if (state.contentFilter.timer) {
+    clearTimeout(state.contentFilter.timer)
+  }
+
+  const token = state.contentFilter.token + 1
+  state.contentFilter = {
+    query: state.contentFilter.query,
+    ids: state.contentFilter.ids,
+    token,
+    timer: setTimeout(() => {
+      syncContentFilter(query, token).catch(() => {})
+    }, 180)
+  }
+}
+
 const tick = delta => {
-  const nodes = filteredNodes()
-  const ids = new Set(nodes.map(node => node.id))
-  const edges = state.edges.filter(edge => ids.has(edge.source) && edge.target && ids.has(edge.target))
+  const nodes = state.visibleNodes
+  const edges = state.visibleEdges
+  if (nodes.length > 1200) {
+    return
+  }
   const strength = Math.min(delta / 16, 2)
 
   edges.forEach(edge => {
@@ -181,7 +330,11 @@ const worldPoint = event => {
 }
 
 const hitNode = point => {
-  const nodes = filteredNodes()
+  if (state.nodes.length > largeGraphNodeThreshold && state.transform.scale < 0.55) {
+    return null
+  }
+
+  const nodes = state.visibleNodes
   for (let index = nodes.length - 1; index >= 0; index -= 1) {
     const node = nodes[index]
     const radius = nodeRadius(node)
@@ -191,13 +344,18 @@ const hitNode = point => {
 }
 
 const nodeRadius = node => {
-  const degree = state.edges.filter(edge => edge.source === node.id || edge.target === node.id).length
+  const degree = state.nodeDegrees.get(node.id) ?? 0
   return 9 + Math.min(degree, 8) * 1.6
 }
 
 const render = now => {
   const delta = now - state.last
   state.last = now
+  const minFrameIntervalMs = state.nodes.length > largeGraphNodeThreshold ? 180 : 16
+  if (delta < minFrameIntervalMs) {
+    requestAnimationFrame(render)
+    return
+  }
   const rect = canvas.getBoundingClientRect()
   const width = Math.max(rect.width, 320)
   const height = Math.max(rect.height, 320)
@@ -214,7 +372,10 @@ const render = now => {
   ctx.translate(state.transform.x, state.transform.y)
   ctx.scale(state.transform.scale, state.transform.scale)
 
-  visibleEdges().forEach(edge => {
+  tick(delta)
+  const drawEdges = !(state.nodes.length > largeGraphNodeThreshold && state.transform.scale < 0.22)
+  if (drawEdges) {
+    state.visibleEdges.forEach(edge => {
     const selectedEdge = state.selected && (edge.source === state.selected.id || edge.target === state.selected.id)
     ctx.beginPath()
     ctx.moveTo(edge.sourceNode.x, edge.sourceNode.y)
@@ -222,9 +383,10 @@ const render = now => {
     ctx.strokeStyle = selectedEdge ? graphTheme.edgeActive : graphTheme.edge
     ctx.lineWidth = (selectedEdge ? 1.8 : 1) + Math.min(edgeWeight(edge) - 1, 8) * 0.22
     ctx.stroke()
-  })
+    })
+  }
 
-  filteredNodes().forEach(node => {
+  state.visibleNodes.forEach(node => {
     const radius = nodeRadius(node)
     const isSelected = state.selected?.id === node.id
     const isHovered = state.hovered?.id === node.id
@@ -240,7 +402,11 @@ const render = now => {
     ctx.strokeStyle = isSelected ? graphTheme.nodeStrokeActive : graphTheme.nodeStroke
     ctx.stroke()
 
-    if (isSelected || isHovered || state.transform.scale > 1.18 || state.nodes.length <= 25) {
+    const shouldDrawLabels =
+      isSelected ||
+      isHovered ||
+      (state.nodes.length <= largeGraphNodeThreshold && (state.transform.scale > 1.18 || state.nodes.length <= 25))
+    if (shouldDrawLabels) {
       ctx.fillStyle = graphTheme.label
       ctx.font = '12px Inter, system-ui, sans-serif'
       ctx.textAlign = 'center'
@@ -257,22 +423,7 @@ const list = items => items.length
   ? items.map(item => '<li>' + (item.id ? '<button type="button" data-node-id="' + escapeHtml(item.id) + '">' + escapeHtml(item.title) + '</button>' : escapeHtml(item.title)) + '<small>' + escapeHtml(item.path) + (item.weight ? ' · weight ' + escapeHtml(item.weight) + ' · ' + escapeHtml(item.priority || 'normal') : '') + '</small></li>').join('')
   : '<li><small>No links found.</small></li>'
 
-const allNotesList = () => state.nodes.length
-  ? state.nodes.map(node => '<li><button type="button" data-node-id="' + escapeHtml(node.id) + '">' + escapeHtml(node.title) + '</button><small>' + escapeHtml(node.path) + '</small></li>').join('')
-  : '<li><small>No notes indexed.</small></li>'
-
-const selectNode = node => {
-  state.selected = node
-  if (!node) {
-    elements.title.textContent = 'Graph Overview'
-    elements.path.textContent = state.nodes.length + ' notes and ' + state.graph.edges.length + ' links indexed.'
-    elements.tags.innerHTML = ''
-    elements.notes.innerHTML = allNotesList()
-    elements.content.textContent = 'Selecione uma nota no grafo ou na lista para ver o Markdown completo, backlinks e links de saida.'
-    elements.outgoing.innerHTML = '<li><small>Select a note to inspect outgoing links.</small></li>'
-    elements.incoming.innerHTML = '<li><small>Select a note to inspect backlinks.</small></li>'
-    return
-  }
+const linkedNodes = node => {
   const nodeById = new Map(state.nodes.map(item => [item.id, item]))
   const withEdgeMeta = (linkedNode, edge) => linkedNode ? {
     ...linkedNode,
@@ -288,56 +439,129 @@ const selectNode = node => {
     .map(edge => withEdgeMeta(nodeById.get(edge.source), edge))
     .filter(Boolean)
 
-  elements.title.textContent = node.title
-  elements.path.textContent = node.path
-  elements.tags.innerHTML = node.tags.length
+  return { outgoing, incoming }
+}
+
+const fetchNodeDetails = async node => {
+  const cached = state.nodeDetails.get(node.id)
+  if (cached) {
+    return cached
+  }
+
+  const response = await fetch('/api/graph-node?id=' + encodeURIComponent(node.id) + agentQuery())
+  if (!response.ok) {
+    throw new Error('Failed to load graph node details')
+  }
+
+  const payload = await response.json()
+  const detail = payload?.node
+  if (!detail || !detail.id) {
+    throw new Error('Invalid graph node payload')
+  }
+  state.nodeDetails.set(detail.id, detail)
+  return detail
+}
+
+const openContentDialog = async node => {
+  if (!node) return
+  const { outgoing, incoming } = linkedNodes(node)
+  elements.contentTitle.textContent = node.title
+  elements.contentPath.textContent = node.path
+  elements.contentTags.innerHTML = node.tags.length
     ? node.tags.map(tag => '<span>#' + escapeHtml(tag) + '</span>').join('')
     : '<span>No tags</span>'
-  elements.notes.innerHTML = allNotesList()
-  elements.content.textContent = node.content
-  elements.outgoing.innerHTML = list(outgoing)
-  elements.incoming.innerHTML = list(incoming)
+  elements.contentOutgoing.innerHTML = list(outgoing)
+  elements.contentIncoming.innerHTML = list(incoming)
+  elements.contentBody.textContent = 'Loading note content...'
+  if (!elements.contentDialog.open) {
+    elements.contentDialog.showModal()
+  }
+
+  try {
+    const detailedNode = await fetchNodeDetails(node)
+    if (state.selected?.id !== node.id) {
+      return
+    }
+    elements.contentBody.textContent = detailedNode.content
+  } catch {
+    elements.contentBody.textContent = 'Unable to load note content.'
+  }
+}
+
+const selectNode = (node, options = { openContent: false }) => {
+  state.selected = node
+  if (node && options.openContent) {
+    openContentDialog(node).catch(() => {
+      elements.contentBody.textContent = 'Unable to load note content.'
+    })
+  }
 }
 
 const selectNodeById = id => {
   const node = state.nodes.find(item => item.id === id)
-  if (node) selectNode(node)
+  if (node) selectNode(node, { openContent: true })
 }
 
-const zoom = factor => {
-  state.transform.scale = Math.max(0.25, Math.min(3.5, state.transform.scale * factor))
+const zoomAtPoint = (screenX, screenY, factor) => {
+  const nextScale = clampScale(state.transform.scale * factor)
+  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 = nextScale
+  state.transform.x = screenX - worldX * nextScale
+  state.transform.y = screenY - worldY * nextScale
 }
 
 const bindEvents = () => {
   window.addEventListener('resize', resize)
   elements.search.addEventListener('input', event => {
     state.query = event.target.value
-    elements.stats.textContent = state.query
-      ? filteredNodes().length + ' filtered notes'
-      : state.nodes.length + ' notes · ' + state.edges.length + ' links'
+    recomputeVisibility()
+    scheduleContentFilterSync()
   })
   elements.agent.addEventListener('change', event => {
     state.agentId = event.target.value
     state.selected = null
+    state.nodeDetails = new Map()
+    resetContentFilter()
+    recomputeVisibility()
+    scheduleContentFilterSync()
     loadGraph({ reset: true }).catch(error => {
-      elements.stats.textContent = 'Failed to load agent graph'
       console.error(error)
     })
   })
-  elements.zoomIn.addEventListener('click', () => zoom(1.18))
-  elements.zoomOut.addEventListener('click', () => zoom(0.84))
-  elements.reset.addEventListener('click', resetView)
-  ;[elements.notes, elements.outgoing, elements.incoming].forEach(element => {
-    element.addEventListener('click', event => {
-      const target = event.target
-      if (!(target instanceof HTMLElement)) return
-      const nodeId = target.dataset.nodeId
-      if (nodeId) selectNodeById(nodeId)
+  elements.zoomIn.addEventListener('click', () => {
+    const rect = canvas.getBoundingClientRect()
+    zoomAtPoint(Math.max(rect.width, 320) / 2, Math.max(rect.height, 320) / 2, 1.18)
+  })
+  elements.zoomOut.addEventListener('click', () => {
+    const rect = canvas.getBoundingClientRect()
+    zoomAtPoint(Math.max(rect.width, 320) / 2, Math.max(rect.height, 320) / 2, 0.84)
+  })
+  if (elements.fit) {
+    elements.fit.addEventListener('click', () => {
+      fitView({ useFiltered: true })
     })
+  }
+  elements.reset.addEventListener('click', () => {
+    resetView()
+  })
+  elements.contentClose.addEventListener('click', () => elements.contentDialog.close())
+  elements.contentDialog.addEventListener('click', event => {
+    const target = event.target
+    if (target instanceof HTMLElement && target.dataset.nodeId) {
+      selectNodeById(target.dataset.nodeId)
+      return
+    }
+    if (event.target === elements.contentDialog) elements.contentDialog.close()
   })
   canvas.addEventListener('wheel', event => {
     event.preventDefault()
-    zoom(event.deltaY < 0 ? 1.08 : 0.92)
+    const rect = canvas.getBoundingClientRect()
+    const cursorX = event.clientX - rect.left
+    const cursorY = event.clientY - rect.top
+    const factor = event.deltaY < 0 ? 1.08 : 0.92
+    zoomAtPoint(cursorX, cursorY, factor)
   }, { passive: false })
   canvas.addEventListener('pointerdown', event => {
     const point = worldPoint(event)
@@ -367,8 +591,8 @@ const bindEvents = () => {
     state.transform.y += dy
   })
   canvas.addEventListener('pointerup', event => {
-    if (state.pointer.dragNode && !state.pointer.moved) selectNode(state.pointer.dragNode)
-    if (!state.pointer.dragNode && !state.pointer.moved) selectNode(state.hovered)
+    if (state.pointer.dragNode && !state.pointer.moved) selectNode(state.pointer.dragNode, { openContent: true })
+    if (!state.pointer.dragNode && !state.pointer.moved) selectNode(state.hovered, { openContent: true })
     state.pointer = { x: 0, y: 0, down: false, dragNode: null, moved: false }
     canvas.releasePointerCapture(event.pointerId)
   })
@@ -417,14 +641,29 @@ const loadGraph = async (options = { reset: false }) => {
   state.graph = graph
   state.nodes = layout.nodes
   state.edges = layout.edges
+  state.nodeDegrees = state.edges.reduce((degrees, edge) => {
+    degrees.set(edge.source, (degrees.get(edge.source) ?? 0) + edgeWeight(edge))
+    if (edge.target) {
+      degrees.set(edge.target, (degrees.get(edge.target) ?? 0) + edgeWeight(edge))
+    }
+    return degrees
+  }, new Map())
+  state.nodeDetails = new Map()
+  resetContentFilter()
+  recomputeVisibility()
+  scheduleContentFilterSync()
   const tags = new Set(graph.nodes.flatMap(node => node.tags))
-  elements.stats.textContent = state.agentId + ' · ' + graph.nodes.length + ' notes · ' + graph.edges.length + ' links · live'
+  setGraphStatus(state.agentId + ' · ' + graph.nodes.length + ' notes · ' + graph.edges.length + ' links · live')
   elements.nodeCount.textContent = graph.nodes.length
   elements.edgeCount.textContent = graph.edges.length
   elements.tagCount.textContent = tags.size
   resize()
   if (options.reset) resetView()
-  selectNode(state.nodes.find(node => node.id === selectedId) ?? null)
+  const selectedNode = state.nodes.find(node => node.id === selectedId) ?? null
+  selectNode(selectedNode, { openContent: Boolean(selectedNode && elements.contentDialog.open) })
+  if (!selectedNode && elements.contentDialog.open) {
+    elements.contentDialog.close()
+  }
 }
 
 bindEvents()
@@ -441,10 +680,7 @@ const refreshGraphLoop = () => {
     return
   }
 
-  loadGraph().catch((error) => {
-    elements.stats.textContent = 'Failed to refresh graph'
-    console.error(error)
-  })
+  loadGraph().catch(handleGraphRefreshError)
 
   tickCounter += 1
   if (tickCounter % 3 === 0) {
@@ -461,7 +697,6 @@ loadAgents()
     setInterval(refreshGraphLoop, pollIntervalMs)
   })
   .catch(error => {
-    elements.stats.textContent = 'Failed to load graph'
     console.error(error)
   })
 
@@ -470,9 +705,6 @@ document.addEventListener('visibilitychange', () => {
     return
   }
 
-  loadGraph({ reset: true }).catch(error => {
-    elements.stats.textContent = 'Failed to refresh graph'
-    console.error(error)
-  })
+  loadGraph({ reset: true }).catch(handleGraphRefreshError)
 })
 `;

package/dist/application/get-graph-layout.js

@@ -1,26 +1,41 @@
+import { createHash } from 'node:crypto';
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
 import { createCauliflowerGraphLayout } from '../domain/graph-layout.js';
-import { getGraph } from './get-graph.js';
+import { getGraphSummary } from './get-graph-summary.js';
 const graphLayoutCache = new Map();
+const readDatabaseSignature = async (vaultPath) => {
+    try {
+        const info = await stat(join(vaultPath, '.brainlink', 'brainlink.db'));
+        return `${Math.floor(info.mtimeMs)}:${info.size}`;
+    }
+    catch {
+        return '0:0';
+    }
+};
 const createGraphSignature = (graph) => {
     const nodesSignature = graph.nodes.map((node) => `${node.id}|${node.agentId}|${node.title}|${node.path}`).join('\n');
     const edgesSignature = graph.edges
         .map((edge) => `${edge.source}|${edge.target ?? ''}|${edge.targetTitle}|${edge.weight}|${edge.priority}`)
         .join('\n');
-    return `${graph.nodes.length}:${nodesSignature}|${graph.edges.length}:${edgesSignature}`;
+    return createHash('sha256')
+        .update(`${graph.nodes.length}:${nodesSignature}|${graph.edges.length}:${edgesSignature}`)
+        .digest('hex');
 };
 export const getGraphLayout = async (vaultPath, agentId) => {
-    const graph = await getGraph(vaultPath, agentId);
-    const signature = createGraphSignature(graph);
+    const databaseSignature = await readDatabaseSignature(vaultPath);
     const cacheKey = `${vaultPath}:${agentId ?? ''}`;
     const cached = graphLayoutCache.get(cacheKey);
-    if (cached?.signature === signature) {
+    if (cached?.databaseSignature === databaseSignature) {
         return {
-            signature,
+            signature: cached.signature,
             layout: cached.layout
         };
     }
+    const graph = await getGraphSummary(vaultPath, agentId);
+    const signature = createGraphSignature(graph);
     const layout = createCauliflowerGraphLayout(graph);
-    graphLayoutCache.set(cacheKey, { signature, layout });
+    graphLayoutCache.set(cacheKey, { databaseSignature, signature, layout });
     return {
         signature,
         layout

package/dist/application/get-graph-node.js

@@ -0,0 +1,12 @@
+import { ensureVault } from '../infrastructure/file-system-vault.js';
+import { openSqliteIndex } from '../infrastructure/sqlite-index.js';
+export const getGraphNode = async (vaultPath, id, agentId) => {
+    const absoluteVaultPath = await ensureVault(vaultPath);
+    const index = openSqliteIndex(absoluteVaultPath);
+    try {
+        return index.getGraphNode(id, agentId);
+    }
+    finally {
+        index.close();
+    }
+};

package/dist/application/get-graph-summary.js

@@ -0,0 +1,12 @@
+import { ensureVault } from '../infrastructure/file-system-vault.js';
+import { openSqliteIndex } from '../infrastructure/sqlite-index.js';
+export const getGraphSummary = async (vaultPath, agentId) => {
+    const absoluteVaultPath = await ensureVault(vaultPath);
+    const index = openSqliteIndex(absoluteVaultPath);
+    try {
+        return index.getGraphSummary(agentId);
+    }
+    finally {
+        index.close();
+    }
+};

package/dist/application/index-vault.js

@@ -3,6 +3,7 @@ import { sharedAgentId } from '../domain/agents.js';
 import { createEmbeddingProvider } from '../domain/embeddings.js';
 import { loadBrainlinkConfig } from '../infrastructure/config.js';
 import { ensureVault, readMarkdownFiles } from '../infrastructure/file-system-vault.js';
+import { buildSearchPacks } from '../infrastructure/search-packs.js';
 import { openSqliteIndex } from '../infrastructure/sqlite-index.js';
 const toTitleKey = (title) => title.toLowerCase();
 const appendTitleEntry = (map, document) => {
@@ -63,6 +64,12 @@ export const indexVault = async (vaultPath) => {
     try {
         index.reset();
         index.saveDocuments(indexedDocuments);
+        try {
+            await buildSearchPacks(absoluteVaultPath, indexedDocuments);
+        }
+        catch {
+            // Pack generation is best-effort. SQLite index remains the primary path.
+        }
         return {
             documentCount: indexedDocuments.length,
             chunkCount: indexedDocuments.reduce((total, document) => total + document.chunks.length, 0),