npm - @andespindola/brainlink - Versions diffs - 0.1.0-beta.35 → 0.1.0-beta.37 - Mend

@andespindola/brainlink 0.1.0-beta.35 → 0.1.0-beta.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md +3 -0
package/COPYRIGHT.md +1 -1
package/README.md +3 -1
package/dist/application/frontend/client-html.js +2 -2
package/dist/application/frontend/client-js.js +41 -2
package/dist/cli/commands/write-commands.js +111 -26
package/docs/AGENT_USAGE.md +2 -0
package/package.json +2 -2

package/CHANGELOG.md CHANGED Viewed

@@ -27,6 +27,9 @@
 - Improved graph UI auto-fit and viewport recovery so loaded nodes are re-centered when zoom/pan drifts to empty canvas.
 - Added cross-platform native desktop GUI auto-open for `blink server` (macOS Swift/WebKit, Windows PowerShell WinForms, Linux Python GTK/WebKit2), with app-window/browser fallback.
 - Changed Linux default UI launch to app-window/browser for lighter startup; Linux native GUI is now opt-in via `BRAINLINK_LINUX_NATIVE_GUI=1`.
+- Added native GUI parent-process monitoring so GUI windows close automatically when `blink server` stops.
+- Improved non-mac browser detection fallback to try installed Edge/Chrome/Firefox/Chromium candidates before system default open.
+- Improved graph filter rendering to keep hub anchor nodes visible (`Memory Hub`/`MOC`/high-degree fallback) for coherent relationship context.
 ## 0.1.0-beta.3

package/COPYRIGHT.md CHANGED Viewed

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

package/README.md CHANGED Viewed

@@ -561,6 +561,7 @@ By default, `blink server` tries to open the graph in a native desktop GUI windo
 On Linux, native GUI is disabled by default for better startup performance. Enable it with `BRAINLINK_LINUX_NATIVE_GUI=1`.
 If native GUI launch is unavailable on your system, it falls back to dedicated app-window mode and then to the default browser.
 Use `--no-open` to keep it headless.
+When native GUI is used, the GUI window automatically closes when the `blink server` process stops.
 The graph UI shows:
@@ -570,6 +571,7 @@ The graph UI shows:
 - neutral graph nodes with segment/group metadata
 - agent selector (id-only labels) for isolated views
 - graph filter matches title, path, tags and note content
+- graph filter keeps hub context nodes visible (`Memory Hub`/`MOC`/high-degree fallback) to preserve relationship readability
 - realtime refresh while `--watch` is enabled
 - graph controls for zoom in, zoom out, fit visible nodes and reset-to-fit-all
 - wheel zoom (including `cmd+scroll` and `ctrl+scroll`) anchored to cursor position for faster navigation in large graphs
@@ -1054,7 +1056,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md).
 ## License
 MIT. See [LICENSE](LICENSE).
-Copyright (c) 2026 Anderson Espindola. See [COPYRIGHT.md](COPYRIGHT.md).
+Copyright (c) 2026 Substructa. See [COPYRIGHT.md](COPYRIGHT.md).
 ### Memory Optimization Loop (1-7)

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

@@ -46,8 +46,8 @@ export const createClientHtml = () => `<!doctype html>
         <canvas id="graph" aria-label="Brainlink knowledge graph"></canvas>
       </section>
     </main>
-    <footer class="app-footer" aria-label="License notice">
-      <small>MIT License · Copyright © 2026 Anderson Espindola</small>
+    <footer class="app-footer" aria-label="Copyright notice">
+      <small>Copyright © 2026 Substructa</small>
     </footer>
     <dialog id="contentDialog" class="content-dialog" aria-labelledby="contentTitle">
       <article>

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

@@ -99,6 +99,8 @@ const resize = () => {
 }
 const normalizeQuery = value => value.trim().toLowerCase()
+const hubNodeRetentionLimit = 2
+const hubNodePattern = /\b(memory\s*hub|knowledge\s*hub|hub|moc|map|memory\s*map|mapa)\b/i
 const localFilteredNodes = query =>
   state.nodes.filter(node =>
@@ -107,14 +109,51 @@ const localFilteredNodes = query =>
     node.tags.some(tag => tag.toLowerCase().includes(query))
   )
+const rankedHubNodes = () => {
+  if (state.nodes.length === 0) {
+    return []
+  }
+  const byTitleAndDegree = [...state.nodes]
+    .filter(node => hubNodePattern.test(node.title) || hubNodePattern.test(node.path) || node.tags.some(tag => hubNodePattern.test(tag)))
+    .sort((left, right) => {
+      const byDegree = (state.nodeDegrees.get(right.id) ?? 0) - (state.nodeDegrees.get(left.id) ?? 0)
+      if (byDegree !== 0) return byDegree
+      return left.title.localeCompare(right.title)
+    })
+  if (byTitleAndDegree.length > 0) {
+    return byTitleAndDegree.slice(0, hubNodeRetentionLimit)
+  }
+  return [...state.nodes]
+    .sort((left, right) => {
+      const byDegree = (state.nodeDegrees.get(right.id) ?? 0) - (state.nodeDegrees.get(left.id) ?? 0)
+      if (byDegree !== 0) return byDegree
+      return left.title.localeCompare(right.title)
+    })
+    .slice(0, 1)
+}
+const withPersistentHubNodes = nodes => {
+  if (nodes.length === 0) {
+    return rankedHubNodes()
+  }
+  const ids = new Set(nodes.map(node => node.id))
+  const hubsToKeep = rankedHubNodes().filter(node => !ids.has(node.id))
+  return nodes.concat(hubsToKeep)
+}
 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))
+    const matched = state.nodes.filter(node => state.contentFilter.ids.has(node.id))
+    return withPersistentHubNodes(matched)
   }
-  return localFilteredNodes(query)
+  return withPersistentHubNodes(localFilteredNodes(query))
 }
 const recomputeVisibility = () => {

package/dist/cli/commands/write-commands.js CHANGED Viewed

@@ -42,14 +42,18 @@ const nativeGuiLinuxScriptPath = join(tmpdir(), 'brainlink-native-gui-linux.py')
 const nativeGuiSwiftScript = `import Foundation
 import AppKit
 import WebKit
