@andespindola/brainlink 1.11.0 → 1.11.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.11.0
+
+- **Traverse the wiki-link graph by depth (`brainlink_neighbors`).** A new MCP tool and `brainlink neighbors` CLI command walk the wiki-link graph outward from a root note — selected by `title` or `path` — up to a given `depth` (hops), returning every reached node annotated with its hop distance plus the edges induced between them. Traversal is undirected (a note is a neighbor whether it links out or is linked from), expands the strongest links first (by `weight`, with `priority` as a tie-breaker), skips unresolved edges, and caps the result at `limit` nodes (default 50) reporting `truncated` when it stops early. This fills the gap between `brainlink_graph` (the whole graph) and `brainlink_similar_notes` (semantic neighbors) for agents that only need the local neighborhood of a note. The traversal core is a pure, fully tested domain function; the existing graph tool and CLI command are unchanged.
+
+## 1.10.1
+
+- **"Brainlink vs Obsidian" section in the README.** Documentation patch clarifying that Brainlink and Obsidian are different tools, plus a version bump. (This release also recovered a prior publish that had collided with an already-published 1.10.0.)
+
+## 1.10.0
+
+- **Transfer a whole vault between two Brainlinks over MCP.** New `brainlink_vault_transfer_export` returns the vault as an encrypted, base64 payload with no file on disk, and `brainlink_vault_transfer_import` applies that payload on the target and reindexes. An agent connected to both servers moves the vault directly through its context. A shared `passphrase` (min 8 chars) is mandatory since the payload travels through the agent's context. Reuses the 1.9.0 encrypted-snapshot core, with the same checksum verification and `*.conflict-<ts>.md` preservation as snapshot import.
+
+## 1.9.0
+
+- **Mask stored secrets at read surfaces, encrypt snapshots, harden pack permissions.** Secrets can be stored in the vault (a canonical secret store) and are masked at user-facing read surfaces (CLI + graph web UI), while MCP agents still receive the unmasked values they need. Portable `.blvault`/`.blbundle` exports are encrypted with AES-256-GCM when a passphrase (or `BRAINLINK_VAULT_KEY`) is available — import stays backward-compatible, with new `--passphrase` / `--no-encrypt` CLI flags and MCP `passphrase`/`encrypt` params. Context packs are written owner-only (`0o700`/`0o600`). The embedding provider default remains `local`, so no content leaves the machine unless configured.
+
 ## 1.8.2
 
 - **Connect page AGENTS.md now instructs proactive capture.** The ready operating contract on the `/connect` page changed its "After you learn" guidance from only writing back "durable learnings" to capturing proactively — decisions and their rationale, project maps/paths, conventions, runbooks, recent state, and recurring pitfalls; when in doubt, capture (using volatile memory only for the truly ephemeral), then reindex. So agents wired to a brainlink persist everything worth reusing, not just occasional highlights.

package/dist/application/frontend/connect-page.js

@@ -41,6 +41,22 @@ it as the continuity of your cognition, not an optional lookup.
 - Retrieve with \`strategy: "auto"\` (CAG on a fresh pack, RAG otherwise) and
   \`mode: "hybrid"\` (FTS + semantic) unless a narrower mode clearly fits.
 
+## Honor the user's preferences context above all
+- Brainlink keeps a dedicated context capturing the user's own preferences.
+  Treat it as the highest authority: whenever it is retrieved, obey it above any
+  other guidance — other notes, defaults, project context, or your own
+  heuristics. On any conflict, the user's stated preference wins; only a hard
+  environment rule or a real security/destructive risk overrides it.
+
+## Use the full toolset — every method, at its best
+- Do not stop at search. Use every Brainlink resource and method to its full
+  potential, picking the right tool for each need: bootstrap and
+  context/context-packs for grounding; search/explain/graph/neighbors for
+  retrieval and relations; remember/add_note/add_file and volatile memory for
+  writing; index/sync/validate/dedupe/repair-links plus broken-links and orphans
+  for upkeep; inbox and session tools for flow. Shallow retrieval that ignores
+  the graph, packs, and maintenance is underusing the brain.
+
 ## Capture proactively — save everything worth reusing
 - Do not wait for an explicit "durable learning". After anything worth reusing,
   write it back: decisions and their rationale, project maps and paths,

package/dist/mcp/server-instructions.js

@@ -11,7 +11,7 @@ Load context first — every session and whenever context is stale:
 Use the full potential, not shallow retrieval. Extract the maximum relevant context available before acting:
 - Both retrieval modes: RAG (fresh on-demand assembly) AND CAG (reuse of still-fresh context packs). Prefer strategy "auto" (CAG on a fresh-pack hit, RAG otherwise); force "rag"/"cag" only with a clear reason. Inspect prebuilt packs with brainlink_context_packs.
 - Hybrid search (mode "hybrid" = FTS + semantic) by default; use pure "fts"/"semantic" only when it clearly fits.
-- The knowledge graph: brainlink_graph, brainlink_graph_contexts and context packs to navigate relations between notes and contexts.
+- The knowledge graph: brainlink_graph, brainlink_graph_contexts and context packs to navigate relations between notes and contexts. Use brainlink_neighbors to walk outward from one note by depth (N hops) — selected by title or path — when you only need its local neighborhood instead of the whole graph.
 - 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.
 

package/package.json

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