@andespindola/brainlink 0.1.0-beta.140 → 0.1.0-beta.142

package/README.md

@@ -82,7 +82,7 @@ Legacy `.jsonl.gz` packs are upgraded to `.blpk` automatically on first search/c
 - Built-in MCP stdio server for agent tool integration.
 - Local HTTP API.
 - Realtime graph UI with agent selector and colored knowledge groups.
-- Graph renderer keeps the full filtered graph visible during zoom/pan, rendering every visible node and edge without viewport culling.
+- Graph renderer keeps the full filtered graph visible during zoom/pan, rendering every visible node and edge without viewport culling or edge caps in the main view.
 - Canvas graph rendering uses the same batched node and edge pipeline for every graph size, reducing per-frame draw calls while keeping selected and hovered items highlighted.
 - WebGL acceleration is used when available for dense node and edge drawing, with Canvas 2D preserved as the interaction and fallback layer.
 - Large graph layout API automatically uses compact payload encoding with link-coverage-aware edge selection to reduce initial client load without hiding major relationships.
@@ -91,7 +91,7 @@ Legacy `.jsonl.gz` packs are upgraded to `.blpk` automatically on first search/c
 - Zoomed-out graph keeps the same flat graph scene and preserves complete filtered relationships without switching to nested subgraphs.
 - Graph reset fits the full graph scene instead of starting in a separate macro overview mode.
 - Graph filtering runs in a dedicated browser worker to keep the UI thread responsive during heavy datasets.
-- Edge rendering budgets adapt to zoom level to prevent frame spikes on large graph panoramas.
+- Node titles are shown as the user zooms closer, while labels remain bounded to visible on-screen nodes in very large graphs.
 
 ## Install
 
@@ -603,10 +603,10 @@ The graph UI shows:
 - keyboard shortcuts: `+` zoom in, `-` zoom out, `0` reset fit
 - click on a node opens its details panel; double-click on empty 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)
