@andespindola/brainlink 1.3.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # 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.
+- **Domain partitioning on write.** `brainlink_add_note`, `brainlink_add_notes` (batch-level and per-note) and `brainlink_remember` accept a `context`. When set, the note is linked to its `<context> Hub` (created if missing) so the knowledge graph stays split into navigable domains instead of collapsing into a single per-namespace context. An explicit context always links, even when auto context links are otherwise disabled.
+- **Lossless namespace merge.** New `brainlink_vault_merge_agents` MCP tool and `blink vaults merge-agents` CLI merge one agent namespace into another within a vault (e.g. `claude-code` → `shared`) without losing data: identical notes are skipped, colliding slugs with different content are kept under a `-from-<agent>` name, everything else is moved, and merged notes are aggregated into domain hubs. Source notes are kept unless `deleteSource` is set; `dryRun` previews the plan.
+- **Stronger on-connect instructions.** The advertised server instructions now encode consult-before-acting, domain partitioning on every write, persistent and volatile memory used together, and shared-by-default so all agents form one continuous brain. The field stays advisory and no tool contract changed.
+
 ## 1.3.0
 
 - **MCP server instructions on connect.** The server now advertises `instructions` in its initialize response, so clients that surface them (e.g. Claude Code) inject Brainlink's memory discipline into the agent's context the moment it connects — treat Brainlink as the default context source for everything, bootstrap first with a task query, use the full toolkit (both RAG and CAG via `strategy: auto`, context packs, hybrid search, the knowledge graph, explain/recommendations/validate/stats) instead of shallow retrieval, keep ephemeral facts in volatile memory, and persist durable learnings as connected notes. The field is advisory (clients that ignore it are unaffected) and no tool contract changed.

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
@@ -543,9 +543,9 @@ Available tools:
 - `brainlink_similar_notes`: find the notes most similar to a given note (by title or path), excluding the note itself.
 - `brainlink_dedupe`: detect duplicate candidates using exact hash + semantic similarity scores.
 - `brainlink_resolve_duplicate`: resolve duplicate pairs (`merge`, `link`, `ignore`) with connectivity-safe fallback edges.
-- `brainlink_add_note`: write durable Markdown memory and reindex.
-- `brainlink_add_notes`: write several notes in one batch, reindexing once.
-- `brainlink_remember`: capture durable memory with inferred title, tags and Context Links; supports dry-run.
+- `brainlink_add_note`: write durable Markdown memory and reindex. Pass `context` to partition the note under a `<context> Hub` (created if missing) so the graph stays split by domain.
+- `brainlink_add_notes`: write several notes in one batch, reindexing once. Accepts a batch-level `context` and per-note `context` overrides.
+- `brainlink_remember`: capture durable memory with inferred title, tags and Context Links; supports dry-run. Pass `context` to partition it under a domain hub.
 - `brainlink_inbox_add`: capture a quick untriaged memory item.
 - `brainlink_inbox_list`: list untriaged inbox memory items.
 - `brainlink_inbox_process`: suggest titles, tags and links for inbox items.
@@ -563,6 +563,7 @@ Available tools:
 - `brainlink_vault_provision`: create a private GitHub repository for the vault with the authenticated `gh` CLI, wire it as `origin`, push the first snapshot, and enable `autoVersion` so later indexed changes are committed and pushed automatically. By default the repository is **encrypted** (`vaultEncryption`): it holds AES-256-GCM ciphertext, decryptable only by a Brainlink instance with the local key.
 - `brainlink_vault_status` / `brainlink_vault_init` / `brainlink_vault_commit` / `brainlink_vault_history` / `brainlink_vault_pull` / `brainlink_vault_restore`: version the vault's canonical Markdown with git (the derived index is git-ignored). Pull and restore reindex changed files automatically so the vault stays immediately searchable.
 - `brainlink_vault_export` / `brainlink_vault_import`: write and read a portable `.blvault` snapshot (gzip envelope of the Markdown with per-file SHA-256). Import verifies checksums, preserves divergent local files as `*.conflict-<ts>.md`, and reindexes.
+- `brainlink_vault_merge_agents`: losslessly merge one agent namespace into another within the same vault (e.g. `claude-code` → `shared`). Identical notes are skipped, colliding slugs with different content are kept under a `-from-<agent>` name, everything else is moved, and merged notes are aggregated into domain `<context> Hub` notes. Source notes are kept unless `deleteSource` is set; `dryRun` previews the plan.
 - `brainlink_graph`: read indexed graph nodes and weighted links.
 - `brainlink_graph_contexts`: list the visual graph contexts used by the local server.
 - `brainlink_broken_links`: list unresolved wiki links.
