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

package/CHANGELOG.md

@@ -26,6 +26,7 @@
 - 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`.
 
 ## 0.1.0-beta.3
 

package/README.md

@@ -556,8 +556,9 @@ 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.
 
@@ -850,6 +851,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

@@ -159,6 +159,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)) {
@@ -265,7 +266,10 @@ const openUrlInUi = (url) => {
     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)) {
         return { opened: true, mode: 'native-gui' };
     }
     if (openGraphInAppWindow(url)) {

package/docs/AGENT_USAGE.md

@@ -543,8 +543,9 @@ 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.
 

package/package.json

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