+- graph rendering safeguards (batched canvas drawing across graph sizes, 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
-- large graph view keeps a single-level graph model across zoom levels and renders the full filtered scene instead of viewport-sampled subsets
+- large graph view keeps a single-level graph model across zoom levels, renders the full filtered scene instead of viewport-sampled subsets, and shows node titles as zoom approaches readable scale
 
 The server indexes before starting by default. Use `--no-index` to skip that step:
 
@@ -694,6 +694,7 @@ blink config set-vault "s3://my-memory-bucket/brainlink" --global
 
 `config set-vault` writes configuration through CLI (no manual file edits required).  
 By default it writes local config (`./brainlink.config.json`), appends the vault to `allowedVaults`, and migrates Markdown memory from the current configured vault when the target is empty.  
+When the configured default vault is changed manually in config files, Brainlink also performs automatic migration on the next command that uses the configured vault (without explicit `--vault`).
 Use `--global` to write to `$BRAINLINK_HOME/brainlink.config.json`, `--no-migrate` to skip migration, and `--no-index` to skip post-migration indexing.
 `config doctor` is dry-run by default; use `--fix` to apply safe config normalization and allowlist fixes.
 

package/dist/application/auto-migrate-configured-vault.js

@@ -0,0 +1,37 @@
+import { indexVault } from './index-vault.js';
+import { migrateVaultContent } from './migrate-vault.js';
+import { getLastConfiguredVaultForKey, setLastConfiguredVaultForKey } from '../infrastructure/vault-migration-state.js';
+export const autoMigrateConfiguredVaultIfChanged = async (input) => {
+    const configKey = input.configKey.trim();
+    const configuredVault = input.configuredVault.trim();
+    if (configKey.length === 0 || configuredVault.length === 0) {
+        return {
+            changed: false,
+            migrated: false
+        };
+    }
+    const previousVault = await getLastConfiguredVaultForKey(configKey);
+    if (!previousVault) {
+        await setLastConfiguredVaultForKey(configKey, configuredVault);
+        return {
+            changed: false,
+            migrated: false
+        };
+    }
+    if (previousVault === configuredVault) {
+        return {
+            changed: false,
+            migrated: false
+        };
+    }
+    const migration = await migrateVaultContent(previousVault, configuredVault);
+    const shouldIndex = migration.copied + migration.conflicted > 0;
+    if (shouldIndex) {
+        await indexVault(configuredVault);
+    }
+    await setLastConfiguredVaultForKey(configKey, configuredVault);
+    return {
+        changed: true,
+        migrated: shouldIndex
+    };
+};

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

@@ -3,7 +3,6 @@ const glCanvas = document.getElementById('graphGl')
 const ctx = canvas.getContext('2d')
 const largeGraphNodeThreshold = 4000
 const massiveGraphNodeThreshold = 20000
-const largeGraphEdgeRenderLimit = 120000
 const renderNodeBudget = 1000
 const zoomedMassiveRenderNodeBudget = 2200
 const massiveOverviewRenderNodeBudget = 1800
@@ -539,16 +538,11 @@ 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
+  state.visibleEdges = edges
   state.visibleNodeSpatial = createSpatialIndex(nodes)
-  state.visibleEdgeByNode = createVisibleEdgeLookup(limitedEdges)
+  state.visibleEdgeByNode = createVisibleEdgeLookup(edges)
   const primaryHub = rankedHubNodes()[0] ?? null
   state.primaryHub = primaryHub
   markRenderDirty()
@@ -1007,7 +1001,7 @@ const drawGraphEdges = () => {
 const shouldDrawNodeLabels = (node, isSelected, isHovered) =>
   isSelected ||
   isHovered ||
-  (state.nodes.length > largeGraphNodeThreshold && !state.renderNodes.some(item => !item.isGroupNode) && state.transform.scale >= 1.25 && state.renderNodes.length <= 420) ||
+  (state.nodes.length > largeGraphNodeThreshold && state.transform.scale >= 0.78 && isNodeVisibleOnScreen(node, state.viewport.width, state.viewport.height)) ||
   (state.nodes.length <= largeGraphNodeThreshold && (state.transform.scale > 1.18 || state.nodes.length <= 25))
 
 const drawSingleNode = (node, options = { drawLabel: true }) => {
@@ -1157,24 +1151,35 @@ const partitionGraphForAcceleratedRenderer = () => {
 
 const drawGraphLabels = nodes => {
   const shouldDrawLabels = state.nodes.length > largeGraphNodeThreshold
-    ? state.transform.scale >= 1.25 && state.renderNodes.length <= 420
+    ? state.transform.scale >= 0.78
     : state.transform.scale >= 0.62 && state.renderNodes.length <= 1200
 
   if (!shouldDrawLabels) {
     return
   }
 
+  const maxLabels = state.nodes.length > largeGraphNodeThreshold
+    ? (state.transform.scale >= 1.5 ? 900 : state.transform.scale >= 1.05 ? 520 : 260)
+    : state.renderNodes.length
+  let drawnLabels = 0
   ctx.fillStyle = graphTheme.label
   ctx.font = '12px Inter, system-ui, sans-serif'
   ctx.textAlign = 'center'
   ctx.textBaseline = 'top'
   for (let index = 0; index < nodes.length; index += 1) {
     const node = nodes[index]
+    if (drawnLabels >= maxLabels) {
+      break
+    }
+    if (state.nodes.length > largeGraphNodeThreshold && !isNodeVisibleOnScreen(node, state.viewport.width, state.viewport.height)) {
+      continue
+    }
     const x = node.x
     const y = node.y
     const radius = nodeRadius(node)
     ctx.globalAlpha = 1
     ctx.fillText(node.title.slice(0, 34), x, y + radius + 8)
+    drawnLabels += 1
   }
   ctx.globalAlpha = 1
 }
@@ -2875,17 +2880,7 @@ const render = now => {
   } else {
     state.offscreenFrameCount = 0
   }
-  const minimumEdgeScale =
-    state.nodes.length > massiveGraphNodeThreshold
-      ? 0
-      : state.renderNodes.length > 1300
-        ? 0.12
-        : state.renderNodes.length > 900
-          ? 0.085
-          : state.renderNodes.length > 500
-            ? 0.05
-            : 0
-  const drawEdges = state.transform.scale >= minimumEdgeScale
+  const drawEdges = true
   if (drawAcceleratedGraph(width, height, drawEdges)) {
     // WebGL handles the dense node/edge layer; the 2D canvas remains the interaction overlay.
   } else {

package/dist/cli/runtime.js

@@ -1,11 +1,19 @@
-import { loadBrainlinkConfig, resolveAgentRuntimeDefaults } from '../infrastructure/config.js';
+import { autoMigrateConfiguredVaultIfChanged } from '../application/auto-migrate-configured-vault.js';
+import { loadBrainlinkConfigWithSource, resolveAgentRuntimeDefaults } from '../infrastructure/config.js';
 import { assertVaultAllowed } from '../infrastructure/file-system-vault.js';
 export const parsePositiveInteger = (value, fallback) => {
     const parsed = Number.parseInt(value, 10);
     return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 };
 export const resolveOptions = async (options) => {
-    const config = await loadBrainlinkConfig();
+    const { config, vaultSource } = await loadBrainlinkConfigWithSource();
+    if (options.vault === undefined) {
+        const sourceKey = vaultSource.sourcePath ? `${vaultSource.source}:${vaultSource.sourcePath}` : vaultSource.source;
+        await autoMigrateConfiguredVaultIfChanged({
+            configKey: sourceKey,
+            configuredVault: config.vault
+        });
+    }
     const vault = options.vault ?? config.vault;
     const allowedVault = assertVaultAllowed(vault, config.allowedVaults);
     const agent = options.agent ?? config.defaultAgent;

package/dist/infrastructure/config.js

@@ -181,12 +181,87 @@ export const resolveAgentRuntimeDefaults = (config, agent) => {
         defaultSearchMode: profile?.defaultSearchMode ?? config.defaultSearchMode
     };
 };
+const mergeConfigLayers = (layers) => layers.reduce((state, config) => ({
+    ...state,
+    ...config
+}), {});
+export const getVaultConfigSourceDetails = async (cwd = safeCwd()) => {
+    const [globalConfig, localConfig, legacyLocalConfig] = await Promise.all([
+        loadRawConfig('global', cwd),
+        loadRawConfig('local', cwd),
+        loadLegacyLocalRawConfig(cwd)
+    ]);
+    if (typeof legacyLocalConfig.vault === 'string' && legacyLocalConfig.vault.trim().length > 0) {
+        return {
+            source: 'local-legacy',
+            sourcePath: resolve(cwd, '.brainlink.json')
+        };
+    }
+    if (typeof localConfig.vault === 'string' && localConfig.vault.trim().length > 0) {
+        return {
+            source: 'local',
+            sourcePath: getLocalConfigPath(cwd)
+        };
+    }
+    if (typeof globalConfig.vault === 'string' && globalConfig.vault.trim().length > 0) {
+        return {
+            source: 'global',
+            sourcePath: getGlobalConfigPath()
+        };
+    }
+    return {
+        source: 'default',
+        sourcePath: null
+    };
+};
 export const loadBrainlinkConfig = async (cwd = safeCwd()) => {
     const globalConfig = await readJsonConfig(getGlobalConfigPath());
     const localConfigs = await Promise.all(configFilenames.map((filename) => readJsonConfig(resolve(cwd, filename))));
-    const merged = [globalConfig, ...localConfigs].reduce((state, config) => ({
-        ...state,
-        ...config
-    }), {});
+    const merged = mergeConfigLayers([globalConfig, ...localConfigs]);
     return sanitizeConfig(merged);
 };
+export const loadBrainlinkConfigWithSource = async (cwd = safeCwd()) => {
+    const globalConfigPath = getGlobalConfigPath();
+    const localConfigPath = getLocalConfigPath(cwd);
+    const legacyLocalConfigPath = resolve(cwd, '.brainlink.json');
+    const [globalConfig, localConfig, legacyLocalConfig] = await Promise.all([
+        readJsonConfig(globalConfigPath),
+        readJsonConfig(localConfigPath),
+        readJsonConfig(legacyLocalConfigPath)
+    ]);
+    const config = sanitizeConfig(mergeConfigLayers([globalConfig, localConfig, legacyLocalConfig]));
+    if (typeof legacyLocalConfig.vault === 'string' && legacyLocalConfig.vault.trim().length > 0) {
+        return {
+            config,
+            vaultSource: {
+                source: 'local-legacy',
+                sourcePath: legacyLocalConfigPath
+            }
+        };
+    }
+    if (typeof localConfig.vault === 'string' && localConfig.vault.trim().length > 0) {
+        return {
+            config,
+            vaultSource: {
+                source: 'local',
+                sourcePath: localConfigPath
+            }
+        };
+    }
+    if (typeof globalConfig.vault === 'string' && globalConfig.vault.trim().length > 0) {
+        return {
+            config,
+            vaultSource: {
+                source: 'global',
+                sourcePath: globalConfigPath
+            }
+        };
+    }
+    return {
+        config,
+        vaultSource: {
+            source: 'default',
+            sourcePath: null
+        }
+    };
+};

package/dist/infrastructure/vault-migration-state.js

@@ -0,0 +1,69 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { getBrainlinkHomePath } from './paths.js';
+const defaultState = {
+    byConfigKey: {}
+};
+const statePath = () => join(getBrainlinkHomePath(), 'vault-migration-state.json');
+const sanitizeState = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return defaultState;
+    }
+    const record = value;
+    const byConfigKeyRecord = typeof record.byConfigKey === 'object' && record.byConfigKey !== null ? record.byConfigKey : {};
+    const byConfigKey = Object.entries(byConfigKeyRecord).reduce((state, [key, vault]) => {
+        if (typeof key !== 'string' || key.trim().length === 0) {
+            return state;
+        }
+        if (typeof vault !== 'string' || vault.trim().length === 0) {
+            return state;
+        }
+        return {
+            ...state,
+            [key]: vault.trim()
+        };
+    }, {});
+    return {
+        byConfigKey
+    };
+};
+const readState = async () => {
+    try {
+        const raw = await readFile(statePath(), 'utf8');
+        return sanitizeState(JSON.parse(raw));
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return defaultState;
+        }
+        throw error;
+    }
+};
+const writeState = async (state) => {
+    const path = statePath();
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    await writeFile(path, `${JSON.stringify(state, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
+};
+export const getVaultMigrationStatePath = () => statePath();
+export const getLastConfiguredVaultForKey = async (configKey) => {
+    const state = await readState();
+    const value = state.byConfigKey[configKey];
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+};
+export const setLastConfiguredVaultForKey = async (configKey, vault) => {
+    const key = configKey.trim();
+    const value = vault.trim();
+    if (key.length === 0 || value.length === 0) {
+        return;
+    }
+    const state = await readState();
+    if (state.byConfigKey[key] === value) {
+        return;
+    }
+    await writeState({
+        byConfigKey: {
+            ...state.byConfigKey,
+            [key]: value
+        }
+    });
+};

package/docs/AGENT_USAGE.md

@@ -607,7 +607,7 @@ Without `--vault`, the graph UI serves `$HOME/.brainlink/vault`.
 
 The frontend includes an agent selector that shows only the agent id. Selecting an agent calls the same read APIs with `agent=<agent-id>` and renders that namespace instead of merging every agent into one graph.
 
-Graph navigation controls include zoom in, zoom out, fit visible nodes and reset-to-fit-all nodes. Mouse wheel zoom (including `cmd+scroll` and `ctrl+scroll`) is anchored to the cursor and applied immediately without delayed focus interpolation. Keyboard shortcuts are `+` (zoom in), `-` (zoom out) and `0` (reset fit). Double-click on empty canvas zooms in at cursor position. Clicking a node opens its details panel. Totals for notes, links and tags stay visible as floating metrics under the Brainlink title, and node details open in a non-modal side panel (tags, outgoing links, backlinks and Markdown content), so zoom and pan remain available during inspection. Vaults above 1000 notes keep the same single graph scene and render the full filtered node/edge set during navigation, without viewport-sampled subgraph switching.
+Graph navigation controls include zoom in, zoom out, fit visible nodes and reset-to-fit-all nodes. Mouse wheel zoom (including `cmd+scroll` and `ctrl+scroll`) is anchored to the cursor and applied immediately without delayed focus interpolation. Keyboard shortcuts are `+` (zoom in), `-` (zoom out) and `0` (reset fit). Double-click on empty canvas zooms in at cursor position. Clicking a node opens its details panel. Totals for notes, links and tags stay visible as floating metrics under the Brainlink title, and node details open in a non-modal side panel (tags, outgoing links, backlinks and Markdown content), so zoom and pan remain available during inspection. Vaults above 1000 notes keep the same single graph scene and render the full filtered node/edge set during navigation, without viewport-sampled subgraph switching. Node titles appear as zoom approaches readable scale, limited to on-screen nodes in very large graphs.
 During graph filtering, Brainlink keeps hub context nodes visible (`Memory Hub`/`MOC`/high-degree fallback) so filtered views still show relationship anchors.
 
 The command reindexes by default, then serves:

package/package.json

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