@@ -1184,7 +1185,7 @@ If no `vault` is configured and no `--vault` flag is passed, Brainlink uses `$HO
 }
 ```
 
-`defaultAgent` is optional. When set, CLI and MCP calls that omit `--agent`/`agent` use this value automatically. If not set, behavior remains as before.
+`defaultAgent` defaults to `shared`, so every agent (Claude, Codex, GPT, …) reads and writes the same shared namespace and sees each other's memory unless a call passes an explicit `--agent`/`agent`. Set it to another id to make a different namespace the default, or pass `--agent` per call to scope to a private namespace.
 `agentProfiles` is optional. When present, CLI and MCP resolve `mode`, `limit`, `tokens` and context `strategy` per agent automatically, then fallback to global defaults.
 
 `autoIndexOnWrite` is optional and defaults to `true`. Set it to `false` to defer indexing after writes.
@@ -1455,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/add-note.js

@@ -29,9 +29,12 @@ export const addNoteWithMetadata = async (vaultPath, title, content, agentId = s
     const sanitizedAgentId = sanitizeAgentId(agentId);
     const filename = `agents/${sanitizedAgentId}/${slugify(title) || 'untitled'}.md`;
     await ensureVault(vaultPath);
-    const canonical = options.autoContextLinks === false
+    const contextOverride = options.context?.trim() || undefined;
+    // An explicit context always partitions the note, even when auto context links
+    // are otherwise disabled; without an override, honor the auto-link setting.
+    const canonical = options.autoContextLinks === false && !contextOverride
         ? null
-        : addCanonicalContextLinkToContent(title, content.trim(), await loadVisualContextRules(vaultPath), filename);
+        : addCanonicalContextLinkToContent(title, content.trim(), await loadVisualContextRules(vaultPath), filename, contextOverride);
     const hub = canonical?.changed
         ? await ensureCanonicalContextHub(vaultPath, canonical.context, sanitizedAgentId)
         : null;

package/dist/application/canonical-context-links.js

@@ -228,15 +228,19 @@ export const canonicalizeContextLinks = async (vaultPath, options = {}) => {
         entries
     };
 };
