🤖 feat: add analytics dashboard with DuckDB backend

Makefile

@@ -112,9 +112,10 @@ mobile/node_modules/.installed: mobile/package.json mobile/bun.lock
 ensure-deps: node_modules/.installed
 
 # Rebuild native modules for Electron
-rebuild-native: node_modules/.installed ## Rebuild native modules (node-pty) for Electron
+rebuild-native: node_modules/.installed ## Rebuild native modules (node-pty, DuckDB) for Electron
 	@echo "Rebuilding native modules for Electron..."
 	@npx @electron/rebuild -f -m node_modules/node-pty
+	@npx @electron/rebuild -f -m node_modules/@duckdb/node-bindings
 	@echo "Native modules rebuilt successfully"
 
 # Run compiled CLI with trailing arguments (builds only if missing)

flake.nix

@@ -76,7 +76,7 @@
 
             outputHashMode = "recursive";
             # Marker used by scripts/update_flake_hash.sh to update this hash in place.
-            outputHash = "sha256-+6o2twg8KOUBuq2RoEqY/OwqCnWSrUiXFuaeLUiuF3k="; # mux-offline-cache-hash
+            outputHash = "sha256-XSh54hSydWb3fnA52vMJfh7zmEBsP+JHKZgIh6EzjYU="; # mux-offline-cache-hash
           };
 
           configurePhase = ''

package.json

@@ -58,6 +58,7 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
+    "@duckdb/node-api": "^1.4.4-r.1",
     "@homebridge/ciao": "^1.3.4",
     "@jitl/quickjs-wasmfile-release-asyncify": "^0.31.0",
     "@lydell/node-pty": "1.1.0",
@@ -117,6 +118,7 @@
     "react-colorful": "^5.6.1",
     "react-resizable-panels": "^3.0.6",
     "react-router-dom": "^7.11.0",
+    "recharts": "^2.15.3",
     "rehype-harden": "^1.1.5",
     "rehype-sanitize": "^6.0.0",
     "remark-breaks": "^4.0.0",
@@ -272,7 +274,8 @@
     "asarUnpack": [
       "dist/**/*.wasm",
       "dist/**/*.map",
-      "**/node_modules/node-pty/build/**/*"
+      "**/node_modules/node-pty/build/**/*",
+      "**/node_modules/@duckdb/**/*.node"
     ],
     "mac": {
       "category": "public.app-category.developer-tools",

scripts/check_eager_imports.sh

@@ -16,6 +16,7 @@ BANNED_IMPORTS=(
   "@ai-sdk/anthropic"
   "@ai-sdk/openai"
   "@ai-sdk/google"
+  "@duckdb/node-api"
   "ai"
 )
 

scripts/postinstall.sh

@@ -13,6 +13,8 @@ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 ELECTRON_PATH="$PROJECT_ROOT/node_modules/electron"
 NODE_PTY_PATH="$PROJECT_ROOT/node_modules/node-pty"
+DUCKDB_NODE_API_PATH="$PROJECT_ROOT/node_modules/@duckdb/node-api"
+DUCKDB_NODE_BINDINGS_PATH="$PROJECT_ROOT/node_modules/@duckdb/node-bindings"
 
 # 1) Skip in headless/benchmark mode (no Electron UI needed)
 if [ "${MUX_HEADLESS:-}" = "1" ]; then
@@ -26,58 +28,93 @@ if [ "${INIT_CWD:-$PROJECT_ROOT}" != "$PROJECT_ROOT" ]; then
   exit 0
 fi
 
-# 3) Skip if Electron or node-pty aren't installed
-if [ ! -d "$ELECTRON_PATH" ] || [ ! -d "$NODE_PTY_PATH" ]; then
-  echo "🌐 Server mode detected or Electron/node-pty missing – skipping native rebuild"
+# 3) Skip when Electron is unavailable (server mode install)
+if [ ! -d "$ELECTRON_PATH" ]; then
+  echo "🌐 Server mode detected (Electron missing) – skipping native rebuild"
   exit 0
 fi
 
-# 4) Build a cache key (Electron version + node-pty version + platform + arch)
+HAS_NODE_PTY=0
+if [ -d "$NODE_PTY_PATH" ]; then
+  HAS_NODE_PTY=1
+fi
+
+HAS_DUCKDB=0
+if [ -d "$DUCKDB_NODE_API_PATH" ] && [ -d "$DUCKDB_NODE_BINDINGS_PATH" ]; then
+  HAS_DUCKDB=1
+fi
+
+if [ "$HAS_NODE_PTY" = "0" ] && [ "$HAS_DUCKDB" = "0" ]; then
+  echo "🌐 Native modules missing – skipping native rebuild"
+  exit 0
+fi
+
+# 4) Build cache keys (Electron version + native module versions + platform + arch)
 ELECTRON_VERSION="$(
   node -p "require('${ELECTRON_PATH}/package.json').version" 2>/dev/null || echo "unknown"
 )"
 NODE_PTY_VERSION="$(
   node -p "require('${NODE_PTY_PATH}/package.json').version" 2>/dev/null || echo "unknown"
 )"