+import Darwin
 final class BrainlinkAppDelegate: NSObject, NSApplicationDelegate, NSWindowDelegate {
   private let targetUrl: URL
+  private let parentPid: Int32
   private var window: NSWindow?
   private var webView: WKWebView?
+  private var monitorTimer: Timer?
-  init(targetUrl: URL) {
+  init(targetUrl: URL, parentPid: Int32) {
     self.targetUrl = targetUrl
+    self.parentPid = parentPid
   }
   func applicationDidFinishLaunching(_ notification: Notification) {
@@ -73,16 +77,27 @@ final class BrainlinkAppDelegate: NSObject, NSApplicationDelegate, NSWindowDeleg
     self.window = window
     self.webView = webView
+    if parentPid > 0 {
+      monitorTimer = Timer.scheduledTimer(withTimeInterval: 1, repeats: true) { _ in
+        if kill(self.parentPid, 0) != 0 {
+          NSApp.terminate(nil)
+        }
+      }
+    }
     window.makeKeyAndOrderFront(nil)
     NSApp.activate(ignoringOtherApps: true)
   }
   func windowWillClose(_ notification: Notification) {
+    monitorTimer?.invalidate()
     NSApp.terminate(nil)
   }
 }
-let rawTarget = CommandLine.arguments.dropFirst().first ?? "http://127.0.0.1:4321"
+let args = Array(CommandLine.arguments.dropFirst())
+let rawTarget = args.indices.contains(0) ? args[0] : "http://127.0.0.1:4321"
+let parentPid: Int32 = args.indices.contains(1) ? (Int32(args[1]) ?? 0) : 0
 guard let targetUrl = URL(string: rawTarget) else {
   fputs("Invalid URL for Brainlink GUI: \\(rawTarget)\\n", stderr)
@@ -91,12 +106,13 @@ guard let targetUrl = URL(string: rawTarget) else {
 let app = NSApplication.shared
 app.setActivationPolicy(.regular)
-let delegate = BrainlinkAppDelegate(targetUrl: targetUrl)
+let delegate = BrainlinkAppDelegate(targetUrl: targetUrl, parentPid: parentPid)
 app.delegate = delegate
 app.run()
 `;
 const nativeGuiPowershellScript = `param(
-  [string]$TargetUrl = "http://127.0.0.1:4321"
+  [string]$TargetUrl = "http://127.0.0.1:4321",
+  [int]$ParentPid = 0
 )
 Add-Type -AssemblyName System.Windows.Forms
@@ -115,6 +131,23 @@ $browser.ScriptErrorsSuppressed = $true
 $browser.Navigate($TargetUrl)
 $form.Controls.Add($browser)
+$timer = New-Object System.Windows.Forms.Timer
+$timer.Interval = 1000
+$timer.Add_Tick({
+  if ($ParentPid -le 0) {
+    return
+  }
+  try {
+    Get-Process -Id $ParentPid -ErrorAction Stop | Out-Null
+  } catch {
+    $timer.Stop()
+    $form.Close()
+  }
+})
+$form.Add_FormClosed({
+  $timer.Stop()
+})
+$timer.Start()
 [void]$form.ShowDialog()
 `;
 const nativeGuiLinuxPythonScript = `#!/usr/bin/env python3
@@ -128,11 +161,12 @@ def run() -> int:
             gi.require_version("WebKit2", "4.1")
         except ValueError:
             gi.require_version("WebKit2", "4.0")
-        from gi.repository import Gtk, WebKit2
+        from gi.repository import Gtk, WebKit2, GLib
     except Exception:
         return 1
     target_url = sys.argv[1] if len(sys.argv) > 1 else "http://127.0.0.1:4321"
+    parent_pid = int(sys.argv[2]) if len(sys.argv) > 2 else 0
     window = Gtk.Window(title="Brainlink Graph")
     window.set_default_size(1320, 860)
@@ -142,6 +176,19 @@ def run() -> int:
     webview.load_uri(target_url)
     window.add(webview)
     window.show_all()
+    if parent_pid > 0:
+        def _watch_parent() -> bool:
+            try:
+                import os
+                os.kill(parent_pid, 0)
+            except Exception:
+                Gtk.main_quit()
+                return False
+            return True
+        GLib.timeout_add(1000, _watch_parent)
     Gtk.main()
     return 0
@@ -160,6 +207,10 @@ const commandExists = (command) => {
     }
 };
 const envFlagEnabled = (name) => process.env[name] === '1' || process.env[name] === 'true';
+const spawnAnyDetached = (candidates) => candidates.some(([command, args]) => spawnDetached(command, args));
+const windowsStartCandidates = (program, args = []) => [
+    ['cmd', ['/c', 'start', '', program, ...args]]
+];
 const resolveSwiftExecutable = () => {
     const directSwift = '/usr/bin/swift';
     if (existsSync(directSwift)) {
@@ -174,7 +225,7 @@ const resolveSwiftExecutable = () => {
         return null;
     }
 };
-const openGraphInMacNativeGui = (url) => {
+const openGraphInMacNativeGui = (url, parentPid) => {
     const swiftBinary = resolveSwiftExecutable();
     if (!swiftBinary) {
         return false;
@@ -185,7 +236,7 @@ const openGraphInMacNativeGui = (url) => {
     catch {
         return false;
     }
-    return spawnDetached(swiftBinary, [nativeGuiSwiftScriptPath, url]);
+    return spawnDetached(swiftBinary, [nativeGuiSwiftScriptPath, url, String(parentPid)]);
 };
 const resolveWindowsPowershellExecutable = () => {
     if (commandExists('powershell')) {
@@ -196,7 +247,7 @@ const resolveWindowsPowershellExecutable = () => {
     }
     return null;
 };
-const openGraphInWindowsNativeGui = (url) => {
+const openGraphInWindowsNativeGui = (url, parentPid) => {
     const powershell = resolveWindowsPowershellExecutable();
     if (!powershell) {
         return false;
@@ -207,9 +258,9 @@ const openGraphInWindowsNativeGui = (url) => {
     catch {
         return false;
     }
-    return spawnDetached(powershell, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-STA', '-File', nativeGuiPowershellScriptPath, url]);
+    return spawnDetached(powershell, ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-STA', '-File', nativeGuiPowershellScriptPath, url, String(parentPid)]);
 };
-const openGraphInLinuxNativeGui = (url) => {
+const openGraphInLinuxNativeGui = (url, parentPid) => {
     if (!commandExists('python3')) {
         return false;
     }
@@ -219,16 +270,16 @@ const openGraphInLinuxNativeGui = (url) => {
     catch {
         return false;
     }
-    return spawnDetached('python3', [nativeGuiLinuxScriptPath, url]);
+    return spawnDetached('python3', [nativeGuiLinuxScriptPath, url, String(parentPid)]);
 };
-const openGraphInNativeGui = (url) => {
+const openGraphInNativeGui = (url, parentPid) => {
     if (platform() === 'darwin') {
-        return openGraphInMacNativeGui(url);
+        return openGraphInMacNativeGui(url, parentPid);
     }
     if (platform() === 'win32') {
-        return openGraphInWindowsNativeGui(url);
+        return openGraphInWindowsNativeGui(url, parentPid);
     }
-    return openGraphInLinuxNativeGui(url);
+    return openGraphInLinuxNativeGui(url, parentPid);
 };
 const openGraphInAppWindow = (url) => {
     if (platform() === 'darwin') {
@@ -248,18 +299,49 @@ const openGraphInAppWindow = (url) => {
     }
     if (platform() === 'win32') {
         const appArgument = `--app=${url}`;
-        return (spawnDetached('cmd', ['/c', 'start', '', 'chrome', appArgument, '--new-window']) ||
-            spawnDetached('cmd', ['/c', 'start', '', 'msedge', appArgument, '--new-window']) ||
-            spawnDetached('cmd', ['/c', 'start', '', 'chromium', appArgument, '--new-window']));
+        return spawnAnyDetached([
+            ...windowsStartCandidates('msedge', [appArgument, '--new-window']),
+            ...windowsStartCandidates('chrome', [appArgument, '--new-window']),
+            ...windowsStartCandidates('chromium', [appArgument, '--new-window']),
+            ...windowsStartCandidates('brave', [appArgument, '--new-window'])
+        ]);
     }
     const appArgument = `--app=${url}`;
-    return (spawnDetached('google-chrome', [appArgument, '--new-window']) ||
-        spawnDetached('chromium-browser', [appArgument, '--new-window']) ||
-        spawnDetached('chromium', [appArgument, '--new-window']) ||
-        spawnDetached('microsoft-edge', [appArgument, '--new-window']) ||
-        spawnDetached('microsoft-edge-stable', [appArgument, '--new-window']));
+    const linuxAppWindowCandidates = [
+        'microsoft-edge',
+        'microsoft-edge-stable',
+        'google-chrome',
+        'google-chrome-stable',
+        'chromium',
+        'chromium-browser',
+        'brave-browser'
+    ].filter((candidate) => commandExists(candidate));
+    return spawnAnyDetached(linuxAppWindowCandidates.map((command) => [command, [appArgument, '--new-window']]));
+};
+const openGraphInDetectedBrowser = (url) => {
+    if (platform() === 'win32') {
+        return spawnAnyDetached([
+            ...windowsStartCandidates('msedge', [url]),
+            ...windowsStartCandidates('chrome', [url]),
+            ...windowsStartCandidates('firefox', ['-new-window', url]),
+            ...windowsStartCandidates('chromium', [url]),
+            ...windowsStartCandidates('brave', [url])
+        ]);
+    }
+    const linuxBrowserCandidates = [
+        ['microsoft-edge', [url]],
+        ['microsoft-edge-stable', [url]],
+        ['google-chrome', [url]],
+        ['google-chrome-stable', [url]],
+        ['chromium', [url]],
+        ['chromium-browser', [url]],
+        ['brave-browser', [url]],
+        ['firefox', ['-new-window', url]]
+    ];
+    const available = linuxBrowserCandidates.filter(([command]) => commandExists(command));
+    return spawnAnyDetached(available);
 };
-const openUrlInUi = (url) => {
+const openUrlInUi = (url, parentPid) => {
     const openDisabled = process.env.BRAINLINK_NO_BROWSER === '1' ||
         process.env.BRAINLINK_NO_BROWSER === 'true' ||
         process.env.CI === 'true';
@@ -269,7 +351,7 @@ const openUrlInUi = (url) => {
     const currentPlatform = platform();
     const nativeGuiEnabled = !envFlagEnabled('BRAINLINK_NO_NATIVE_GUI') &&
         (currentPlatform !== 'linux' || envFlagEnabled('BRAINLINK_LINUX_NATIVE_GUI') || envFlagEnabled('BRAINLINK_FORCE_NATIVE_GUI'));
-    if (nativeGuiEnabled && openGraphInNativeGui(url)) {
+    if (nativeGuiEnabled && openGraphInNativeGui(url, parentPid)) {
         return { opened: true, mode: 'native-gui' };
     }
     if (openGraphInAppWindow(url)) {
@@ -279,6 +361,9 @@ const openUrlInUi = (url) => {
         if (platform() === 'darwin') {
             return { opened: spawnDetached('open', [url]), mode: 'browser' };
         }
+        if (openGraphInDetectedBrowser(url)) {
+            return { opened: true, mode: 'browser' };
+        }
         if (platform() === 'win32') {
             return { opened: spawnDetached('cmd', ['/c', 'start', '', url]), mode: 'browser' };
         }
@@ -490,7 +575,7 @@ export const registerWriteCommands = (program) => {
             shouldIndex: options.index,
             shouldWatch: Boolean(options.watch)
         });
-        const openResult = options.open !== false ? openUrlInUi(server.url) : { opened: false, mode: 'none' };
+        const openResult = options.open !== false ? openUrlInUi(server.url, process.pid) : { opened: false, mode: 'none' };
         print(options.json, {
             url: server.url,
             watch: Boolean(options.watch),

package/docs/AGENT_USAGE.md CHANGED Viewed

@@ -548,12 +548,14 @@ By default it tries to open the graph in a native desktop GUI window:
 On Linux, native GUI is disabled by default for better startup performance. Enable it with `BRAINLINK_LINUX_NATIVE_GUI=1`.
 If native GUI launch is unavailable, it falls back to dedicated app-window mode and then to the default browser.
 Use `--no-open` to keep the server headless.
+When native GUI is active, the GUI window closes automatically when the `blink server` process stops.
 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. Keyboard shortcuts are `+` (zoom in), `-` (zoom out) and `0` (reset fit). Double-click on canvas zooms in at cursor position. Totals for notes, links and tags stay visible as floating metrics under the Brainlink title, and node details open on click in a modal (tags, outgoing links, backlinks and Markdown content).
+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 CHANGED Viewed

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