-export const addCanonicalContextLinkToContent = (title, content, rules = [], notePath = '') => {
-    const context = inferVisualGraphContext({
-        id: '',
-        agentId: sharedAgentId,
-        title,
-        path: notePath,
-        content,
-        tags: [],
-    }, rules);
+// When an explicit context is provided by the caller, it overrides inference so
+// a note lands in that domain hub instead of the generic per-namespace fallback
+// (which collapses every agent note into a single "Agent Memory" context). An
+// empty/whitespace override is ignored, preserving inference.
+const resolveContextTitle = (contextOverride, title, content, notePath, rules) => {
+    const explicit = contextOverride?.trim();
+    if (explicit) {
+        return explicit;
+    }
+    return inferVisualGraphContext({ id: '', agentId: sharedAgentId, title, path: notePath, content, tags: [] }, rules).title;
+};
+export const addCanonicalContextLinkToContent = (title, content, rules = [], notePath = '', contextOverride) => {
+    const context = { title: resolveContextTitle(contextOverride, title, content, notePath, rules) };
     const hubTitle = hubTitleForContext(context.title);
     const nextContent = normalizeTitle(title) === normalizeTitle(hubTitle) ? content : upsertCanonicalContextLink(content, hubTitle);
     return {

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/dist/application/merge-agent-namespace.js

@@ -0,0 +1,130 @@
+import { readFile } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { sanitizeAgentId } from '../domain/agents.js';
+import { canonicalizeContextLinks } from './canonical-context-links.js';
+import { indexVault } from './index-vault.js';
+import { deleteMarkdownFile, ensureVault, readMarkdownFileSummaries, writeMarkdownFile } from '../infrastructure/file-system-vault.js';
+const toPosix = (value) => value.replaceAll('\\', '/');
+const namespacePrefix = (agentId) => `agents/${agentId}/`;
+// Content hash used only to detect exact duplicates during merge, so identical
+// notes collapse instead of producing a redundant "-from-<agent>" copy.
+const contentHash = (content) => createHash('sha256').update(content.replace(/\s+/g, ' ').trim()).digest('hex');
+// Rewrite the `agent:` value inside the leading frontmatter block so a moved
+// note reports the target namespace. Body content is left untouched.
+const rewriteAgentFrontmatter = (content, targetAgent) => {
+    const match = content.match(/^(---\r?\n)([\s\S]*?)(\r?\n---)/);
+    if (!match) {
+        return content;
+    }
+    const [, open, body, close] = match;
+    const rewrittenBody = /^agent\s*:/im.test(body)
+        ? body.replace(/^agent\s*:.*$/im, `agent: "${targetAgent}"`)
+        : `${body}\nagent: "${targetAgent}"`;
+    return `${open}${rewrittenBody}${close}${content.slice(match[0].length)}`;
+};
+const withSuffix = (relativePath, suffix) => relativePath.replace(/\.md$/i, `-${suffix}.md`);
+// Pick a target path that does not clobber an existing note. Same slug + same
+// content is treated by the caller as a no-op; same slug + different content is
+// disambiguated so no data is ever lost.
+const resolveTargetPath = (desiredPath, sourceAgent, taken) => {
+    if (!taken.has(desiredPath)) {
+        return desiredPath;
+    }
+    const primary = withSuffix(desiredPath, `from-${sourceAgent}`);
+    if (!taken.has(primary)) {
+        return primary;
+    }
+    for (let counter = 2;; counter += 1) {
+        const candidate = withSuffix(desiredPath, `from-${sourceAgent}-${counter}`);
+        if (!taken.has(candidate)) {
+            return candidate;
+        }
+    }
+};
+// Merge one agent namespace into another within the same vault, losslessly:
+// identical notes are skipped, colliding slugs with different content are
+// renamed, everything else is moved, and the merged set is aggregated into
+// domain hubs. Source notes are kept unless deleteSource is set.
+export const mergeAgentNamespace = async (vaultPath, options) => {
+    const sourceAgent = sanitizeAgentId(options.sourceAgent);
+    const targetAgent = sanitizeAgentId(options.targetAgent);
+    if (sourceAgent === targetAgent) {
+        throw new Error(`Cannot merge agent namespace "${sourceAgent}" into itself.`);
+    }
+    const absoluteVaultPath = await ensureVault(vaultPath);
+    const dryRun = options.dryRun === true;
+    const deleteSource = options.deleteSource === true;
+    const linkContexts = options.linkContexts !== false;
+    const summaries = await readMarkdownFileSummaries(absoluteVaultPath);
+    const sourcePrefix = namespacePrefix(sourceAgent);
+    const targetPrefix = namespacePrefix(targetAgent);
+    const sourceNotes = summaries.filter((summary) => toPosix(summary.relativePath).startsWith(sourcePrefix));
+    const taken = new Set(summaries.map((summary) => toPosix(summary.relativePath)));
+    const targetContentHashes = new Set();
+    await Promise.all(summaries
+        .filter((summary) => toPosix(summary.relativePath).startsWith(targetPrefix))
+        .map(async (summary) => {
+        targetContentHashes.add(contentHash(await readFile(summary.absolutePath, 'utf8')));
+    }));
+    const entries = [];
+    let moved = 0;
+    let identicalSkipped = 0;
+    let renamedCollisions = 0;
+    let deletedSource = 0;
+    for (const note of sourceNotes) {
+        const sourceRelative = toPosix(note.relativePath);
+        const raw = await readFile(note.absolutePath, 'utf8');
+        const rewritten = rewriteAgentFrontmatter(raw, targetAgent);
+        const desiredPath = targetPrefix + sourceRelative.slice(sourcePrefix.length);
+        // Exact duplicate already in the target: nothing to write, no data lost.
+        if (targetContentHashes.has(contentHash(rewritten))) {
+            identicalSkipped += 1;
+            entries.push({ sourcePath: sourceRelative, targetPath: desiredPath, action: 'identical-skipped' });
+            if (deleteSource && !dryRun) {
+                await deleteMarkdownFile(absoluteVaultPath, sourceRelative);
+                deletedSource += 1;
+            }
+            continue;
+        }
+        const targetPath = resolveTargetPath(desiredPath, sourceAgent, taken);
+        const isCollision = targetPath !== desiredPath;
+        taken.add(targetPath);
+        targetContentHashes.add(contentHash(rewritten));
+        if (!dryRun) {
+            await writeMarkdownFile(absoluteVaultPath, targetPath, rewritten);
+            if (deleteSource) {
+                await deleteMarkdownFile(absoluteVaultPath, sourceRelative);
+                deletedSource += 1;
+            }
+        }
+        if (isCollision) {
+            renamedCollisions += 1;
+            entries.push({ sourcePath: sourceRelative, targetPath, action: 'renamed-collision' });
+        }
+        else {
+            moved += 1;
+            entries.push({ sourcePath: sourceRelative, targetPath, action: 'moved' });
+        }
+    }
+    // Aggregate the merged notes into domain hubs so they partition by context
+    // instead of piling into a single namespace blob.
+    const contextLinks = linkContexts && !dryRun
+        ? await canonicalizeContextLinks(absoluteVaultPath, { agentId: targetAgent, createMissingHubs: true })
+        : null;
+    if (!dryRun && options.autoIndex !== false) {
+        await indexVault(absoluteVaultPath);
+    }
+    return {
+        sourceAgent,
+        targetAgent,
+        dryRun,
+        scanned: sourceNotes.length,
+        moved,
+        identicalSkipped,
+        renamedCollisions,
+        deletedSource,
+        contextLinksAdded: contextLinks?.changed ?? 0,
+        hubsCreated: contextLinks?.createdHubs ?? 0,
+        entries
+    };
+};

package/dist/cli/commands/vault-commands.js

@@ -1,6 +1,7 @@
 import { readdir, readFile, rm, stat } from 'node:fs/promises';
 import { extname, isAbsolute, join } from 'node:path';
 import { doctorVault } from '../../application/analyze-vault.js';
+import { mergeAgentNamespace } from '../../application/merge-agent-namespace.js';
 import { defaultBrainlinkConfig, loadBrainlinkConfig, loadRawConfig, writeRawConfig } from '../../infrastructure/config.js';
 import { assertVaultAllowed, isBucketVaultPath, resolveVaultPath } from '../../infrastructure/file-system-vault.js';
 import { print } from '../runtime.js';
@@ -144,6 +145,30 @@ export const registerVaultCommands = (program) => {
             doctor
         }, () => `Default ${scope} vault set to ${targetVault} in ${configPath}.`);
     });
