release: merge develop into main for v0.18.3

Author: DavidsonGomes

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.18.3] - 2026-04-12
+
+### Added
+
+- **CLI update mode** — `npx @evoapi/evo-nexus@latest .` now detects existing installations and runs pull + rebuild + restart instead of failing with "directory already exists". Stops services before pull, rebuilds frontend, restarts via `start-services.sh`
+- **Backup import** — new "Importar" button in Backups page to upload external `.zip` backup files into the local backups list. Validates ZIP integrity before accepting
+- **S3-compatible storage support** — added `AWS_ENDPOINT_URL` and `BACKUP_S3_PREFIX` fields to the backup Storage Provider config panel for Cloudflare R2, Backblaze B2, MinIO, and any S3-compatible provider
+
+### Fixed
+
+- **`npx @evoapi/evo-nexus .` on existing repo** — no longer crashes with "fatal: destination path '.' already exists". Auto-detects `.git` + `pyproject.toml` and switches to update flow
+- **S3 client for non-AWS providers** — boto3 client now uses `AWS_ENDPOINT_URL` when set, enabling R2/Backblaze/MinIO connectivity
+
 ## [0.18.2] - 2026-04-12
 
 ### Added

cli/bin/cli.mjs

@@ -133,7 +133,43 @@ async function main() {
   const targetDir = filteredArgs[0] || ".";
   const targetPath = resolve(process.cwd(), targetDir);
 
-  if (targetDir === ".") {
+  // Detect if target is an existing EvoNexus installation (git repo with pyproject.toml)
+  const isExistingInstall = existsSync(resolve(targetPath, ".git")) && existsSync(resolve(targetPath, "pyproject.toml"));
+
+  if (isExistingInstall) {
+    // ── Update mode ─────────────────────────────
+    console.log(`  ${GREEN}Existing EvoNexus installation detected.${RESET}\n`);
+
+    // Show current version
+    try {
+      const { readFileSync } = await import("fs");
+      const pyproject = readFileSync(resolve(targetPath, "pyproject.toml"), "utf-8");
+      const match = pyproject.match(/^version\s*=\s*"([^"]+)"/m);
+      if (match) console.log(`  Current version: ${DIM}${match[1]}${RESET}`);
+    } catch {}
+
+    // Stop running services before updating
+    console.log(`  ${DIM}Stopping services...${RESET}`);
+    try { run("pkill -f 'terminal-server/bin/server.js' 2>/dev/null || true", { cwd: targetPath }); } catch {}
+    try { run("pkill -f 'app.py' 2>/dev/null || true", { cwd: targetPath }); } catch {}
+
+    // Pull latest
+    console.log(`\n  ${BOLD}Pulling latest changes...${RESET}\n`);
+    run("git fetch origin", { cwd: targetPath });
+    // Detect current branch
+    const branch = execSync("git rev-parse --abbrev-ref HEAD", { cwd: targetPath, encoding: "utf-8" }).trim();
+    run(`git pull origin ${branch}`, { cwd: targetPath });
+
+    // Show new version
+    try {
+      const { readFileSync } = await import("fs");
+      const pyproject = readFileSync(resolve(targetPath, "pyproject.toml"), "utf-8");
+      const match = pyproject.match(/^version\s*=\s*"([^"]+)"/m);
+      if (match) console.log(`\n  Updated to: ${GREEN}${BOLD}${match[1]}${RESET}`);
+    } catch {}
+
+    console.log();
+  } else if (targetDir === ".") {
     // Clone into current directory
     const { readdirSync } = await import("fs");
     const files = readdirSync(targetPath).filter(f => !f.startsWith("."));
@@ -176,7 +212,36 @@ async function main() {
     console.log(`\n  ${GREEN}✓${RESET} Frontend dependencies installed`);
   }
 
-  // ── Run setup wizard ───────────────────────
+  // ── Update mode: rebuild + restart, skip setup wizard ─────
+  if (isExistingInstall) {
+    console.log(`\n  ${DIM}Building dashboard frontend...${RESET}`);
+    try {
+      run("npm run build --silent", { cwd: frontendDir });
+      console.log(`  ${GREEN}✓${RESET} Dashboard rebuilt`);
+    } catch {
+      console.log(`  ${YELLOW}!${RESET} Frontend build failed — run: cd dashboard/frontend && npm run build`);
+    }
+
+    // Restart services if start-services.sh exists
+    const startScript = resolve(targetPath, "start-services.sh");
+    if (existsSync(startScript)) {
+      console.log(`\n  ${DIM}Restarting services...${RESET}`);
+      run(`bash ${startScript}`, { cwd: targetPath });
+      // Wait and verify
+      await new Promise(r => setTimeout(r, 3000));
+      try {
+        execSync("curl -sf http://localhost:8080/api/version", { timeout: 5000 });
+        console.log(`  ${GREEN}✓${RESET} Dashboard restarted`);
+      } catch {
+        console.log(`  ${YELLOW}!${RESET} Dashboard may not have started — check logs/dashboard.log`);
+      }
+    }
+
+    console.log(`\n  ${GREEN}${BOLD}EvoNexus updated successfully!${RESET}\n`);
+    process.exit(0);
+  }
+
+  // ── Run setup wizard (fresh install only) ─────
   console.log(`\n  ${BOLD}Starting setup wizard...${RESET}\n`);
 
   const pythonCmd = check("uv --version") ? "uv run python" : "python3";

cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evoapi/evo-nexus",
-  "version": "0.18.2",
+  "version": "0.18.3",
   "description": "Unofficial open source toolkit for Claude Code — AI-powered business operating system",
   "keywords": [
     "claude-code",

dashboard/backend/routes/backups.py

@@ -158,6 +158,49 @@ def delete_backup(filename):
     return jsonify({"status": "deleted"})
 
 
+@bp.route("/api/backups/upload", methods=["POST"])
+def upload_backup():
+    """Import an external backup ZIP file into the local backups directory."""
+    denied = _require("config", "manage")
+    if denied:
+        return denied
+
+    if "file" not in request.files:
+        return jsonify({"error": "No file uploaded"}), 400
+
+    f = request.files["file"]
+    if not f.filename or not f.filename.endswith(".zip"):
+        return jsonify({"error": "Only .zip files are accepted"}), 400
+
+    # Sanitize filename
+    import re
+    safe_name = re.sub(r"[^\w\-.]", "_", f.filename)
+    BACKUPS_DIR.mkdir(parents=True, exist_ok=True)
+    dest = BACKUPS_DIR / safe_name
+
+    # Prevent overwrite
+    if dest.exists():
+        return jsonify({"error": f"File {safe_name} already exists"}), 409
+
+    f.save(str(dest))
+
+    # Validate it's a real ZIP
+    import zipfile
+    try:
+        with zipfile.ZipFile(dest, "r") as zf:
+            zf.testzip()
+    except (zipfile.BadZipFile, Exception):
+        dest.unlink()
+        return jsonify({"error": "Invalid ZIP file"}), 400
+
+    audit(current_user, "upload", "backups", f"Imported backup {safe_name} ({dest.stat().st_size} bytes)")
+    return jsonify({
+        "status": "uploaded",
+        "filename": safe_name,
+        "size": dest.stat().st_size,
+    }), 201
+
+
 @bp.route("/api/backups/s3")
 def list_s3_backups():
     """List backup files stored in S3."""
@@ -175,7 +218,8 @@ def list_s3_backups():
         return jsonify({"backups": [], "error": "boto3 not installed"})
 
     try:
-        s3 = boto3.client("s3")
+        endpoint_url = os.environ.get("AWS_ENDPOINT_URL")
+        s3 = boto3.client("s3", endpoint_url=endpoint_url) if endpoint_url else boto3.client("s3")
         prefix = os.environ.get("BACKUP_S3_PREFIX", "")
         response = s3.list_objects_v2(Bucket=bucket, Prefix=prefix)
         backups = []
@@ -208,7 +252,8 @@ def download_s3_backup(key):
 
     try:
         import boto3
-        s3 = boto3.client("s3")
+        endpoint_url = os.environ.get("AWS_ENDPOINT_URL")
+        s3 = boto3.client("s3", endpoint_url=endpoint_url) if endpoint_url else boto3.client("s3")
         filename = key.rsplit("/", 1)[-1]
         local_path = BACKUPS_DIR / filename
         BACKUPS_DIR.mkdir(parents=True, exist_ok=True)

dashboard/frontend/src/pages/Backups.tsx

@@ -2,7 +2,7 @@ import { useState, useEffect, useCallback } from 'react'
 import {
   HardDriveDownload, Plus, Download, RotateCcw, Trash2, RefreshCw,
   Cloud, HardDrive, AlertCircle, CheckCircle, Loader2, FileArchive,
-  ChevronDown, Eye, EyeOff, Save,
+  ChevronDown, Eye, EyeOff, Save, Upload,
 } from 'lucide-react'
 import { api } from '../lib/api'
 
@@ -48,7 +48,9 @@ const S3_FIELDS = [
   { envKey: 'BACKUP_S3_BUCKET', label: 'S3 Bucket', hint: 'Nome do bucket (ex: my-backups)', required: true, sensitive: false },
   { envKey: 'AWS_ACCESS_KEY_ID', label: 'Access Key ID', hint: 'IAM access key', required: true, sensitive: true },
   { envKey: 'AWS_SECRET_ACCESS_KEY', label: 'Secret Access Key', hint: 'IAM secret key', required: true, sensitive: true },
-  { envKey: 'AWS_DEFAULT_REGION', label: 'Region', hint: 'ex: us-east-1, sa-east-1', required: false, sensitive: false },
+  { envKey: 'AWS_DEFAULT_REGION', label: 'Region', hint: 'ex: us-east-1, sa-east-1, auto', required: false, sensitive: false },
+  { envKey: 'AWS_ENDPOINT_URL', label: 'Endpoint URL', hint: 'Para R2, Backblaze, MinIO (ex: https://xxx.r2.cloudflarestorage.com)', required: false, sensitive: false },
+  { envKey: 'BACKUP_S3_PREFIX', label: 'Prefix', hint: 'Prefixo das chaves no bucket (ex: backups/evonexus/)', required: false, sensitive: false },
 ]
 
 function S3ConfigPanel({ config, onSaved }: { config: BackupConfig; onSaved: () => void }) {
@@ -142,7 +144,8 @@ function S3ConfigPanel({ config, onSaved }: { config: BackupConfig; onSaved: ()
       {expanded && (
         <div className="px-4 pb-4 border-t border-[#21262d]">
           <p className="text-xs text-[#667085] mt-3 mb-4">
-            Configure S3 para backup remoto. Deixe vazio para usar apenas backup local.
+            Configure S3 para backup remoto. Compatível com AWS S3, Cloudflare R2, Backblaze B2, MinIO e qualquer storage S3-compatível.
+            Para providers não-AWS, preencha o <strong>Endpoint URL</strong>. Deixe tudo vazio para usar apenas backup local.
           </p>
           <div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
             {S3_FIELDS.map(field => {
@@ -216,6 +219,8 @@ export default function Backups() {
   const [jobStatus, setJobStatus] = useState<string>('idle')
   const [showRestoreModal, setShowRestoreModal] = useState<string | null>(null)
   const [restoreMode, setRestoreMode] = useState<'merge' | 'replace'>('merge')
+  const [uploading, setUploading] = useState(false)
+  const uploadRef = { current: null as HTMLInputElement | null }
 
   const fetchS3 = useCallback(async () => {
     setS3Loading(true)
@@ -303,8 +308,48 @@ export default function Backups() {
     }
   }
 
+  const handleUpload = async (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0]
+    if (!file) return
+    e.target.value = '' // Reset input
+    if (!file.name.endsWith('.zip')) {
+      alert('Apenas arquivos .zip são aceitos')
+      return
+    }
+    setUploading(true)
+    try {
+      const formData = new FormData()
+      formData.append('file', file)
+      const base = import.meta.env.DEV ? 'http://localhost:8080' : ''
+      const res = await fetch(`${base}/api/backups/upload`, {
+        method: 'POST',
+        credentials: 'include',
+        body: formData,
+      })
+      if (!res.ok) {
+        const data = await res.json().catch(() => ({}))
+        alert(data.error || 'Erro ao importar backup')
+        return
+      }
+      fetchData()
+    } catch {
+      alert('Erro ao importar backup')
+    } finally {
+      setUploading(false)
+    }
+  }
+
   return (
     <div>
+      {/* Hidden file input for import */}
+      <input
+        ref={el => { uploadRef.current = el }}
+        type="file"
+        accept=".zip"
+        onChange={handleUpload}
+        className="hidden"
+      />
+
       {/* Header */}
       <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-4 mb-6">
         <div className="flex items-center gap-3">
@@ -323,6 +368,14 @@ export default function Backups() {
           >
             <RefreshCw size={16} />
           </button>
+          <button
+            onClick={() => uploadRef.current?.click()}
+            disabled={uploading}
+            className="flex items-center gap-2 px-4 py-2 rounded-lg border border-[#21262d] text-[#D0D5DD] hover:bg-[#161b22] transition-colors text-sm disabled:opacity-50"
+          >
+            {uploading ? <Loader2 size={16} className="animate-spin" /> : <Upload size={16} />}
+            {uploading ? 'Importando...' : 'Importar'}
+          </button>
           {config?.s3_configured && config?.boto3_available && (
             <button
               onClick={() => handleBackup('s3')}

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "evo-nexus"
-version = "0.18.2"
+version = "0.18.3"
 description = "Unofficial open source toolkit for Claude Code — AI-powered business operating system"
 requires-python = ">=3.10"
 dependencies = [