@andespindola/brainlink 0.1.0-beta.34 → 0.1.0-beta.36

package/CHANGELOG.md

@@ -26,6 +26,8 @@
 - Added compressed-space pack prefiltering (token bloom index) before `.blpk` decryption and scan.
 - 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.
 
 ## 0.1.0-beta.3
 

package/README.md

@@ -556,10 +556,12 @@ By default, the server uses `$HOME/.brainlink/vault`. Pass `--vault ./vault` onl
 By default, `blink server` tries to open the graph in a native desktop GUI window:
 - macOS: Swift + WebKit
 - Windows: PowerShell WinForms WebBrowser
-- Linux: Python GTK + WebKit2 (requires `python3` + `gi` + `WebKit2`)
+- Linux: optional Python GTK + WebKit2 (requires `python3` + `gi` + `WebKit2`)
 
+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:
 
@@ -850,6 +852,7 @@ blink server --vault ./vault --watch --no-open
 
 Starts the local read-only graph UI and HTTP API.
 By default, it tries to open a native desktop GUI window for the graph URL.
+On Linux, native GUI is disabled by default; enable it with `BRAINLINK_LINUX_NATIVE_GUI=1`.
 If native GUI launch is unavailable, it falls back to dedicated app-window mode and then browser open.
 Use `--no-open` to skip that behavior.
 

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

@@ -5,6 +5,8 @@ const largeGraphEdgeRenderLimit = 16000
 const renderNodeBudget = 1800
 const minNodePixelRadius = 1.8
 const viewportPaddingPx = 280
+const worldCoordinateLimit = 5_000_000
+const transformCoordinateLimit = 20_000_000
 const state = {
   graph: { nodes: [], edges: [] },
   nodes: [],
@@ -133,6 +135,7 @@ const edgeWeight = edge => Number.isFinite(edge.weight) ? Math.max(1, edge.weigh
 
 const clampScale = value => Math.max(zoomRange.min, Math.min(zoomRange.max, value))
 const isFiniteNumber = value => Number.isFinite(value)
+const isReasonableCoordinate = value => isFiniteNumber(value) && Math.abs(value) <= worldCoordinateLimit
 
 const graphBounds = nodes => {
   if (nodes.length === 0) return null
@@ -521,13 +524,15 @@ const hasValidTransform = () =>
   isFiniteNumber(state.transform.x) &&
   isFiniteNumber(state.transform.y) &&
   isFiniteNumber(state.transform.scale) &&
+  Math.abs(state.transform.x) <= transformCoordinateLimit &&
+  Math.abs(state.transform.y) <= transformCoordinateLimit &&
   state.transform.scale > 0
 
 const sanitizeNodePosition = node => {
-  if (!isFiniteNumber(node.x)) node.x = 0
-  if (!isFiniteNumber(node.y)) node.y = 0
-  if (!isFiniteNumber(node.vx)) node.vx = 0
-  if (!isFiniteNumber(node.vy)) node.vy = 0
+  if (!isReasonableCoordinate(node.x)) node.x = 0
+  if (!isReasonableCoordinate(node.y)) node.y = 0
+  if (!isFiniteNumber(node.vx) || Math.abs(node.vx) > worldCoordinateLimit) node.vx = 0
+  if (!isFiniteNumber(node.vy) || Math.abs(node.vy) > worldCoordinateLimit) node.vy = 0
 }
 
 const sanitizeGraphState = () => {

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

@@ -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
 
@@ -159,6 +206,7 @@ const commandExists = (command) => {
         return false;
     }
 };
+const envFlagEnabled = (name) => process.env[name] === '1' || process.env[name] === 'true';
 const resolveSwiftExecutable = () => {
     const directSwift = '/usr/bin/swift';
     if (existsSync(directSwift)) {
@@ -173,7 +221,7 @@ const resolveSwiftExecutable = () => {
         return null;
     }
 };
-const openGraphInMacNativeGui = (url) => {
+const openGraphInMacNativeGui = (url, parentPid) => {
     const swiftBinary = resolveSwiftExecutable();
     if (!swiftBinary) {
         return false;
@@ -184,7 +232,7 @@ const openGraphInMacNativeGui = (url) => {
     catch {
         return false;
     }
-    return spawnDetached(swiftBinary, [nativeGuiSwiftScriptPath, url]);
+    return spawnDetached(swiftBinary, [nativeGuiSwiftScriptPath, url, String(parentPid)]);
 };
 const resolveWindowsPowershellExecutable = () => {
     if (commandExists('powershell')) {
@@ -195,7 +243,7 @@ const resolveWindowsPowershellExecutable = () => {
     }
     return null;
 };
-const openGraphInWindowsNativeGui = (url) => {
+const openGraphInWindowsNativeGui = (url, parentPid) => {
     const powershell = resolveWindowsPowershellExecutable();
     if (!powershell) {
         return false;
@@ -206,9 +254,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;
     }
@@ -218,16 +266,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') {
@@ -258,14 +306,17 @@ const openGraphInAppWindow = (url) => {
         spawnDetached('microsoft-edge', [appArgument, '--new-window']) ||
         spawnDetached('microsoft-edge-stable', [appArgument, '--new-window']));
 };
-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';
     if (openDisabled) {
         return { opened: false, mode: 'none' };
     }
-    if (openGraphInNativeGui(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, parentPid)) {
         return { opened: true, mode: 'native-gui' };
     }
     if (openGraphInAppWindow(url)) {
@@ -486,7 +537,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

@@ -543,10 +543,12 @@ This starts a local frontend for inspecting the knowledge graph.
 By default it tries to open the graph in a native desktop GUI window:
 - macOS: Swift + WebKit
 - Windows: PowerShell WinForms WebBrowser
-- Linux: Python GTK + WebKit2 (requires `python3` + `gi` + `WebKit2`)
+- Linux: optional Python GTK + WebKit2 (requires `python3` + `gi` + `WebKit2`)
 
+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`.
 

package/package.json

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