+    vaultsCommand
+        .command('merge-agents <source> <target>')
+        .option('--vault <vault>', 'vault to operate on (defaults to the configured vault)')
+        .option('--delete-source', 'remove each source note after it is safely present in the target')
+        .option('--no-link-contexts', 'skip aggregating merged notes into domain hubs')
+        .option('--dry-run', 'preview the merge plan without writing anything')
+        .option('--json', 'print machine-readable JSON')
+        .description('losslessly merge one agent namespace into another within a vault')
+        .action(async (source, target, options) => {
+        const config = await loadBrainlinkConfig();
+        const vault = options.vault ? normalizeVaultPath(options.vault) : config.vault;
+        const result = await mergeAgentNamespace(vault, {
+            sourceAgent: source,
+            targetAgent: target,
+            deleteSource: options.deleteSource === true,
+            linkContexts: options.linkContexts !== false,
+            dryRun: options.dryRun === true
+        });
+        print(options.json, { vault, ...result }, () => [
+            `${result.dryRun ? 'Planned merge' : 'Merged'} ${result.sourceAgent} → ${result.targetAgent} in ${vault}`,
+            `scanned=${result.scanned} moved=${result.moved} identical-skipped=${result.identicalSkipped} renamed-collisions=${result.renamedCollisions}`,
+            `deleted-source=${result.deletedSource} hubs-created=${result.hubsCreated} context-links-added=${result.contextLinksAdded}`
+        ].join('\n'));
+    });
     vaultsCommand
         .command('delete <vault>')
         .option('--yes', 'confirm destructive vault deletion')

package/dist/infrastructure/config.js

@@ -1,14 +1,18 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join, resolve } from 'node:path';
 import { homedir } from 'node:os';
