release: v0.18.2 — setup nginx fix + CLI remote mode detection + make uninstall

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

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.2] - 2026-04-12
+
+### Added
+
+- **`make uninstall`** — full cleanup command that stops services, removes nginx config, data, deps, and config files. Requires typing "UNINSTALL" to confirm
+- **`make stop`** — stops all EvoNexus services (dashboard + terminal-server)
+
+### Fixed
+
+- **Setup nginx config not persisting** — now removes both `default` and `default.conf`, uses `systemctl reload` instead of `start`, shows clear error with fix command if `nginx -t` fails
+- **CLI showing wrong instructions for VPS** — `npx @evoapi/evo-nexus` now detects remote mode (nginx config present) and shows `./start-services.sh` instead of `make dashboard-app`. Skips redundant frontend build when setup already built it
+- **CLI redundant `npm run build`** — no longer rebuilds frontend after setup already did, avoiding "port already in use" cascade when services were already running
+
 ## [0.18.1] - 2026-04-12
 
 ### Added

Makefile

@@ -126,6 +126,44 @@ terminal-stop:      ## 🛑 Stop terminal-server (if orphaned)
 	@pkill -f "dashboard/terminal-server/bin/server.js" 2>/dev/null && echo "✅ terminal-server stopped" || echo "ℹ terminal-server not running"
 	@rm -f /tmp/terminal-server.pid
 
+stop:               ## 🛑 Stop all EvoNexus services (dashboard + terminal-server)
+	@echo "Stopping EvoNexus services..."
+	@pkill -f "dashboard/terminal-server/bin/server.js" 2>/dev/null || true
+	@pkill -f "dashboard/backend.*app.py" 2>/dev/null || true
+	@pkill -f "app.py" 2>/dev/null || true
+	@echo "✅ All services stopped"
+
+uninstall:          ## 🗑️  Full cleanup — stop services, remove nginx, data, deps (DESTRUCTIVE)
+	@echo ""
+	@echo "⚠  This will STOP all services and DELETE:"
+	@echo "   • dashboard/data/ (SQLite database)"
+	@echo "   • dashboard/frontend/node_modules/"
+	@echo "   • dashboard/terminal-server/node_modules/"
+	@echo "   • .venv/ (Python virtual environment)"
+	@echo "   • logs/"
+	@echo "   • config/workspace.yaml, config/providers.json"
+	@echo "   • /etc/nginx/sites-enabled/evonexus"
+	@echo ""
+	@read -p "  Type 'UNINSTALL' to confirm: " confirm; \
+	if [ "$$confirm" = "UNINSTALL" ]; then \
+		echo ""; \
+		echo "Stopping services..."; \
+		pkill -f "dashboard/terminal-server/bin/server.js" 2>/dev/null || true; \
+		pkill -f "dashboard/backend.*app.py" 2>/dev/null || true; \
+		pkill -f "app.py" 2>/dev/null || true; \
+		echo "Removing nginx config..."; \
+		rm -f /etc/nginx/sites-enabled/evonexus 2>/dev/null || true; \
+		systemctl reload nginx 2>/dev/null || true; \
+		echo "Removing generated files..."; \
+		rm -rf dashboard/data/ dashboard/frontend/node_modules/ dashboard/frontend/dist/ dashboard/terminal-server/node_modules/ .venv/ logs/ start-services.sh; \
+		rm -f config/workspace.yaml config/providers.json config/routines.yaml .env; \
+		rm -f CLAUDE.md; \
+		echo ""; \
+		echo "✅ EvoNexus uninstalled. Run 'make setup' to reinstall."; \
+	else \
+		echo "Aborted."; \
+	fi
+
 bling-auth:         ## 🔐 Bling OAuth2 login (one-time: capture access + refresh tokens into .env)
 	@python3 .claude/skills/int-bling/scripts/bling_auth.py
 

cli/bin/cli.mjs

