spindb 0.35.4 → 0.36.2

package/cli/commands/menu/settings-handlers.ts

@@ -48,6 +48,7 @@ function generatePreviewLine(mode: IconMode): string {
       [Engine.QuestDB]: '[QS]',
       [Engine.TypeDB]: '[TB]',
       [Engine.InfluxDB]: '[IX]',
+      [Engine.Weaviate]: '[WV]',
     }
     const icons = PREVIEW_ENGINES.map((engine) => {
       const icon = ASCII_ICONS[engine] || '[??]'
@@ -77,6 +78,7 @@ function generatePreviewLine(mode: IconMode): string {
       [Engine.QuestDB]: '\ued2f',
       [Engine.TypeDB]: '\ue706',
       [Engine.InfluxDB]: '\udb85\udf95',
+      [Engine.Weaviate]: '\uf0e8',
     }
     const icons = PREVIEW_ENGINES.map((engine) => {
       const icon = NERD_ICONS[engine] || '\ue706'
@@ -106,6 +108,7 @@ function generatePreviewLine(mode: IconMode): string {
     [Engine.QuestDB]: '\u23F1',
     [Engine.TypeDB]: '\u{1F916}',
     [Engine.InfluxDB]: '\u{1F4C8}',
+    [Engine.Weaviate]: '\u{1F52E}',
   }
   const icons = PREVIEW_ENGINES.map((engine) => EMOJI_ICONS[engine] || '\u25A3')
   return icons.join(' ')

package/cli/commands/menu/shell-handlers.ts

@@ -244,6 +244,13 @@ export async function handleOpenShell(
     engineSpecificInstalled = false
     engineSpecificValue = null
     engineSpecificInstallValue = null
+  } else if (config.engine === 'weaviate') {
+    // Weaviate uses REST API, open web dashboard in browser
+    defaultShellName = 'REST API'
+    engineSpecificCli = null
+    engineSpecificInstalled = false
+    engineSpecificValue = null
+    engineSpecificInstallValue = null
   } else if (config.engine === 'couchdb') {
     // CouchDB uses REST API, open Fauxton dashboard in browser
     defaultShellName = 'Fauxton Dashboard'
@@ -344,6 +351,16 @@ export async function handleOpenShell(
       name: `ℹ Show API info`,
       value: 'api-info',
     })
+  } else if (config.engine === 'weaviate') {
+    // Weaviate: REST API dashboard + API info
+    choices.push({
+      name: `◎ Open Dashboard in browser`,
+      value: 'default',
+    })
+    choices.push({
+      name: `ℹ Show API info`,
+      value: 'api-info',
+    })
   } else if (config.engine === 'couchdb') {
     // CouchDB: Fauxton dashboard is built-in at /_utils
     choices.push({
@@ -597,6 +614,20 @@ export async function handleOpenShell(
           `  curl -H "Content-Type: application/json" http://127.0.0.1:${config.port}/api/v3/query_sql -d '{"db":"mydb","q":"SELECT 1"}'`,
         ),
       )
+    } else if (config.engine === 'weaviate') {
+      console.log(chalk.cyan('Weaviate REST API:'))
+      console.log(chalk.white(`  HTTP: http://127.0.0.1:${config.port}`))
+      console.log(chalk.white(`  gRPC: 127.0.0.1:${config.port + 1}`))
+      console.log()
+      console.log(chalk.gray('Example curl commands:'))
+      console.log(
+        chalk.gray(
+          `  curl http://127.0.0.1:${config.port}/v1/.well-known/ready`,
+        ),
+      )
+      console.log(
+        chalk.gray(`  curl http://127.0.0.1:${config.port}/v1/schema`),
+      )
     } else if (config.engine === 'couchdb') {
       console.log(chalk.cyan('CouchDB REST API:'))
       console.log(chalk.white(`  HTTP: http://127.0.0.1:${config.port}`))
@@ -1505,6 +1536,15 @@ async function launchShell(
     openInBrowser(dashboardUrl)
     await pressEnterToContinue()
     return
+  } else if (config.engine === 'weaviate') {
+    // Weaviate: Open REST API root in browser
+    const dashboardUrl = `http://127.0.0.1:${config.port}`
+    console.log(uiInfo(`Opening Weaviate in browser...`))
+    console.log(chalk.gray(`  ${dashboardUrl}`))
+    console.log()
+    openInBrowser(dashboardUrl)
+    await pressEnterToContinue()
+    return
   } else if (config.engine === 'influxdb') {
     // InfluxDB: influxdb3 query is one-shot (no REPL), use interactive loop
     const engine = getEngine(config.engine)

package/cli/constants.ts

@@ -77,6 +77,7 @@ export const ENGINE_BRAND_COLORS: Record<Engine, BrandColor> = {
   [Engine.QuestDB]: { foreground: '#000000', background: '#02FC04' }, // Black on green
   [Engine.TypeDB]: { foreground: '#FFFFFF', background: '#7B2D8E' }, // White on purple
   [Engine.InfluxDB]: { foreground: '#FFFFFF', background: '#9394FF' }, // White on indigo/purple
+  [Engine.Weaviate]: { foreground: '#FFFFFF', background: '#00D1A8' }, // White on green
 }
 
 // ASCII fallback icons - work in any terminal
@@ -99,6 +100,7 @@ const ASCII_ICONS: Record<Engine, string> = {
   [Engine.QuestDB]: '[QS]',
   [Engine.TypeDB]: '[TB]',
   [Engine.InfluxDB]: '[IX]',
+  [Engine.Weaviate]: '[WV]',
 }
 
 // Nerd Font icons - require a patched font
@@ -122,6 +124,7 @@ const NERD_ICONS: Record<Engine, string> = {
   [Engine.QuestDB]: '\ued2f', // nf-fa-gauge-high (time-series performance)
   [Engine.TypeDB]: '\ue706', // nf-dev-database (knowledge graph)
   [Engine.InfluxDB]: '\udb85\udf95', // nf-md-chart-line (time-series)
+  [Engine.Weaviate]: '\uf0e8', // nf-fa-sitemap (vector graph)
 }
 
 // Emoji icons - original icons, inconsistent width across terminals
@@ -144,6 +147,7 @@ const EMOJI_ICONS: Record<Engine, string> = {
   [Engine.QuestDB]: '⏱',
   [Engine.TypeDB]: '🤖',
   [Engine.InfluxDB]: '📈',
+  [Engine.Weaviate]: '🔮',
 }
 
 const DEFAULT_ICONS: Record<IconMode, string> = {

package/cli/helpers.ts

@@ -244,6 +244,16 @@ export type InstalledInfluxDBEngine = {
   source: 'downloaded'
 }
 
+export type InstalledWeaviateEngine = {
+  engine: 'weaviate'
+  version: string
+  platform: string
+  arch: string
+  path: string
+  sizeBytes: number
+  source: 'downloaded'
+}
+
 export type InstalledEngine =
   | InstalledPostgresEngine
   | InstalledMariadbEngine
@@ -263,6 +273,7 @@ export type InstalledEngine =
   | InstalledQuestDBEngine
   | InstalledTypeDBEngine
   | InstalledInfluxDBEngine
+  | InstalledWeaviateEngine
 
 async function getPostgresVersion(binPath: string): Promise<string | null> {
   const ext = platformService.getExecutableExtension()
@@ -1278,6 +1289,64 @@ async function getInstalledFerretDBEngines(): Promise<
   return engines
 }
 
+// Get Weaviate version from binary path
+async function getWeaviateVersion(binPath: string): Promise<string | null> {
+  const ext = platformService.getExecutableExtension()
+  const weaviatePath = join(binPath, 'bin', `weaviate${ext}`)
+  if (!existsSync(weaviatePath)) {
+    return null
+  }
+
+  try {
+    const { stdout } = await execFileAsync(weaviatePath, ['--version'])
+    // Parse output like "weaviate v1.35.7" or "1.35.7"
+    const match = stdout.match(/(?:weaviate\s+)?v?(\d+\.\d+\.\d+)/)
+    return match ? match[1] : null
+  } catch {
+    return null
+  }
+}
+
+// Get installed Weaviate engines from downloaded binaries
+async function getInstalledWeaviateEngines(): Promise<
+  InstalledWeaviateEngine[]
+> {
+  const binDir = paths.bin
+
+  if (!existsSync(binDir)) {
+    return []
+  }
+
+  const entries = await readdir(binDir, { withFileTypes: true })
+  const engines: InstalledWeaviateEngine[] = []
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    if (!entry.name.startsWith('weaviate-')) continue
+
+    const parsed = parseEngineDirectory(entry.name, 'weaviate-', binDir)
+    if (!parsed) continue
+
+    const actualVersion =
+      (await getWeaviateVersion(parsed.path)) || parsed.version
+    const sizeBytes = await calculateDirectorySize(parsed.path)
+
+    engines.push({
+      engine: 'weaviate',
+      version: actualVersion,
+      platform: parsed.platform,
+      arch: parsed.arch,
+      path: parsed.path,
+      sizeBytes,
+      source: 'downloaded',
+    })
+  }
+
+  engines.sort((a, b) => compareVersions(b.version, a.version))
+
+  return engines
+}
+
 export function compareVersions(a: string, b: string): number {
   const partsA = a.split('.').map((p) => parseInt(p, 10) || 0)
   const partsB = b.split('.').map((p) => parseInt(p, 10) || 0)
@@ -1314,6 +1383,7 @@ const ENGINE_PREFIXES = [
   'questdb-',
   'typedb-',
   'influxdb-',
+  'weaviate-',
 ] as const
 
 /**
@@ -1362,6 +1432,7 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     questdbEngines,
     typedbEngines,
     influxdbEngines,
+    weaviateEngines,
   ] = await Promise.all([
     getInstalledPostgresEngines(),
     getInstalledMariadbEngines(),
@@ -1381,6 +1452,7 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     getInstalledQuestDBEngines(),
     getInstalledTypeDBEngines(),
     getInstalledInfluxDBEngines(),
+    getInstalledWeaviateEngines(),
   ])
 
   return [
@@ -1402,6 +1474,7 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     ...questdbEngines,
     ...typedbEngines,
     ...influxdbEngines,
+    ...weaviateEngines,
   ]
 }
 
@@ -1423,4 +1496,5 @@ export {
   getInstalledQuestDBEngines,
   getInstalledTypeDBEngines,
   getInstalledInfluxDBEngines,
+  getInstalledWeaviateEngines,
 }

package/config/backup-formats.ts

@@ -28,6 +28,7 @@ import {
   type QuestDBFormat,
   type TypeDBFormat,
   type InfluxDBFormat,
+  type WeaviateFormat,
   type BackupFormatType,
 } from '../types'
 
@@ -65,6 +66,7 @@ export const BACKUP_FORMATS: {
   [Engine.QuestDB]: EngineBackupFormats<QuestDBFormat>
   [Engine.TypeDB]: EngineBackupFormats<TypeDBFormat>
   [Engine.InfluxDB]: EngineBackupFormats<InfluxDBFormat>
+  [Engine.Weaviate]: EngineBackupFormats<WeaviateFormat>
 } = {
   [Engine.PostgreSQL]: {
     formats: {
@@ -336,6 +338,18 @@ export const BACKUP_FORMATS: {
     supportsFormatChoice: false, // Only SQL format supported
     defaultFormat: 'sql',
   },
+  [Engine.Weaviate]: {
+    formats: {
+      snapshot: {
+        extension: '.snapshot',
+        label: '.snapshot',
+        description: 'Weaviate snapshot - full database backup',
+        spinnerLabel: 'snapshot',
+      },
+    },
+    supportsFormatChoice: false, // Only snapshot format supported
+    defaultFormat: 'snapshot',
+  },
 }
 
 /**

package/config/engine-defaults.ts

@@ -265,6 +265,19 @@ export const engineDefaults: Record<Engine, EngineDefaults> = {
     clientTools: [], // InfluxDB uses REST API, no separate CLI tools
     maxConnections: 0, // Not applicable for time-series DB
   },
+  [Engine.Weaviate]: {
+    defaultVersion: '1',
+    defaultPort: 8080, // Weaviate HTTP REST API port (gRPC is port + 1)
+    portRange: { start: 8080, end: 8180 },
+    latestVersion: '1',
+    superuser: '', // No auth by default for local dev
+    connectionScheme: 'http',
+    logFileName: 'weaviate.log',
+    pidFileName: 'weaviate.pid',
+    dataSubdir: 'data',
+    clientTools: [], // Weaviate uses REST/GraphQL API, no separate CLI tools
+    maxConnections: 0, // Not applicable for vector DB
+  },
 }
 
 /**

package/config/engines.json

@@ -309,6 +309,23 @@
       "clientTools": ["influxdb3"],
       "licensing": ["Apache-2.0", "MIT"],
       "notes": "Purpose-built time-series database with SQL support. InfluxDB 3.x is a Rust rewrite using Apache Arrow/DataFusion. HTTP API on port 8086."
+    },
+    "weaviate": {
+      "displayName": "Weaviate",
+      "icon": "🔮",
+      "status": "integrated",
+      "binarySource": "hostdb",
+      "supportedVersions": ["1.35.7"],
+      "defaultVersion": "1.35.7",
+      "defaultPort": 8080,
+      "runtime": "server",
+      "queryLanguage": "rest",
+      "scriptFileLabel": null,
+      "connectionScheme": "http",
+      "superuser": null,
+      "clientTools": ["weaviate"],
+      "licensing": "BSD-3-Clause",
+      "notes": "AI-native vector database. REST API on port 8080, gRPC on port+1. Uses classes/collections instead of databases."
     }
   }
 }

package/core/config-manager.ts

@@ -82,6 +82,8 @@ const TYPEDB_TOOLS: BinaryTool[] = ['typedb', 'typedb_console_bin']
 
 const INFLUXDB_TOOLS: BinaryTool[] = ['influxdb3']
 
+const WEAVIATE_TOOLS: BinaryTool[] = ['weaviate']
+
 const PGWEB_TOOLS: BinaryTool[] = ['pgweb']
 
 const DBLAB_TOOLS: BinaryTool[] = ['dblab']
@@ -110,6 +112,7 @@ const ALL_TOOLS: BinaryTool[] = [
   ...QUESTDB_TOOLS,
   ...TYPEDB_TOOLS,
   ...INFLUXDB_TOOLS,
+  ...WEAVIATE_TOOLS,
   ...PGWEB_TOOLS,
   ...DBLAB_TOOLS,
   ...SQLITE_TOOLS,
@@ -135,6 +138,7 @@ const ENGINE_BINARY_MAP: Partial<Record<Engine, BinaryTool[]>> = {
   [Engine.QuestDB]: QUESTDB_TOOLS,
   [Engine.TypeDB]: TYPEDB_TOOLS,
   [Engine.InfluxDB]: INFLUXDB_TOOLS,
+  [Engine.Weaviate]: WEAVIATE_TOOLS,
 }
 
 export class ConfigManager {
@@ -368,6 +372,7 @@ export class ConfigManager {
     meilisearch: { found: BinaryTool[]; missing: BinaryTool[] }
     typedb: { found: BinaryTool[]; missing: BinaryTool[] }
     influxdb: { found: BinaryTool[]; missing: BinaryTool[] }
+    weaviate: { found: BinaryTool[]; missing: BinaryTool[] }
     enhanced: { found: BinaryTool[]; missing: BinaryTool[] }
   }> {
     // First, scan ~/.spindb/bin/ for downloaded (bundled) binaries
@@ -429,6 +434,10 @@ export class ConfigManager {
         found: found.filter((t) => INFLUXDB_TOOLS.includes(t)),
         missing: missing.filter((t) => INFLUXDB_TOOLS.includes(t)),
       },
+      weaviate: {
+        found: found.filter((t) => WEAVIATE_TOOLS.includes(t)),
+        missing: missing.filter((t) => WEAVIATE_TOOLS.includes(t)),
+      },
       enhanced: {
         found: found.filter((t) => ENHANCED_SHELLS.includes(t)),
         missing: missing.filter((t) => ENHANCED_SHELLS.includes(t)),
@@ -627,6 +636,7 @@ export {
   QUESTDB_TOOLS,
   TYPEDB_TOOLS,
   INFLUXDB_TOOLS,
+  WEAVIATE_TOOLS,
   PGWEB_TOOLS,
   DBLAB_TOOLS,
   SQLITE_TOOLS,

package/core/credential-manager.ts

@@ -251,6 +251,8 @@ export function getDefaultUsername(engine: Engine): string {
       return 'search_key'
     case Engine.Qdrant:
       return 'api_key'
+    case Engine.Weaviate:
+      return 'api_key'
     default:
       return 'spindb'
   }

package/core/dependency-manager.ts

@@ -86,6 +86,8 @@ const KNOWN_BINARY_TOOLS: readonly BinaryTool[] = [
   'typedb_console_bin',
   // InfluxDB
   'influxdb3',
+  // Weaviate
+  'weaviate',
   // Web panels
   'pgweb',
   // TUI tools

package/core/docker-exporter.ts

@@ -72,6 +72,7 @@ function getEngineDisplayName(engine: Engine): string {
     [Engine.QuestDB]: 'QuestDB',
     [Engine.TypeDB]: 'TypeDB',
     [Engine.InfluxDB]: 'InfluxDB',
+    [Engine.Weaviate]: 'Weaviate',
   }
   return displayNames[engine] || engine
 }
@@ -145,6 +146,9 @@ const _ENGINE_BINARY_CONFIG: Record<
   [Engine.InfluxDB]: {
     primaryBinaries: [], // REST API only, no CLI tools
   },
+  [Engine.Weaviate]: {
+    primaryBinaries: [], // REST/GraphQL API only, no CLI tools
+  },
 }
 
 /**
@@ -198,6 +202,7 @@ function getConnectionStringTemplate(
 
     case Engine.Meilisearch:
     case Engine.InfluxDB:
+    case Engine.Weaviate:
       return useTLS ? `https://<host>:${port}` : `http://<host>:${port}`
 
     case Engine.CouchDB:
@@ -494,6 +499,7 @@ echo "User configured via server settings"
 
     case Engine.Qdrant:
     case Engine.Meilisearch:
+    case Engine.Weaviate:
       userCreationCommands = `
 # API key is configured at server start
 echo "API key configured via server settings"
@@ -1297,6 +1303,7 @@ export async function getDockerConnectionString(
 
     case Engine.Meilisearch:
     case Engine.InfluxDB:
+    case Engine.Weaviate:
       return `http://${host}:${port}`
 
     case Engine.CouchDB:

package/core/library-env.ts

@@ -0,0 +1,120 @@
+/**
+ * Library environment utilities for dynamically-linked engine binaries.
+ *
+ * MariaDB, Redis, and Valkey hostdb binaries are linked against Homebrew's
+ * OpenSSL at absolute paths (e.g. /opt/homebrew/opt/openssl@3/lib/libssl.3.dylib).
+ * On systems without that library, they fail with cryptic dyld errors.
+ *
+ * This module provides:
+ * - getLibraryEnv(): sets DYLD_FALLBACK_LIBRARY_PATH / LD_LIBRARY_PATH so
+ *   the dynamic linker checks {binPath}/lib first (preparing for when hostdb
+ *   bundles dylibs alongside binaries).
+ * - detectLibraryError(): scans process output for library-loading patterns
+ *   and returns an actionable error message.
+ */
+
+import { platform as osPlatform } from 'os'
+import { join } from 'path'
+
+/**
+ * Returns env vars that point the dynamic linker at {binPath}/lib.
+ * On macOS: DYLD_FALLBACK_LIBRARY_PATH
+ * On Linux: LD_LIBRARY_PATH
+ * On Windows: returns undefined (not applicable).
+ *
+ * Usage: spread into spawn env: `{ ...process.env, ...getLibraryEnv(binPath) }`
+ */
+export function getLibraryEnv(
+  binPath: string,
+): Record<string, string> | undefined {
+  const plat = osPlatform()
+  const libDir = join(binPath, 'lib')
+
+  if (plat === 'darwin') {
+    return { DYLD_FALLBACK_LIBRARY_PATH: libDir }
+  }
+  if (plat === 'linux') {
+    return { LD_LIBRARY_PATH: libDir }
+  }
+  return undefined
+}
+
+/**
+ * Scans stderr/log output for dynamic library loading errors and returns
+ * an actionable message, or null if no library error was detected.
+ */
+export function detectLibraryError(
+  output: string,
+  engineName: string,
+): string | null {
+  if (!output) return null
+
+  const plat = osPlatform()
+  const lower = output.toLowerCase()
+
+  // macOS dyld errors
+  if (
+    lower.includes('library not loaded') ||
+    lower.includes('dyld:') ||
+    lower.includes('dyld[')
+  ) {
+    const needsOpenssl =
+      lower.includes('libssl') || lower.includes('libcrypto')
+
+    if (needsOpenssl && plat === 'darwin') {
+      return (
+        `${engineName} failed to start: missing OpenSSL libraries.\n` +
+        `The downloaded binary requires OpenSSL 3 which is not installed.\n` +
+        `Fix: brew install openssl@3\n` +
+        `Alternatively, re-download binaries after hostdb ships relocatable builds.`
+      )
+    }
+
+    return (
+      `${engineName} failed to start: a required dynamic library could not be loaded.\n` +
+      `This typically means the hostdb binary was built against libraries not present on this system.\n` +
+      (plat === 'darwin'
+        ? `Try: brew install openssl@3\n`
+        : `Try: sudo apt-get install libssl-dev  (or the equivalent for your distro)\n`) +
+      `See: https://github.com/robertjbass/hostdb/issues`
+    )
+  }
+
+  // Linux GLIBC version errors
+  if (lower.includes('glibc') || lower.includes('libc.so')) {
+    return (
+      `${engineName} failed to start: incompatible system C library (GLIBC).\n` +
+      `The downloaded binary requires a newer GLIBC version than is installed.\n` +
+      `Options:\n` +
+      `  - Upgrade your OS to a newer version\n` +
+      `  - Use Docker: spindb can run inside containers with newer GLIBC\n` +
+      `See: https://github.com/robertjbass/hostdb/issues`
+    )
+  }
+
+  // Generic shared library errors on Linux
+  if (
+    lower.includes('error while loading shared libraries') ||
+    lower.includes('cannot open shared object file')
+  ) {
+    const needsOpenssl =
+      lower.includes('libssl') || lower.includes('libcrypto')
+
+    if (needsOpenssl) {
+      return (
+        `${engineName} failed to start: missing OpenSSL libraries.\n` +
+        `Fix: sudo apt-get install libssl-dev  (Debian/Ubuntu)\n` +
+        `     sudo dnf install openssl-devel   (Fedora/RHEL)\n` +
+        `See: https://github.com/robertjbass/hostdb/issues`
+      )
+    }
+
+    return (
+      `${engineName} failed to start: a required shared library is missing.\n` +
+      `Check the error output above for the specific library name and install it.\n` +
+      `See: https://github.com/robertjbass/hostdb/issues`
+    )
+  }
+
+  return null
+}

package/engines/index.ts

@@ -16,6 +16,7 @@ import { surrealdbEngine } from './surrealdb'
 import { questdbEngine } from './questdb'
 import { typedbEngine } from './typedb'
 import { influxdbEngine } from './influxdb'
+import { weaviateEngine } from './weaviate'
 import { platformService } from '../core/platform-service'
 import { Engine, Platform } from '../types'
 import type { BaseEngine } from './base-engine'
@@ -83,6 +84,9 @@ export const engines: Record<string, BaseEngine> = {
   // InfluxDB and aliases
   [Engine.InfluxDB]: influxdbEngine,
   influx: influxdbEngine,
+  // Weaviate and aliases
+  [Engine.Weaviate]: weaviateEngine,
+  wv: weaviateEngine,
 }
 
 // Get an engine by name
@@ -119,4 +123,5 @@ export function listEngines(): EngineInfo[] {
       defaultPort: engine.defaultPort,
       supportedVersions: engine.supportedVersions,
     }))
+    .sort((a, b) => a.displayName.localeCompare(b.displayName))
 }