-import { sanitizeAgentId } from '../domain/agents.js';
+import { sanitizeAgentId, sharedAgentId } from '../domain/agents.js';
 import { getBrainlinkHomePath, getDefaultVaultPath } from './paths.js';
 export const defaultBrainlinkConfig = {
     vault: getDefaultVaultPath(),
     host: '127.0.0.1',
     port: 4321,
     allowedVaults: [],
-    defaultAgent: undefined,
+    // Default every agent (Claude, Codex, GPT, …) to the shared namespace so they
+    // all read and write the same memory and see each other's context. Set an
+    // explicit `agent` per call, or override defaultAgent in config, to scope to a
+    // private namespace.
+    defaultAgent: sharedAgentId,
     autoIndexOnWrite: true,
     autoCanonicalContextLinks: true,
     autoVersion: false,

package/dist/mcp/server-instructions.js

@@ -15,8 +15,17 @@ Use the full potential, not shallow retrieval. Extract the maximum relevant cont
 - Explainability and quality: brainlink_explain (chunk/score), brainlink_recommendations, brainlink_validate, brainlink_stats, plus link/orphan/duplicate hygiene.
 - Volatile turn memory: brainlink_volatile_add to stash useful within-session facts (they expire on a TTL); brainlink_volatile_clear to drop them.
 
+Consult before you act. Before any decision, recommendation, question to the user, or implementation, ground yourself in Brainlink first — never act from memory alone when durable context may exist. This is not optional politeness; it is how you stay coherent across turns and sessions.
+
 Write back — after any durable learning (a preference, decision, pattern, or a change to a repo/config/doc that alters operating context):
 - Persist it with brainlink_remember (or brainlink_add_note for explicit path/content). Write connected memory: include [[wiki links]], tags, and priority markers so the graph stays navigable — not loose notes.
+- Partition by domain: pass a "context" (e.g. "RSHUB", "Brainlink", "Trading") on every write. Brainlink links the note to that domain's "<context> Hub" (creating it if missing) so the knowledge graph stays split into navigable domains instead of collapsing into one undifferentiated blob. Writing without a context is a degraded mode — always name the domain.
 - Reindex with brainlink_index and validate with brainlink_validate after writes when applicable.
 
-Capture context early and proactively rather than reconstructing it later. When durability is uncertain but the reuse cost is low, capture anyway; use volatile memory for what is ephemeral. Anchoring everything you learn in Brainlink is what preserves your continuity between turns and sessions.`;
+Persistent and volatile memory — use both, like a real brain:
+- Persistent: durable Markdown notes for anything worth remembering across sessions (decisions, preferences, project maps, runbooks, recurring gotchas).
+- Volatile: brainlink_volatile_add for within-session working state — current task, hypotheses, unconfirmed findings, transient preferences. It expires on a TTL; clear it with brainlink_volatile_clear when done. Prefer volatile for the ephemeral so persistent memory stays signal-rich.
+
+Shared by default: unless told otherwise, all agents (Claude, Codex, GPT, …) share one namespace ("shared") and one vault, so memory written by any of them is visible to all. Do not silo context into a private namespace without a clear reason — the point is one continuous brain across every agent and session.
+
+Capture context early and proactively rather than reconstructing it later. When durability is uncertain but the reuse cost is low, capture anyway; use volatile memory for what is ephemeral. Anchoring everything you learn in Brainlink — connected, partitioned by domain, and shared — is what preserves your continuity between turns, sessions and agents.`;

package/dist/mcp/server.js

@@ -1,5 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { addNoteInputSchema, addFileInputSchema, addFileTool, addNoteTool, addNotesInputSchema, addNotesTool, deleteNoteInputSchema, deleteNoteTool, deleteNotesInputSchema, deleteNotesTool, volatileAddInputSchema, volatileAddTool, volatileClearInputSchema, volatileClearTool, dedupeInputSchema, dedupeResolveInputSchema, dedupeResolveTool, dedupeTool, brokenLinksInputSchema, brokenLinksTool, bootstrapInputSchema, bootstrapTool, canonicalizeContextLinksInputSchema, canonicalizeContextLinksTool, contextInputSchema, contextPacksInputSchema, contextPacksTool, contextTool, doctorActionsInputSchema, doctorActionsTool, graphContextsInputSchema, graphContextsTool, graphInputSchema, graphTool, explainInputSchema, explainTool, indexInputSchema, indexTool, inboxAddInputSchema, inboxAddTool, inboxListInputSchema, inboxListTool, inboxProcessInputSchema, inboxProcessTool, orphansInputSchema, orphansTool, policyInputSchema, policyTool, projectInitInputSchema, projectInitTool, recommendationsInputSchema, recommendationsTool, rememberInputSchema, rememberTool, repairLinksInputSchema, repairLinksTool, searchInputSchema, searchTool, similarNotesInputSchema, similarNotesTool, sessionCloseInputSchema, sessionCloseTool, statsInputSchema, statsTool, suggestLinksInputSchema, suggestLinksTool, syncInputSchema, syncTool, validateInputSchema, validateTool, vaultCommitInputSchema, vaultCommitTool, vaultExportInputSchema, vaultExportTool, vaultHistoryInputSchema, vaultHistoryTool, vaultImportInputSchema, vaultImportTool, vaultInitInputSchema, vaultInitTool, vaultProvisionInputSchema, vaultProvisionTool, vaultPullInputSchema, vaultPullTool, vaultRestoreInputSchema, vaultRestoreTool, vaultStatusInputSchema, vaultStatusTool, versionInputSchema, versionTool } from './tools.js';
+import { addNoteInputSchema, addFileInputSchema, addFileTool, addNoteTool, addNotesInputSchema, addNotesTool, deleteNoteInputSchema, deleteNoteTool, deleteNotesInputSchema, deleteNotesTool, volatileAddInputSchema, volatileAddTool, volatileClearInputSchema, volatileClearTool, dedupeInputSchema, dedupeResolveInputSchema, dedupeResolveTool, dedupeTool, brokenLinksInputSchema, brokenLinksTool, bootstrapInputSchema, bootstrapTool, canonicalizeContextLinksInputSchema, canonicalizeContextLinksTool, contextInputSchema, contextPacksInputSchema, contextPacksTool, contextTool, doctorActionsInputSchema, doctorActionsTool, graphContextsInputSchema, graphContextsTool, graphInputSchema, graphTool, explainInputSchema, explainTool, indexInputSchema, indexTool, inboxAddInputSchema, inboxAddTool, inboxListInputSchema, inboxListTool, inboxProcessInputSchema, inboxProcessTool, orphansInputSchema, orphansTool, policyInputSchema, policyTool, projectInitInputSchema, projectInitTool, recommendationsInputSchema, recommendationsTool, rememberInputSchema, rememberTool, repairLinksInputSchema, repairLinksTool, searchInputSchema, searchTool, similarNotesInputSchema, similarNotesTool, sessionCloseInputSchema, sessionCloseTool, statsInputSchema, statsTool, suggestLinksInputSchema, suggestLinksTool, syncInputSchema, syncTool, validateInputSchema, validateTool, vaultCommitInputSchema, vaultCommitTool, vaultExportInputSchema, vaultExportTool, vaultHistoryInputSchema, vaultHistoryTool, vaultImportInputSchema, vaultImportTool, vaultInitInputSchema, vaultInitTool, vaultMergeAgentsInputSchema, vaultMergeAgentsTool, vaultProvisionInputSchema, vaultProvisionTool, vaultPullInputSchema, vaultPullTool, vaultRestoreInputSchema, vaultRestoreTool, vaultStatusInputSchema, vaultStatusTool, versionInputSchema, versionTool } from './tools.js';
 import { getRuntimeVersion } from './runtime.js';
 import { brainlinkServerInstructions } from './server-instructions.js';
 import { guardToolHandler } from './tool-guard.js';
@@ -171,6 +171,11 @@ export const createBrainlinkMcpServer = () => {
         description: 'Create a private GitHub repository for the vault with the authenticated gh CLI, wire it as origin, push the first snapshot, and enable autoVersion so later indexed changes are committed and pushed automatically. Only Markdown is versioned.',
         inputSchema: vaultProvisionInputSchema
     }, vaultProvisionTool);