+DUCKDB_VERSION="$(
+  node -p "require('${DUCKDB_NODE_API_PATH}/package.json').version" 2>/dev/null || echo "unknown"
+)"
 
 PLATFORM="$(uname -s 2>/dev/null || echo unknown)"
 ARCH="$(uname -m 2>/dev/null || echo unknown)"
 
 STAMP_DIR="$PROJECT_ROOT/node_modules/.cache/mux-native"
-STAMP_FILE="$STAMP_DIR/node-pty-${ELECTRON_VERSION}-${NODE_PTY_VERSION}-${PLATFORM}-${ARCH}.stamp"
+NODE_PTY_STAMP_FILE="$STAMP_DIR/node-pty-${ELECTRON_VERSION}-${NODE_PTY_VERSION}-${PLATFORM}-${ARCH}.stamp"
+DUCKDB_STAMP_FILE="$STAMP_DIR/duckdb-${ELECTRON_VERSION}-${DUCKDB_VERSION}-${PLATFORM}-${ARCH}.stamp"
 
 mkdir -p "$STAMP_DIR"
 
-# 5) Skip if we've already rebuilt for this combo
-if [ -f "$STAMP_FILE" ]; then
-  echo "✅ node-pty already rebuilt for Electron ${ELECTRON_VERSION} on ${PLATFORM}/${ARCH} – skipping"
-  exit 0
-fi
-
-echo "🔧 Rebuilding node-pty for Electron ${ELECTRON_VERSION} on ${PLATFORM}/${ARCH}..."
-
-# 6) Run rebuild
+# 5) Resolve rebuild command
 if command -v npx >/dev/null 2>&1; then
-  npx @electron/rebuild -f -m node_modules/node-pty || {
-    echo "⚠️  Failed to rebuild native modules"
-    echo "   Terminal functionality may not work in desktop mode."
-    echo "   Run 'make rebuild-native' manually to fix."
-    exit 0
-  }
+  REBUILD_CMD="npx"
 elif command -v bunx >/dev/null 2>&1; then
-  bunx @electron/rebuild -f -m node_modules/node-pty || {
-    echo "⚠️  Failed to rebuild native modules"
-    echo "   Terminal functionality may not work in desktop mode."
-    echo "   Run 'make rebuild-native' manually to fix."
-    exit 0
-  }
+  REBUILD_CMD="bunx"
 else
   echo "⚠️  Neither npx nor bunx found - cannot rebuild native modules"
   echo "   Terminal functionality may not work in desktop mode."
   echo "   Run 'make rebuild-native' manually to fix."
   exit 0
 fi
 
-# 7) Mark this combo as done
-touch "$STAMP_FILE"
-echo "✅ Native modules rebuilt successfully (cached at $STAMP_FILE)"
+# 6) Rebuild node-pty (once per version/platform)
+if [ "$HAS_NODE_PTY" = "1" ]; then
+  if [ -f "$NODE_PTY_STAMP_FILE" ]; then
+    echo "✅ node-pty already rebuilt for Electron ${ELECTRON_VERSION} on ${PLATFORM}/${ARCH} – skipping"
+  else
+    echo "🔧 Rebuilding node-pty for Electron ${ELECTRON_VERSION} on ${PLATFORM}/${ARCH}..."
+    $REBUILD_CMD @electron/rebuild -f -m node_modules/node-pty || {
+      echo "⚠️  Failed to rebuild native modules"
+      echo "   Terminal functionality may not work in desktop mode."
+      echo "   Run 'make rebuild-native' manually to fix."
+      exit 0
+    }
+    touch "$NODE_PTY_STAMP_FILE"
+    echo "✅ node-pty rebuilt successfully (cached at $NODE_PTY_STAMP_FILE)"
+  fi
+else
+  echo "ℹ️  node-pty package missing – skipping node-pty rebuild"
+fi
+
+# 7) Rebuild DuckDB (once per version/platform)
+if [ "$HAS_DUCKDB" = "1" ]; then
+  if [ -f "$DUCKDB_STAMP_FILE" ]; then
+    echo "✅ DuckDB already rebuilt for Electron ${ELECTRON_VERSION} on ${PLATFORM}/${ARCH} – skipping"
+  else
+    echo "🔧 Rebuilding DuckDB for Electron ${ELECTRON_VERSION} on ${PLATFORM}/${ARCH}..."
+    $REBUILD_CMD @electron/rebuild -f -m node_modules/@duckdb/node-bindings || {
+      echo "⚠️  Failed to rebuild native modules"
+      echo "   Terminal functionality may not work in desktop mode."
+      echo "   Run 'make rebuild-native' manually to fix."
+      exit 0
+    }
+    touch "$DUCKDB_STAMP_FILE"
+    echo "✅ DuckDB rebuilt successfully (cached at $DUCKDB_STAMP_FILE)"
+  fi
+else
+  echo "ℹ️  DuckDB packages missing – skipping DuckDB rebuild"
+fi