@@ -187,28 +187,49 @@ async function main() {
 
   setup.on("close", (code) => {
     if (code === 0) {
-      // Build frontend
-      console.log(`\n  ${DIM}Building dashboard frontend...${RESET}`);
+      // Check if setup ran in remote mode (services already started)
+      let isRemote = false;
       try {
-        run("npm run build --silent", { cwd: frontendDir });
-        console.log(`  ${GREEN}✓${RESET} Dashboard built\n`);
-      } catch {
-        console.log(`  ${YELLOW}!${RESET} Frontend build failed — run manually: cd ${targetDir}/dashboard/frontend && npm run build\n`);
+        isRemote = existsSync("/etc/nginx/sites-enabled/evonexus");
+      } catch {}
+
+      if (!isRemote) {
+        // Local mode: build frontend (setup already built, but ensure latest)
+        console.log(`\n  ${DIM}Building dashboard frontend...${RESET}`);
+        try {
+          run("npm run build --silent", { cwd: frontendDir });
+          console.log(`  ${GREEN}✓${RESET} Dashboard built\n`);
+        } catch {
+          console.log(`  ${YELLOW}!${RESET} Frontend build failed — run manually: cd ${targetDir}/dashboard/frontend && npm run build\n`);
+        }
       }
 
       console.log(`
   ${GREEN}${BOLD}EvoNexus installed successfully!${RESET}
+`);
+
+      if (isRemote) {
+        // Remote mode: services already running, don't suggest make dashboard-app
+        console.log(`  ${BOLD}The dashboard is already running.${RESET}
+  Open the URL shown above to create your admin account.
 
-  ${BOLD}Next steps:${RESET}
+  ${BOLD}Useful commands:${RESET}
+  ${CYAN}•${RESET} ${BOLD}./start-services.sh${RESET}  — restart dashboard services
+  ${CYAN}•${RESET} ${BOLD}make scheduler${RESET}       — start automated routines
+  ${CYAN}•${RESET} ${BOLD}make help${RESET}            — see all available commands
+`);
+      } else {
+        console.log(`  ${BOLD}Next steps:${RESET}
   ${CYAN}1.${RESET} cd ${targetDir}
   ${CYAN}2.${RESET} Edit ${BOLD}.env${RESET} with your API keys
   ${CYAN}3.${RESET} ${BOLD}make dashboard-app${RESET}    — start the dashboard
   ${CYAN}4.${RESET} Open ${BOLD}http://localhost:8080${RESET} and create your admin account
   ${CYAN}5.${RESET} ${BOLD}make help${RESET}             — see all available commands
-
-  ${DIM}Documentation: https://evonexus.evolutionfoundation.com.br/docs${RESET}
-  ${DIM}GitHub: https://github.com/EvolutionAPI/evo-nexus${RESET}
 `);
+      }
+
+      console.log(`  ${DIM}Documentation: https://evonexus.evolutionfoundation.com.br/docs${RESET}`);
+      console.log(`  ${DIM}GitHub: https://github.com/EvolutionAPI/evo-nexus${RESET}\n`);
     } else {
       console.log(`\n  ${RED}Setup failed (exit code ${code}).${RESET}`);
       console.log(`  ${DIM}Try running manually: cd ${targetDir} && make setup${RESET}\n`);

cli/package.json

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

pyproject.toml

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

setup.py

@@ -297,17 +297,31 @@ def configure_access() -> dict:
 """
     try:
         # Remove default nginx site if exists
-        if os.path.exists("/etc/nginx/sites-enabled/default"):
-            os.remove("/etc/nginx/sites-enabled/default")
+        for default_site in ["/etc/nginx/sites-enabled/default", "/etc/nginx/conf.d/default.conf"]:
+            if os.path.exists(default_site):
+                os.remove(default_site)
+                print(f"  {GREEN}✓{RESET} Removed nginx default site")
 
         nginx_path = "/etc/nginx/sites-enabled/evonexus"
         with open(nginx_path, "w") as f:
             f.write(nginx_config)
-        ret = os.system("nginx -t 2>/dev/null && systemctl start nginx 2>/dev/null && systemctl enable nginx 2>/dev/null")
+
+        # Test nginx config
+        ret = os.system("nginx -t 2>/tmp/nginx-test.log")
         if ret == 0:
+            os.system("systemctl reload nginx 2>/dev/null || systemctl start nginx 2>/dev/null")
+            os.system("systemctl enable nginx 2>/dev/null")
             print(f"  {GREEN}✓{RESET} Nginx configured for {domain}")
         else:
-            print(f"  {YELLOW}!{RESET} Nginx config written but start failed — check manually")
+            # nginx -t failed — likely SSL cert issue. Show the error clearly.
+            print(f"  {RED}✗{RESET} Nginx config test failed")
+            os.system("cat /tmp/nginx-test.log 2>/dev/null")
+            print(f"    {YELLOW}The config is saved at {nginx_path}{RESET}")
+            print(f"    {YELLOW}Fix the issue and run: nginx -t && systemctl reload nginx{RESET}")
+
+        # Verify the config file actually exists after writing
+        if not os.path.exists(nginx_path):
+            print(f"  {RED}✗{RESET} Nginx config file was not created at {nginx_path}")
     except PermissionError:
         print(f"  {YELLOW}!{RESET} No permission to write nginx config — run setup as root/sudo")