+    server.registerTool('brainlink_vault_merge_agents', {
+        title: 'Merge Agent Namespaces',
+        description: 'Losslessly merge one agent namespace into another within the same vault (e.g. claude-code → shared): identical notes are skipped, colliding slugs with different content are kept under a "-from-<agent>" name, everything else is moved, and merged notes are aggregated into domain "<context> Hub" notes. Source notes are kept unless deleteSource is set. Use dryRun to preview.',
+        inputSchema: vaultMergeAgentsInputSchema
+    }, vaultMergeAgentsTool);
     server.registerTool('brainlink_vault_commit', {
         title: 'Commit Vault Markdown',
         description: 'Stage and commit the canonical Markdown (and .gitignore), optionally pushing to origin. Returns null commit when there is nothing to commit.',

package/dist/mcp/tools/vault-tools.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { commitVault, initVaultGit, pullVault, pushVault, restoreVault, vaultGitStatus, vaultHistory } from '../../application/vault-git.js';
 import { provisionVaultRepo } from '../../application/provision-vault.js';
 import { exportVaultSnapshot, importVaultSnapshot } from '../../application/vault-snapshot.js';
+import { mergeAgentNamespace } from '../../application/merge-agent-namespace.js';
 import { jsonResult, optionalPositiveInteger, resolveExecutionContext, vaultInput } from './shared.js';
 export const vaultStatusInputSchema = { ...vaultInput };
 export const vaultInitInputSchema = {
@@ -45,6 +46,23 @@ export const vaultProvisionInputSchema = {
     encrypt: z.boolean().optional().default(true).describe('Encrypt the versioned vault: commit AES-256-GCM ciphertext and git-ignore plaintext Markdown. Only a Brainlink instance holding the local key can decrypt.'),
     message: z.string().min(1).optional().describe('Initial commit message.')
 };
+export const vaultMergeAgentsInputSchema = {
+    ...vaultInput,
+    sourceAgent: z.string().min(1).describe('Agent namespace to merge FROM (e.g. "claude-code").'),
+    targetAgent: z.string().min(1).describe('Agent namespace to merge INTO (e.g. "shared").'),
+    deleteSource: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Remove each source note after it is safely present in the target. Defaults to false (non-destructive copy).'),
+    linkContexts: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Aggregate merged notes into domain "<context> Hub" notes after moving. Defaults to true.'),
+    dryRun: z.boolean().optional().default(false).describe('Preview the merge plan without writing anything.'),
+    autoIndex: z.boolean().optional().default(true).describe('Reindex the vault once after the merge.')
+};
 // Vault versioning shells out to the `git` binary and touches the filesystem, so
 // a missing binary or a git failure is surfaced as an actionable result rather
 // than an unhandled exception.
@@ -145,6 +163,23 @@ export const vaultImportTool = async (input) => {
         return failure(context.vault, error);
     }
 };
+export const vaultMergeAgentsTool = async (input) => {
+    const context = await resolveExecutionContext(input);
+    try {
+        const result = await mergeAgentNamespace(context.vault, {
+            sourceAgent: input.sourceAgent,
+            targetAgent: input.targetAgent,
+            deleteSource: input.deleteSource,
+            linkContexts: input.linkContexts,
+            dryRun: input.dryRun,
+            autoIndex: input.autoIndex
+        });
+        return jsonResult({ vault: context.vault, ok: true, ...result });
+    }
+    catch (error) {
+        return failure(context.vault, error);
+    }
+};
 export const vaultProvisionTool = async (input) => {
     const context = await resolveExecutionContext(input);
     try {

package/dist/mcp/tools/write-tools.js

@@ -16,6 +16,11 @@ export const addNoteInputSchema = {
         .min(1)
         .describe('Durable Markdown memory. Include explicit [[wiki links]] and #tags when the memory should be connected. Put priority markers near important links, for example priority: high, #important or #critical.'),
     ...agentInput,
+    context: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Domain context this memory belongs to (e.g. "RSHUB", "Brainlink", "Trading"). Strongly recommended: it partitions the note under a "<context> Hub" so the knowledge graph stays split by domain instead of collapsing into one blob. The hub is created automatically if missing.'),
     allowSensitive: z.boolean().optional().default(false).describe('Allow content that looks like a secret.'),
     autoIndex: z.boolean().optional().default(true).describe('Reindex vault after writing note.'),
     autoContextLinks: z
@@ -28,6 +33,11 @@ export const rememberInputSchema = {
     ...agentInput,
     title: z.string().min(1).optional().describe('Optional note title. When omitted, Brainlink infers it from content.'),
     content: z.string().min(1).describe('Memory content to capture as a durable Markdown note.'),
+    context: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Domain context this memory belongs to (e.g. "RSHUB", "Brainlink", "Trading"). Strongly recommended: it partitions the note under a "<context> Hub" so the knowledge graph stays split by domain. The hub is created automatically if missing.'),
     tags: z.array(z.string()).optional().default([]).describe('Extra tags to include.'),
     links: z.array(z.string()).optional().default([]).describe('Explicit Context Links to include.'),
     linkLimit: positiveInteger(5).describe('Maximum suggested Context Links to include.'),
@@ -65,11 +75,21 @@ export const addNotesInputSchema = {
     notes: z
         .array(z.object({
         title: z.string().min(1).describe('Markdown note title.'),
-        content: z.string().min(1).describe('Durable Markdown memory. Include [[wiki links]] and #tags to connect it.')
+        content: z.string().min(1).describe('Durable Markdown memory. Include [[wiki links]] and #tags to connect it.'),
+        context: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Per-note domain context override. Falls back to the batch-level context when omitted.')
     }))
         .min(1)
         .max(100)
         .describe('Notes to add in a single batch. The vault is reindexed once after all notes are written.'),
+    context: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Default domain context applied to every note in the batch (partitions them under a "<context> Hub"). Per-note context overrides it. Strongly recommended.'),
     allowSensitive: z.boolean().optional().default(false).describe('Allow content that looks like a secret.'),
     autoIndex: z.boolean().optional().default(true).describe('Reindex vault once after writing all notes.'),
     autoContextLinks: z
@@ -118,7 +138,8 @@ export const addNoteTool = async (input) => {
     const shouldIndex = isTruthy(input.autoIndex);
     const added = await addNoteWithMetadata(context.vault, input.title, input.content, context.agent, {
         allowSensitive: input.allowSensitive,
-        autoContextLinks: input.autoContextLinks ?? context.config.autoCanonicalContextLinks
+        autoContextLinks: input.autoContextLinks ?? context.config.autoCanonicalContextLinks,
+        context: input.context
     });
     const index = shouldIndex ? await indexVault(context.vault) : undefined;
     const focusPath = added.path.includes('agents/') ? added.path.slice(added.path.indexOf('agents/')).replaceAll('\\', '/') : undefined;
@@ -166,7 +187,10 @@ export const rememberTool = async (input) => {
     }
     const added = await addNoteWithMetadata(context.vault, suggestion.title, suggestion.content, context.agent, {
         allowSensitive: input.allowSensitive,
-        autoContextLinks: false
+        // remember already curates its own Context Links; only force a canonical hub
+        // link when the caller pins an explicit domain context to partition it.
+        autoContextLinks: false,
+        context: input.context
     });
     const index = input.autoIndex ? await indexVault(context.vault) : undefined;
     return jsonResult({
@@ -175,6 +199,13 @@ export const rememberTool = async (input) => {
         agent: context.agent,
         suggestion,
         path: added.path,
+        writeConnectivity: {
+            autoLinked: added.autoLinked,
+            linkTarget: added.linkTarget,
+            context: added.context,
+            hubCreated: added.hubCreated,
+            guaranteedEdge: added.autoLinked
+        },
         ...(index ? { index } : {})
     });
 };
@@ -239,7 +270,8 @@ export const addNotesTool = async (input) => {
         try {
             const added = await addNoteWithMetadata(context.vault, note.title, note.content, context.agent, {
                 allowSensitive: input.allowSensitive,
-                autoContextLinks
+                autoContextLinks,
+                context: note.context ?? input.context
             });
             notes.push({
                 ok: true,

package/dist/mcp/tools.js

@@ -1,4 +1,4 @@
 export { brokenLinksInputSchema, brokenLinksTool, contextInputSchema, contextPacksInputSchema, contextPacksTool, contextTool, doctorActionsInputSchema, doctorActionsTool, explainInputSchema, explainTool, graphContextsInputSchema, graphContextsTool, graphInputSchema, graphTool, orphansInputSchema, orphansTool, recommendationsInputSchema, recommendationsTool, searchInputSchema, searchTool, similarNotesInputSchema, similarNotesTool, statsInputSchema, statsTool, suggestLinksInputSchema, suggestLinksTool, validateInputSchema, validateTool, versionInputSchema, versionTool } from './tools/read-tools.js';
 export { addFileInputSchema, addFileTool, addNoteInputSchema, addNoteTool, addNotesInputSchema, addNotesTool, deleteNoteInputSchema, deleteNoteTool, deleteNotesInputSchema, deleteNotesTool, inboxAddInputSchema, inboxAddTool, inboxListInputSchema, inboxListTool, inboxProcessInputSchema, inboxProcessTool, rememberInputSchema, rememberTool, volatileAddInputSchema, volatileAddTool, volatileClearInputSchema, volatileClearTool } from './tools/write-tools.js';
 export { bootstrapInputSchema, bootstrapTool, canonicalizeContextLinksInputSchema, canonicalizeContextLinksTool, dedupeInputSchema, dedupeResolveInputSchema, dedupeResolveTool, dedupeTool, indexInputSchema, indexTool, policyInputSchema, policyTool, projectInitInputSchema, projectInitTool, repairLinksInputSchema, repairLinksTool, sessionCloseInputSchema, sessionCloseTool, syncInputSchema, syncTool } from './tools/maintenance-tools.js';
-export { vaultCommitInputSchema, vaultCommitTool, vaultExportInputSchema, vaultExportTool, vaultHistoryInputSchema, vaultHistoryTool, vaultImportInputSchema, vaultImportTool, vaultInitInputSchema, vaultInitTool, vaultProvisionInputSchema, vaultProvisionTool, vaultPullInputSchema, vaultPullTool, vaultRestoreInputSchema, vaultRestoreTool, vaultStatusInputSchema, vaultStatusTool } from './tools/vault-tools.js';
+export { vaultCommitInputSchema, vaultCommitTool, vaultExportInputSchema, vaultExportTool, vaultHistoryInputSchema, vaultHistoryTool, vaultImportInputSchema, vaultImportTool, vaultInitInputSchema, vaultInitTool, vaultMergeAgentsInputSchema, vaultMergeAgentsTool, vaultProvisionInputSchema, vaultProvisionTool, vaultPullInputSchema, vaultPullTool, vaultRestoreInputSchema, vaultRestoreTool, vaultStatusInputSchema, vaultStatusTool } from './tools/vault-tools.js';

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@andespindola/brainlink",
-  "version": "1.3.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",