fluxy-bot 0.3.27 → 0.4.0

package/bin/cli.js

@@ -30,6 +30,8 @@ const c = {
   yellow: '\x1b[33m',
   red: '\x1b[31m',
   white: '\x1b[97m',
+  blue: '\x1b[38;2;50;165;247m',
+  pink: '\x1b[38;2;219;54;163m',
 };
 
 const SPINNER = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
@@ -100,10 +102,11 @@ class Stepper {
 
 function banner() {
   console.log(`
-  ${c.cyan}${c.bold}╔═══════════════════════════════╗
-  ║         FLUXY  v${pkg.version.padEnd(13)}║
-  ╚═══════════════════════════════╝${c.reset}
-  ${c.dim}Self-hosted AI bot${c.reset}`);
+  ${c.blue}${c.bold}     ___  __                  ${c.reset}
+  ${c.blue}${c.bold}    / _/ / / __  __ __  __ __ ${c.reset}
+  ${c.pink}${c.bold}   / _/ / / / / / / \\ \\/ / / / ${c.reset}
+  ${c.pink}${c.bold}  /_/  /_/  \\_,_/ /_/\\_\\  /_/  ${c.reset}
+  ${c.dim}v${pkg.version} · Self-hosted AI bot${c.reset}`);
 }
 
 function finalMessage(tunnelUrl, relayUrl) {
@@ -112,13 +115,13 @@ function finalMessage(tunnelUrl, relayUrl) {
 
   ${c.bold}${c.white}Open your dashboard to finish setup:${c.reset}
 
-  ${c.cyan}${c.bold}${tunnelUrl}${c.reset}`);
+  ${c.blue}${c.bold}${tunnelUrl}${c.reset}`);
 
   if (relayUrl) {
     console.log(`
   ${c.bold}${c.white}Your permanent URL:${c.reset}
 
-  ${c.cyan}${c.bold}${relayUrl}${c.reset}`);
+  ${c.blue}${c.bold}${relayUrl}${c.reset}`);
   }
 
   console.log(`
@@ -396,12 +399,128 @@ async function status() {
   }
 }
 
+async function update() {
+  banner();
+
+  const currentVersion = pkg.version;
+  console.log(`\n  ${c.dim}Current version: v${currentVersion}${c.reset}`);
+  console.log(`  ${c.blue}⠋${c.reset}  Checking for updates...\n`);
+
+  // Fetch latest package info from npm registry
+  let latest;
+  try {
+    const res = await fetch('https://registry.npmjs.org/fluxy-bot/latest');
+    if (!res.ok) throw new Error();
+    latest = await res.json();
+  } catch {
+    console.log(`  ${c.red}✗${c.reset}  Failed to check for updates\n`);
+    process.exit(1);
+  }
+
+  if (currentVersion === latest.version) {
+    console.log(`  ${c.green}✔${c.reset}  Already up to date (v${currentVersion})\n`);
+    return;
+  }
+
+  console.log(`  ${c.dim}v${currentVersion} → v${latest.version}${c.reset}\n`);
+
+  const steps = [
+    'Downloading update',
+    'Updating files',
+    'Installing dependencies',
+    'Building interface',
+  ];
+
+  const stepper = new Stepper(steps);
+  stepper.start();
+
+  // Download tarball
+  const tarballUrl = latest.dist.tarball;
+  const tmpDir = path.join(os.tmpdir(), `fluxy-update-${Date.now()}`);
+  fs.mkdirSync(tmpDir, { recursive: true });
+  const tarball = path.join(tmpDir, 'fluxy.tgz');
+
+  try {
+    const res = await fetch(tarballUrl);
+    if (!res.ok) throw new Error();
+    const buf = Buffer.from(await res.arrayBuffer());
+    fs.writeFileSync(tarball, buf);
+    execSync(`tar xzf "${tarball}" -C "${tmpDir}"`, { stdio: 'ignore' });
+  } catch {
+    stepper.finish();
+    console.log(`\n  ${c.red}✗${c.reset}  Download failed\n`);
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+    process.exit(1);
+  }
+  stepper.advance();
+
+  const extracted = path.join(tmpDir, 'package');
+
+  // Update code directories (preserve workspace/ user data)
+  for (const dir of ['bin', 'supervisor', 'worker', 'shared', 'scripts']) {
+    const src = path.join(extracted, dir);
+    if (fs.existsSync(src)) {
+      fs.cpSync(src, path.join(DATA_DIR, dir), { recursive: true, force: true });
+    }
+  }
+
+  // Copy workspace template only if it doesn't exist yet
+  if (!fs.existsSync(path.join(DATA_DIR, 'workspace'))) {
+    const wsSrc = path.join(extracted, 'workspace');
+    if (fs.existsSync(wsSrc)) {
+      fs.cpSync(wsSrc, path.join(DATA_DIR, 'workspace'), { recursive: true });
+    }
+  }
+
+  // Update code files (never touches config.json, memory.db, etc.)
+  for (const file of ['package.json', 'vite.config.ts', 'vite.fluxy.config.ts', 'tsconfig.json', 'postcss.config.js', 'components.json']) {
+    const src = path.join(extracted, file);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, path.join(DATA_DIR, file));
+    }
+  }
+
+  // Update pre-built UI from tarball
+  const distSrc = path.join(extracted, 'dist-fluxy');
+  const distDst = path.join(DATA_DIR, 'dist-fluxy');
+  if (fs.existsSync(distSrc)) {
+    if (fs.existsSync(distDst)) fs.rmSync(distDst, { recursive: true });
+    fs.cpSync(distSrc, distDst, { recursive: true });
+  }
+
+  stepper.advance();
+
+  // Install dependencies
+  try {
+    execSync('npm install --omit=dev', { cwd: DATA_DIR, stdio: 'ignore' });
+  } catch {}
+  stepper.advance();
+
+  // Rebuild UI if not in tarball
+  if (!fs.existsSync(path.join(distDst, 'onboard.html'))) {
+    try {
+      if (fs.existsSync(distDst)) fs.rmSync(distDst, { recursive: true });
+      execSync('npm run build:fluxy', { cwd: DATA_DIR, stdio: 'ignore' });
+    } catch {}
+  }
+  stepper.advance();
+
+  // Clean up
+  fs.rmSync(tmpDir, { recursive: true, force: true });
+
+  stepper.finish();
+
+  console.log(`\n  ${c.green}${c.bold}✔  Updated to v${latest.version}${c.reset}\n`);
+  console.log(`  ${c.dim}Run ${c.reset}${c.cyan}fluxy start${c.reset}${c.dim} to launch.${c.reset}\n`);
+}
+
 // ── Route ──
 
 switch (command) {
   case 'init':    init(); break;
   case 'start':   start(); break;
   case 'status':  status(); break;
+  case 'update':  update(); break;
   default:
     fs.existsSync(CONFIG_PATH) ? start() : init();
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fluxy-bot",
-  "version": "0.3.27",
-  "description": "Self-hosted AI bot — run your own AI assistant from anywhere",
+  "version": "0.4.0",
+  "description": "Self-hosted, self-evolving AI agent with its own dashboard.",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -20,7 +20,6 @@
     "tsconfig.json",
     "postcss.config.js",
     "components.json",
-    "install.sh",
     "install.ps1"
   ],
   "keywords": [

package/scripts/install

@@ -15,7 +15,9 @@ NODE_DIR="$TOOLS_DIR/node"
 BIN_DIR="$FLUXY_HOME/bin"
 USE_SYSTEM_NODE=false
 
-CYAN='\033[36m'
+# Brand colors: #32A5F7 (blue) and #DB36A3 (pink) via 256-color approximation
+BLUE='\033[38;2;50;165;247m'
+PINK='\033[38;2;219;54;163m'
 GREEN='\033[32m'
 YELLOW='\033[33m'
 RED='\033[31m'
@@ -23,10 +25,14 @@ DIM='\033[2m'
 BOLD='\033[1m'
 RESET='\033[0m'
 
-printf "\n${CYAN}${BOLD}  ╔═══════════════════════════════╗${RESET}\n"
-printf "${CYAN}${BOLD}  ║         FLUXY               ║${RESET}\n"
-printf "${CYAN}${BOLD}  ╚═══════════════════════════════╝${RESET}\n"
-printf "${DIM}  Self-hosted AI bot${RESET}\n\n"
+printf "\n"
+printf "${BLUE}${BOLD}       ___  __                  ${RESET}\n"
+printf "${BLUE}${BOLD}      / _/ / / __  __ __  __ __ ${RESET}\n"
+printf "${PINK}${BOLD}     / _/ / / / / / / \\ \\/ / / / ${RESET}\n"
+printf "${PINK}${BOLD}    /_/  /_/  \\_,_/ /_/\\_\\  /_/  ${RESET}\n"
+printf "\n"
+printf "${DIM}     Self-hosted AI bot installer${RESET}\n"
+printf "${DIM}     ─────────────────────────────${RESET}\n\n"
 
 # ─── Detect platform ────────────────────────────────────────────────────────
 
@@ -85,7 +91,7 @@ install_node() {
     fi
   fi
 
-  printf "  ${CYAN}↓${RESET}  Downloading Node.js v${NODE_VERSION}...\n"
+  printf "  ${BLUE}↓${RESET}  Downloading Node.js v${NODE_VERSION}...\n"
 
   NODE_URL="https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-${PLATFORM}-${NODEARCH}.tar.xz"
   TMPFILE=$(mktemp /tmp/node-XXXXXX.tar.xz)
@@ -128,9 +134,14 @@ install_fluxy() {
     NODE="$NODE_DIR/bin/node"
   fi
 
-  printf "  ${CYAN}↓${RESET}  Installing fluxy...\n"
+  # Fetch version + tarball URL from npm registry
+  NPM_VERSION=$("$NPM" view fluxy-bot version 2>/dev/null || echo "")
+  if [ -n "$NPM_VERSION" ]; then
+    printf "  ${DIM}Latest npm version: fluxy-bot@${NPM_VERSION}${RESET}\n"
+  fi
+
+  printf "  ${BLUE}↓${RESET}  Installing fluxy...\n"
 
-  # Get tarball URL from npm registry
   TARBALL_URL=$("$NPM" view fluxy-bot dist.tarball 2>/dev/null)
   if [ -z "$TARBALL_URL" ]; then
     printf "  ${RED}✗${RESET}  Failed to fetch package info from npm\n"
@@ -154,26 +165,42 @@ install_fluxy() {
     exit 1
   fi
 
-  # Copy source files to ~/.fluxy/ (preserves existing config.json, memory.db, etc.)
-  cp -r "$EXTRACTED"/* "$FLUXY_HOME"/
-  cp -r "$EXTRACTED"/.[!.]* "$FLUXY_HOME"/ 2>/dev/null || true
-  rm -rf "$TMPDIR"
+  # Copy code directories (always safe to overwrite)
+  for dir in bin supervisor worker shared scripts; do
+    [ -d "$EXTRACTED/$dir" ] && cp -r "$EXTRACTED/$dir" "$FLUXY_HOME/"
+  done
 
-  # Install dependencies inside ~/.fluxy/
-  (cd "$FLUXY_HOME" && "$NPM" install --omit=dev 2>/dev/null)
+  # Copy workspace template only on first install (preserves user files)
+  if [ ! -d "$FLUXY_HOME/workspace" ]; then
+    [ -d "$EXTRACTED/workspace" ] && cp -r "$EXTRACTED/workspace" "$FLUXY_HOME/"
+  fi
 
-  # Build chat interface if not pre-built in the tarball
-  if [ -d "$FLUXY_HOME/dist-fluxy" ] && [ -f "$FLUXY_HOME/dist-fluxy/onboard.html" ]; then
+  # Copy code files (never touches config.json, memory.db, etc.)
+  for f in package.json vite.config.ts vite.fluxy.config.ts tsconfig.json postcss.config.js components.json; do
+    [ -f "$EXTRACTED/$f" ] && cp "$EXTRACTED/$f" "$FLUXY_HOME/"
+  done
+
+  # Copy pre-built UI from tarball, or build from source
+  if [ -d "$EXTRACTED/dist-fluxy" ]; then
+    rm -rf "$FLUXY_HOME/dist-fluxy"
+    cp -r "$EXTRACTED/dist-fluxy" "$FLUXY_HOME/"
     printf "  ${GREEN}✔${RESET}  Chat interface ready\n"
-  else
-    printf "  ${CYAN}↓${RESET}  Building chat interface...\n"
+  elif [ ! -f "$FLUXY_HOME/dist-fluxy/onboard.html" ]; then
+    printf "  ${BLUE}↓${RESET}  Building chat interface...\n"
     if (cd "$FLUXY_HOME" && "$NPM" run build:fluxy 2>/dev/null); then
       printf "  ${GREEN}✔${RESET}  Chat interface built\n"
     else
       printf "  ${YELLOW}!${RESET}  Chat build skipped — will build on first start\n"
     fi
+  else
+    printf "  ${GREEN}✔${RESET}  Chat interface ready\n"
   fi
 
+  rm -rf "$TMPDIR"
+
+  # Install dependencies inside ~/.fluxy/
+  (cd "$FLUXY_HOME" && "$NPM" install --omit=dev 2>/dev/null)
+
   # Verify
   if [ ! -f "$FLUXY_HOME/bin/cli.js" ]; then
     printf "  ${RED}✗${RESET}  Installation failed\n"
@@ -270,10 +297,18 @@ install_fluxy
 create_wrapper
 setup_path
 
-printf "\n  ${GREEN}${BOLD}✔  Fluxy is ready!${RESET}\n\n"
-printf "  Get started:\n\n"
-printf "    ${CYAN}fluxy init${RESET}      Set up your bot\n"
-printf "    ${CYAN}fluxy start${RESET}     Start your bot\n"
-printf "    ${CYAN}fluxy status${RESET}    Check if it's running\n\n"
-printf "  ${DIM}Run ${RESET}${CYAN}fluxy init${RESET}${DIM} to begin.${RESET}\n"
-printf "  ${DIM}(Open a new terminal if 'fluxy' isn't found yet)${RESET}\n\n"
+printf "\n"
+printf "  ${GREEN}${BOLD}✔  Fluxy is ready!${RESET}\n"
+printf "\n"
+printf "  ${DIM}─────────────────────────────${RESET}\n"
+printf "  ${BOLD}Get started:${RESET}\n"
+printf "\n"
+printf "    ${BLUE}fluxy init${RESET}      Set up your bot\n"
+printf "    ${BLUE}fluxy start${RESET}     Start your bot\n"
+printf "    ${BLUE}fluxy status${RESET}    Check if it's running\n"
+printf "\n"
+printf "  ${PINK}>${RESET} Run ${BLUE}fluxy init${RESET} to begin.\n"
+printf "  ${DIM}(Open a new terminal if 'fluxy' isn't found yet)${RESET}\n"
+printf "\n"
+printf "  ${DIM}https://fluxy.bot${RESET}\n"
+printf "\n"

package/scripts/install.ps1

@@ -14,11 +14,33 @@ $NODE_DIR = Join-Path $TOOLS_DIR "node"
 $BIN_DIR = Join-Path $FLUXY_HOME "bin"
 $USE_SYSTEM_NODE = $false
 
+# Ensure UTF-8 output for proper rendering
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+# Brand colors via ANSI escape sequences: #32A5F7 (blue) and #DB36A3 (pink)
+$BLUE = "`e[38;2;50;165;247m"
+$PINK = "`e[38;2;219;54;163m"
+$BOLD = "`e[1m"
+$RSET = "`e[0m"
+
+# Use ANSI sequences for consistent rendering; fallback to plain if no VT support
+$vtSupported = $null -ne $env:WT_SESSION -or $PSVersionTable.PSVersion.Major -ge 7 -or $host.UI.SupportsVirtualTerminal
+
 Write-Host ""
-Write-Host "  ╔═══════════════════════════════╗" -ForegroundColor Cyan
-Write-Host "  ║         FLUXY               ║" -ForegroundColor Cyan
-Write-Host "  ╚═══════════════════════════════╝" -ForegroundColor Cyan
-Write-Host "  Self-hosted AI bot" -ForegroundColor DarkGray
+if ($vtSupported) {
+    Write-Host "${BLUE}${BOLD}       ___  __                  ${RSET}"
+    Write-Host "${BLUE}${BOLD}      / _/ / / __  __ __  __ __ ${RSET}"
+    Write-Host "${PINK}${BOLD}     / _/ / / / / / / \ \/ / / / ${RSET}"
+    Write-Host "${PINK}${BOLD}    /_/  /_/  \_,_/ /_/\_\  /_/  ${RSET}"
+} else {
+    Write-Host "       ___  __                  " -ForegroundColor Cyan
+    Write-Host "      / _/ / / __  __ __  __ __ " -ForegroundColor Cyan
+    Write-Host "     / _/ / / / / / / \ \/ / / / " -ForegroundColor Magenta
+    Write-Host "    /_/  /_/  \_,_/ /_/\_\  /_/  " -ForegroundColor Magenta
+}
+Write-Host ""
+Write-Host "     Self-hosted AI bot installer" -ForegroundColor DarkGray
+Write-Host "     -----------------------------" -ForegroundColor DarkGray
 Write-Host ""
 
 # ─── Detect platform ────────────────────────────────────────────────────────
@@ -117,9 +139,15 @@ function Install-Fluxy {
         $NODE_BIN = Join-Path $NODE_DIR "node.exe"
     }
 
+    # Fetch version + tarball URL from npm registry
+    $npmVersion = ""
+    try { $npmVersion = (& $NPM view fluxy-bot version 2>$null).Trim() } catch {}
+    if ($npmVersion) {
+        Write-Host "  Latest npm version: fluxy-bot@${npmVersion}" -ForegroundColor DarkGray
+    }
+
     Write-Host "  ↓  Installing fluxy..." -ForegroundColor Cyan
 
-    # Get tarball URL from npm registry
     $tarballUrl = (& $NPM view fluxy-bot dist.tarball 2>$null).Trim()
     if (-not $tarballUrl) {
         Write-Host "  ✗  Failed to fetch package info from npm" -ForegroundColor Red
@@ -142,10 +170,52 @@ function Install-Fluxy {
             exit 1
         }
 
-        # Copy source files to ~/.fluxy/ (preserves existing config.json, memory.db, etc.)
         New-Item -ItemType Directory -Path $FLUXY_HOME -Force | Out-Null
-        Get-ChildItem -Path $extracted -Force | ForEach-Object {
-            Copy-Item -Path $_.FullName -Destination $FLUXY_HOME -Recurse -Force
+
+        # Copy code directories (always safe to overwrite)
+        foreach ($dir in @("bin", "supervisor", "worker", "shared", "scripts")) {
+            $src = Join-Path $extracted $dir
+            if (Test-Path $src) {
+                Copy-Item -Path $src -Destination $FLUXY_HOME -Recurse -Force
+            }
+        }
+
+        # Copy workspace template only on first install (preserves user files)
+        $wsDst = Join-Path $FLUXY_HOME "workspace"
+        if (-not (Test-Path $wsDst)) {
+            $wsSrc = Join-Path $extracted "workspace"
+            if (Test-Path $wsSrc) {
+                Copy-Item -Path $wsSrc -Destination $FLUXY_HOME -Recurse
+            }
+        }
+
+        # Copy code files (never touches config.json, memory.db, etc.)
+        foreach ($file in @("package.json", "vite.config.ts", "vite.fluxy.config.ts", "tsconfig.json", "postcss.config.js", "components.json")) {
+            $src = Join-Path $extracted $file
+            if (Test-Path $src) {
+                Copy-Item -Path $src -Destination (Join-Path $FLUXY_HOME $file) -Force
+            }
+        }
+
+        # Copy pre-built UI from tarball, or build from source
+        $distSrc = Join-Path $extracted "dist-fluxy"
+        $distDst = Join-Path $FLUXY_HOME "dist-fluxy"
+        if (Test-Path $distSrc) {
+            if (Test-Path $distDst) { Remove-Item $distDst -Recurse -Force }
+            Copy-Item -Path $distSrc -Destination $distDst -Recurse
+            Write-Host "  ✔  Chat interface ready" -ForegroundColor Green
+        } elseif (-not (Test-Path (Join-Path $distDst "onboard.html"))) {
+            Write-Host "  ↓  Building chat interface..." -ForegroundColor Cyan
+            Push-Location $FLUXY_HOME
+            try {
+                & $NPM run build:fluxy 2>$null
+                Write-Host "  ✔  Chat interface built" -ForegroundColor Green
+            } catch {
+                Write-Host "  !  Chat build failed — will build on first start" -ForegroundColor Yellow
+            }
+            Pop-Location
+        } else {
+            Write-Host "  ✔  Chat interface ready" -ForegroundColor Green
         }
     } finally {
         Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
@@ -156,21 +226,6 @@ function Install-Fluxy {
     try {
         & $NPM install --omit=dev 2>$null
     } catch {}
-
-    # Build fluxy chat + onboard (served as static files)
-    $distFluxy = Join-Path $FLUXY_HOME "dist-fluxy"
-    $onboardHtml = Join-Path $distFluxy "onboard.html"
-    if ((Test-Path $distFluxy) -and (Test-Path $onboardHtml)) {
-        Write-Host "  ✔  Chat interface (pre-built)" -ForegroundColor Green
-    } else {
-        Write-Host "  ↓  Building chat interface..." -ForegroundColor Cyan
-        try {
-            & $NPM run build:fluxy 2>$null
-            Write-Host "  ✔  Chat interface built" -ForegroundColor Green
-        } catch {
-            Write-Host "  !  Chat interface build failed — it will be built on first start" -ForegroundColor Yellow
-        }
-    }
     Pop-Location
 
     # Verify
@@ -240,14 +295,18 @@ Setup-Path
 Write-Host ""
 Write-Host "  ✔  Fluxy is ready!" -ForegroundColor Green
 Write-Host ""
-Write-Host "  Get started:"
+Write-Host "  -----------------------------" -ForegroundColor DarkGray
+Write-Host "  Get started:" -NoNewline; Write-Host ""
 Write-Host ""
 Write-Host "    fluxy init      " -ForegroundColor Cyan -NoNewline; Write-Host "Set up your bot"
 Write-Host "    fluxy start     " -ForegroundColor Cyan -NoNewline; Write-Host "Start your bot"
 Write-Host "    fluxy status    " -ForegroundColor Cyan -NoNewline; Write-Host "Check if it's running"
 Write-Host ""
-Write-Host "  Run " -ForegroundColor DarkGray -NoNewline
+Write-Host "  > " -ForegroundColor Magenta -NoNewline
+Write-Host "Run " -NoNewline
 Write-Host "fluxy init" -ForegroundColor Cyan -NoNewline
-Write-Host " to begin." -ForegroundColor DarkGray
+Write-Host " to begin."
 Write-Host "  (Open a new terminal if 'fluxy' isn't found yet)" -ForegroundColor DarkGray
 Write-Host ""
+Write-Host "  https://fluxy.bot" -ForegroundColor DarkGray
+Write-Host ""

package/scripts/install.sh

@@ -15,7 +15,9 @@ NODE_DIR="$TOOLS_DIR/node"
 BIN_DIR="$FLUXY_HOME/bin"
 USE_SYSTEM_NODE=false
 
-CYAN='\033[36m'
+# Brand colors: #32A5F7 (blue) and #DB36A3 (pink) via 256-color approximation
+BLUE='\033[38;2;50;165;247m'
+PINK='\033[38;2;219;54;163m'
 GREEN='\033[32m'
 YELLOW='\033[33m'
 RED='\033[31m'
@@ -23,10 +25,14 @@ DIM='\033[2m'
 BOLD='\033[1m'
 RESET='\033[0m'
 
-printf "\n${CYAN}${BOLD}  ╔═══════════════════════════════╗${RESET}\n"
-printf "${CYAN}${BOLD}  ║         FLUXY               ║${RESET}\n"
-printf "${CYAN}${BOLD}  ╚═══════════════════════════════╝${RESET}\n"
-printf "${DIM}  Self-hosted AI bot${RESET}\n\n"
+printf "\n"
+printf "${BLUE}${BOLD}       ___  __                  ${RESET}\n"
+printf "${BLUE}${BOLD}      / _/ / / __  __ __  __ __ ${RESET}\n"
+printf "${PINK}${BOLD}     / _/ / / / / / / \\ \\/ / / / ${RESET}\n"
+printf "${PINK}${BOLD}    /_/  /_/  \\_,_/ /_/\\_\\  /_/  ${RESET}\n"
+printf "\n"
+printf "${DIM}     Self-hosted AI bot installer${RESET}\n"
+printf "${DIM}     ─────────────────────────────${RESET}\n\n"
 
 # ─── Detect platform ────────────────────────────────────────────────────────
 
@@ -85,7 +91,7 @@ install_node() {
     fi
   fi
 
-  printf "  ${CYAN}↓${RESET}  Downloading Node.js v${NODE_VERSION}...\n"
+  printf "  ${BLUE}↓${RESET}  Downloading Node.js v${NODE_VERSION}...\n"
 
   NODE_URL="https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-${PLATFORM}-${NODEARCH}.tar.xz"
   TMPFILE=$(mktemp /tmp/node-XXXXXX.tar.xz)
@@ -128,9 +134,14 @@ install_fluxy() {
     NODE="$NODE_DIR/bin/node"
   fi
 
-  printf "  ${CYAN}↓${RESET}  Installing fluxy...\n"
+  # Fetch version + tarball URL from npm registry
+  NPM_VERSION=$("$NPM" view fluxy-bot version 2>/dev/null || echo "")
+  if [ -n "$NPM_VERSION" ]; then
+    printf "  ${DIM}Latest npm version: fluxy-bot@${NPM_VERSION}${RESET}\n"
+  fi
+
+  printf "  ${BLUE}↓${RESET}  Installing fluxy...\n"
 
-  # Get tarball URL from npm registry
   TARBALL_URL=$("$NPM" view fluxy-bot dist.tarball 2>/dev/null)
   if [ -z "$TARBALL_URL" ]; then
     printf "  ${RED}✗${RESET}  Failed to fetch package info from npm\n"
@@ -154,26 +165,42 @@ install_fluxy() {
     exit 1
   fi
 
-  # Copy source files to ~/.fluxy/ (preserves existing config.json, memory.db, etc.)
-  cp -r "$EXTRACTED"/* "$FLUXY_HOME"/
-  cp -r "$EXTRACTED"/.[!.]* "$FLUXY_HOME"/ 2>/dev/null || true
-  rm -rf "$TMPDIR"
+  # Copy code directories (always safe to overwrite)
+  for dir in bin supervisor worker shared scripts; do
+    [ -d "$EXTRACTED/$dir" ] && cp -r "$EXTRACTED/$dir" "$FLUXY_HOME/"
+  done
 
-  # Install dependencies inside ~/.fluxy/
-  (cd "$FLUXY_HOME" && "$NPM" install --omit=dev 2>/dev/null)
+  # Copy workspace template only on first install (preserves user files)
+  if [ ! -d "$FLUXY_HOME/workspace" ]; then
+    [ -d "$EXTRACTED/workspace" ] && cp -r "$EXTRACTED/workspace" "$FLUXY_HOME/"
+  fi
 
-  # Build chat interface if not pre-built in the tarball
-  if [ -d "$FLUXY_HOME/dist-fluxy" ] && [ -f "$FLUXY_HOME/dist-fluxy/onboard.html" ]; then
+  # Copy code files (never touches config.json, memory.db, etc.)
+  for f in package.json vite.config.ts vite.fluxy.config.ts tsconfig.json postcss.config.js components.json; do
+    [ -f "$EXTRACTED/$f" ] && cp "$EXTRACTED/$f" "$FLUXY_HOME/"
+  done
+
+  # Copy pre-built UI from tarball, or build from source
+  if [ -d "$EXTRACTED/dist-fluxy" ]; then
+    rm -rf "$FLUXY_HOME/dist-fluxy"
+    cp -r "$EXTRACTED/dist-fluxy" "$FLUXY_HOME/"
     printf "  ${GREEN}✔${RESET}  Chat interface ready\n"
-  else
-    printf "  ${CYAN}↓${RESET}  Building chat interface...\n"
+  elif [ ! -f "$FLUXY_HOME/dist-fluxy/onboard.html" ]; then
+    printf "  ${BLUE}↓${RESET}  Building chat interface...\n"
     if (cd "$FLUXY_HOME" && "$NPM" run build:fluxy 2>/dev/null); then
       printf "  ${GREEN}✔${RESET}  Chat interface built\n"
     else
       printf "  ${YELLOW}!${RESET}  Chat build skipped — will build on first start\n"
     fi
+  else
+    printf "  ${GREEN}✔${RESET}  Chat interface ready\n"
   fi
 
+  rm -rf "$TMPDIR"
+
+  # Install dependencies inside ~/.fluxy/
+  (cd "$FLUXY_HOME" && "$NPM" install --omit=dev 2>/dev/null)
+
   # Verify
   if [ ! -f "$FLUXY_HOME/bin/cli.js" ]; then
     printf "  ${RED}✗${RESET}  Installation failed\n"
@@ -270,10 +297,18 @@ install_fluxy
 create_wrapper
 setup_path
 
-printf "\n  ${GREEN}${BOLD}✔  Fluxy is ready!${RESET}\n\n"
-printf "  Get started:\n\n"
-printf "    ${CYAN}fluxy init${RESET}      Set up your bot\n"
-printf "    ${CYAN}fluxy start${RESET}     Start your bot\n"
-printf "    ${CYAN}fluxy status${RESET}    Check if it's running\n\n"
-printf "  ${DIM}Run ${RESET}${CYAN}fluxy init${RESET}${DIM} to begin.${RESET}\n"
-printf "  ${DIM}(Open a new terminal if 'fluxy' isn't found yet)${RESET}\n\n"
+printf "\n"
+printf "  ${GREEN}${BOLD}✔  Fluxy is ready!${RESET}\n"
+printf "\n"
+printf "  ${DIM}─────────────────────────────${RESET}\n"
+printf "  ${BOLD}Get started:${RESET}\n"
+printf "\n"
+printf "    ${BLUE}fluxy init${RESET}      Set up your bot\n"
+printf "    ${BLUE}fluxy start${RESET}     Start your bot\n"
+printf "    ${BLUE}fluxy status${RESET}    Check if it's running\n"
+printf "\n"
+printf "  ${PINK}>${RESET} Run ${BLUE}fluxy init${RESET} to begin.\n"
+printf "  ${DIM}(Open a new terminal if 'fluxy' isn't found yet)${RESET}\n"
+printf "\n"
+printf "  ${DIM}https://fluxy.bot${RESET}\n"
+printf "\n"

package/scripts/postinstall.js

@@ -28,23 +28,30 @@ if (fs.existsSync(path.join(PKG_ROOT, '.git'))) {
 
 fs.mkdirSync(FLUXY_HOME, { recursive: true });
 
-const DIRS_TO_COPY = [
-  'bin', 'supervisor', 'worker', 'shared', 'workspace', 'scripts',
-];
+// Code directories — always overwrite (these are application code)
+const CODE_DIRS = ['bin', 'supervisor', 'worker', 'shared', 'scripts'];
 
-const FILES_TO_COPY = [
+// Code files — always overwrite
+const CODE_FILES = [
   'package.json', 'vite.config.ts', 'vite.fluxy.config.ts',
   'tsconfig.json', 'postcss.config.js', 'components.json',
 ];
 
-for (const dir of DIRS_TO_COPY) {
+for (const dir of CODE_DIRS) {
   const src = path.join(PKG_ROOT, dir);
   if (!fs.existsSync(src)) continue;
   const dst = path.join(FLUXY_HOME, dir);
   fs.cpSync(src, dst, { recursive: true, force: true });
 }
 
-for (const file of FILES_TO_COPY) {
+// Workspace template — only on first install (preserves user files, uploads, etc.)
+const wsSrc = path.join(PKG_ROOT, 'workspace');
+const wsDst = path.join(FLUXY_HOME, 'workspace');
+if (fs.existsSync(wsSrc) && !fs.existsSync(wsDst)) {
+  fs.cpSync(wsSrc, wsDst, { recursive: true });
+}
+
+for (const file of CODE_FILES) {
   const src = path.join(PKG_ROOT, file);
   if (!fs.existsSync(src)) continue;
   fs.copyFileSync(src, path.join(FLUXY_HOME, file));
@@ -61,10 +68,15 @@ try {
   // Non-fatal: deps may already exist from a previous install
 }
 
-// ── Build fluxy chat + onboard (served as static files) ──
+// ── Copy pre-built UI if available, otherwise build ──
 
-const distFluxy = path.join(FLUXY_HOME, 'dist-fluxy', 'onboard.html');
-if (!fs.existsSync(distFluxy)) {
+const distSrc = path.join(PKG_ROOT, 'dist-fluxy');
+const distDst = path.join(FLUXY_HOME, 'dist-fluxy');
+if (fs.existsSync(distSrc)) {
+  // Always use the pre-built UI from the package (handles updates)
+  if (fs.existsSync(distDst)) fs.rmSync(distDst, { recursive: true });
+  fs.cpSync(distSrc, distDst, { recursive: true });
+} else if (!fs.existsSync(path.join(distDst, 'onboard.html'))) {
   try {
     execSync('npm run build:fluxy', {
       cwd: FLUXY_HOME,